libuv：uv_tcp_connect返回的int是什么？

Question

Consider the documentation of uv_tcp_connect .
Here is the declaration of the function:

int uv_tcp_connect(uv_connect_t* req, uv_tcp_t* handle, const struct sockaddr* addr, uv_connect_cb cb);

It accepts a callback and returns an integer.
Usually, the other functions in libuv returns an error code (0 in case of no errors).
I guess also this one works the same way.

What is unclear to me (and undocumented as well) is: in case of a return value not equal to 0, will the callback be invoked anyway?
In other terms, does a return value different from 0 mean that the operation won't be performed at all or it is guaranteed that the callback is invoked?

Unfortunately, it seems that it is not documented what the return value actually is.

Answer 1

In case it returns non-zero result it will not call a callback.

You can check this thread for more details:

https://github.com/libuv/libuv/issues/391

Answer 2

See the error handling section in the documentation. An error (return < 0) means no operation will be performed and no callback will be called.

Answer 3

From reading the source :

• The return value is a (negative) error code, 0 means all went fine.
• The code with non-zero return paths don't reference the callback, so I don't think it will be invoked on error.