diff --git a/windows/GLib-2.0.gir b/windows/GLib-2.0.gir index e626b68..9e15f5f 100644 --- a/windows/GLib-2.0.gir +++ b/windows/GLib-2.0.gir @@ -22798,7 +22798,7 @@ linked against at application run time. - + The micro version number of the GLib library. diff --git a/windows/Gio-2.0.gir b/windows/Gio-2.0.gir index 0a404bd..79c288b 100644 --- a/windows/Gio-2.0.gir +++ b/windows/Gio-2.0.gir @@ -30943,7 +30943,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. glib:sync-func="read_line"> The asynchronous version of g_data_input_stream_read_line(). It is + line="1121">The asynchronous version of g_data_input_stream_read_line(). It is an error to have two outstanding calls to this function. When the operation is finished, @callback will be called. You @@ -30957,13 +30957,13 @@ the result of the operation. a given #GDataInputStream. + line="1123">a given #GDataInputStream. the [I/O priority](iface.AsyncResult.html#io-priority) of the request + line="1124">the [I/O priority](iface.AsyncResult.html#io-priority) of the request allow-none="1"> optional #GCancellable object, %NULL to ignore. + line="1125">optional #GCancellable object, %NULL to ignore. closure="3"> callback to call when the request is satisfied. + line="1126">callback to call when the request is satisfied. allow-none="1"> the data to pass to callback function. + line="1127">the data to pass to callback function. @@ -31003,7 +31003,7 @@ the result of the operation. throws="1"> Finish an asynchronous call started by + line="1197">Finish an asynchronous call started by g_data_input_stream_read_line_async(). Note the warning about string encoding in g_data_input_stream_read_line() applies here as well. @@ -31011,7 +31011,7 @@ well. + line="1209"> a NUL-terminated byte array with the line that was read in (without the newlines). Set @length to a #gsize to get the length of the read line. On an error, it will return %NULL and @error @@ -31025,13 +31025,13 @@ well. a given #GDataInputStream. + line="1199">a given #GDataInputStream. the #GAsyncResult that was provided to the callback. + line="1200">the #GAsyncResult that was provided to the callback. allow-none="1"> a #gsize to get the length of the data read in. + line="1201">a #gsize to get the length of the data read in. @@ -31053,13 +31053,13 @@ well. throws="1"> Finish an asynchronous call started by + line="1229">Finish an asynchronous call started by g_data_input_stream_read_line_async(). a string with the line that + line="1239">a string with the line that was read in (without the newlines). Set @length to a #gsize to get the length of the read line. On an error, it will return %NULL and @error will be set. For UTF-8 conversion errors, the set @@ -31071,13 +31071,13 @@ g_data_input_stream_read_line_async(). a given #GDataInputStream. + line="1231">a given #GDataInputStream. the #GAsyncResult that was provided to the callback. + line="1232">the #GAsyncResult that was provided to the callback. allow-none="1"> a #gsize to get the length of the data read in. + line="1233">a #gsize to get the length of the data read in. @@ -31267,7 +31267,7 @@ an error occurred. glib:async-func="read_until_async"> Reads a string from the data input stream, up to the first + line="892">Reads a string from the data input stream, up to the first occurrence of any of the stop characters. Note that, in contrast to g_data_input_stream_read_until_async(), @@ -31284,7 +31284,7 @@ does not consume the stop character. a string with the data that was read + line="912">a string with the data that was read before encountering any of the stop characters. Set @length to a #gsize to get the length of the string. This function will return %NULL on an error. @@ -31294,13 +31294,13 @@ does not consume the stop character. a given #GDataInputStream. + line="894">a given #GDataInputStream. characters to terminate the read. + line="895">characters to terminate the read. allow-none="1"> a #gsize to get the length of the data read in. + line="896">a #gsize to get the length of the data read in. allow-none="1"> optional #GCancellable object, %NULL to ignore. + line="897">optional #GCancellable object, %NULL to ignore. @@ -31334,7 +31334,7 @@ does not consume the stop character. glib:sync-func="read_until"> The asynchronous version of g_data_input_stream_read_until(). + line="1152">The asynchronous version of g_data_input_stream_read_until(). It is an error to have two outstanding calls to this function. Note that, in contrast to g_data_input_stream_read_until(), @@ -31359,19 +31359,19 @@ g_data_input_stream_read_upto_async() instead. a given #GDataInputStream. + line="1154">a given #GDataInputStream. characters to terminate the read. + line="1155">characters to terminate the read. the [I/O priority](iface.AsyncResult.html#io-priority) of the request + line="1156">the [I/O priority](iface.AsyncResult.html#io-priority) of the request allow-none="1"> optional #GCancellable object, %NULL to ignore. + line="1157">optional #GCancellable object, %NULL to ignore. closure="4"> callback to call when the request is satisfied. + line="1158">callback to call when the request is satisfied. allow-none="1"> the data to pass to callback function. + line="1159">the data to pass to callback function. @@ -31413,7 +31413,7 @@ g_data_input_stream_read_upto_async() instead. throws="1"> Finish an asynchronous call started by + line="1271">Finish an asynchronous call started by g_data_input_stream_read_until_async(). Use g_data_input_stream_read_upto_finish() instead, which has more consistent behaviour regarding the stop character. @@ -31421,7 +31421,7 @@ g_data_input_stream_read_until_async(). a string with the data that was read + line="1283">a string with the data that was read before encountering any of the stop characters. Set @length to a #gsize to get the length of the string. This function will return %NULL on an error. @@ -31431,13 +31431,13 @@ g_data_input_stream_read_until_async(). a given #GDataInputStream. + line="1273">a given #GDataInputStream. the #GAsyncResult that was provided to the callback. + line="1274">the #GAsyncResult that was provided to the callback. allow-none="1"> a #gsize to get the length of the data read in. + line="1275">a #gsize to get the length of the data read in. @@ -31460,7 +31460,7 @@ g_data_input_stream_read_until_async(). glib:async-func="read_upto_async"> Reads a string from the data input stream, up to the first + line="1301">Reads a string from the data input stream, up to the first occurrence of any of the stop characters. In contrast to g_data_input_stream_read_until(), this function @@ -31476,7 +31476,7 @@ The returned string will always be nul-terminated on success. a string with the data that was read + line="1324">a string with the data that was read before encountering any of the stop characters. Set @length to a #gsize to get the length of the string. This function will return %NULL on an error @@ -31486,19 +31486,19 @@ The returned string will always be nul-terminated on success. a #GDataInputStream + line="1303">a #GDataInputStream characters to terminate the read + line="1304">characters to terminate the read length of @stop_chars. May be -1 if @stop_chars is + line="1305">length of @stop_chars. May be -1 if @stop_chars is nul-terminated @@ -31510,7 +31510,7 @@ The returned string will always be nul-terminated on success. allow-none="1"> a #gsize to get the length of the data read in + line="1307">a #gsize to get the length of the data read in allow-none="1"> optional #GCancellable object, %NULL to ignore + line="1308">optional #GCancellable object, %NULL to ignore @@ -31531,7 +31531,7 @@ The returned string will always be nul-terminated on success. glib:sync-func="read_upto"> The asynchronous version of g_data_input_stream_read_upto(). + line="1398">The asynchronous version of g_data_input_stream_read_upto(). It is an error to have two outstanding calls to this function. In contrast to g_data_input_stream_read_until(), this function @@ -31553,26 +31553,26 @@ the result of the operation. a #GDataInputStream + line="1400">a #GDataInputStream characters to terminate the read + line="1401">characters to terminate the read length of @stop_chars. May be -1 if @stop_chars is + line="1402">length of @stop_chars. May be -1 if @stop_chars is nul-terminated the [I/O priority](iface.AsyncResult.html#io-priority) of the request + line="1404">the [I/O priority](iface.AsyncResult.html#io-priority) of the request allow-none="1"> optional #GCancellable object, %NULL to ignore + line="1405">optional #GCancellable object, %NULL to ignore closure="5"> callback to call when the request is satisfied + line="1406">callback to call when the request is satisfied allow-none="1"> the data to pass to callback function + line="1407">the data to pass to callback function @@ -31612,7 +31612,7 @@ the result of the operation. throws="1"> Finish an asynchronous call started by + line="1443">Finish an asynchronous call started by g_data_input_stream_read_upto_async(). Note that this function does not consume the stop character. You @@ -31624,7 +31624,7 @@ The returned string will always be nul-terminated on success. a string with the data that was read + line="1459">a string with the data that was read before encountering any of the stop characters. Set @length to a #gsize to get the length of the string. This function will return %NULL on an error. @@ -31634,13 +31634,13 @@ The returned string will always be nul-terminated on success. a #GDataInputStream + line="1445">a #GDataInputStream the #GAsyncResult that was provided to the callback + line="1446">the #GAsyncResult that was provided to the callback allow-none="1"> a #gsize to get the length of the data read in + line="1447">a #gsize to get the length of the data read in @@ -104652,7 +104652,7 @@ descriptor. Instead, a GError will be set with code %G_IO_ERROR_FAILED throws="1"> Accept incoming connections on a connection-based socket. This removes + line="2936">Accept incoming connections on a connection-based socket. This removes the first outstanding connection request from the listening socket and creates a #GSocket object for it. @@ -104666,7 +104666,7 @@ To be notified of an incoming connection, wait for the %G_IO_IN condition. a new #GSocket, or %NULL on error. + line="2953">a new #GSocket, or %NULL on error. Free the returned object with g_object_unref(). @@ -104674,7 +104674,7 @@ To be notified of an incoming connection, wait for the %G_IO_IN condition. a #GSocket. + line="2938">a #GSocket. allow-none="1"> a %GCancellable or %NULL + line="2939">a %GCancellable or %NULL @@ -104751,21 +104751,21 @@ UDP packets to an address with multiple listeners is not defined.) throws="1"> Checks and resets the pending connect error for the socket. + line="3174">Checks and resets the pending connect error for the socket. This is used to check for errors when g_socket_connect() is used in non-blocking mode. %TRUE if no error, %FALSE otherwise, setting @error to the error + line="3183">%TRUE if no error, %FALSE otherwise, setting @error to the error a #GSocket + line="3176">a #GSocket @@ -104776,7 +104776,7 @@ used in non-blocking mode. throws="1"> Closes the socket, shutting down any active connection. + line="3930">Closes the socket, shutting down any active connection. Closing a socket does not wait for all outstanding I/O operations to finish, so the caller should not rely on them to be guaranteed @@ -104809,14 +104809,14 @@ does.) %TRUE on success, %FALSE on error + line="3965">%TRUE on success, %FALSE on error a #GSocket + line="3932">a #GSocket @@ -104826,7 +104826,7 @@ does.) version="2.22"> Checks on the readiness of @socket to perform operations. + line="4472">Checks on the readiness of @socket to perform operations. The operations specified in @condition are checked for and masked against the currently-satisfied conditions on @socket. The result is returned. @@ -104847,20 +104847,20 @@ This call never blocks. the @GIOCondition mask of the current state + line="4495">the @GIOCondition mask of the current state a #GSocket + line="4474">a #GSocket a #GIOCondition mask to check + line="4475">a #GIOCondition mask to check @@ -104871,7 +104871,7 @@ This call never blocks. throws="1"> Waits for up to @timeout_us microseconds for @condition to become true + line="4570">Waits for up to @timeout_us microseconds for @condition to become true on @socket. If the condition is met, %TRUE is returned. If @cancellable is cancelled before the condition is met, or if @@ -104891,26 +104891,26 @@ exact number of milliseconds. %TRUE if the condition was met, %FALSE otherwise + line="4595">%TRUE if the condition was met, %FALSE otherwise a #GSocket + line="4572">a #GSocket a #GIOCondition mask to wait for + line="4573">a #GIOCondition mask to wait for the maximum time (in microseconds) to wait, or -1 + line="4574">the maximum time (in microseconds) to wait, or -1 allow-none="1"> a #GCancellable, or %NULL + line="4575">a #GCancellable, or %NULL @@ -104930,7 +104930,7 @@ exact number of milliseconds. throws="1"> Waits for @condition to become true on @socket. When the condition + line="4536">Waits for @condition to become true on @socket. When the condition is met, %TRUE is returned. If @cancellable is cancelled before the condition is met, or if the @@ -104944,20 +104944,20 @@ See also g_socket_condition_timed_wait(). %TRUE if the condition was met, %FALSE otherwise + line="4554">%TRUE if the condition was met, %FALSE otherwise a #GSocket + line="4538">a #GSocket a #GIOCondition mask to wait for + line="4539">a #GIOCondition mask to wait for allow-none="1"> a #GCancellable, or %NULL + line="4540">a #GCancellable, or %NULL @@ -104977,7 +104977,7 @@ See also g_socket_condition_timed_wait(). throws="1"> Connect the socket to the specified remote address. + line="3072">Connect the socket to the specified remote address. For connection oriented socket this generally means we attempt to make a connection to the @address. For a connection-less socket it sets @@ -104997,20 +104997,20 @@ checked with g_socket_check_connect_result(). %TRUE if connected, %FALSE on error. + line="3096">%TRUE if connected, %FALSE on error. a #GSocket. + line="3074">a #GSocket. a #GSocketAddress specifying the remote address. + line="3075">a #GSocketAddress specifying the remote address. allow-none="1"> a %GCancellable or %NULL + line="3076">a %GCancellable or %NULL @@ -105053,7 +105053,7 @@ checked with g_socket_check_connect_result(). introspectable="0"> Creates a #GSource that can be attached to a %GMainContext to monitor + line="4431">Creates a #GSource that can be attached to a %GMainContext to monitor for the availability of the specified @condition on the socket. The #GSource keeps a reference to the @socket. @@ -105077,20 +105077,20 @@ you call will then fail with a %G_IO_ERROR_TIMED_OUT. a newly allocated %GSource, free with g_source_unref(). + line="4458">a newly allocated %GSource, free with g_source_unref(). a #GSocket + line="4433">a #GSocket a #GIOCondition mask to monitor + line="4434">a #GIOCondition mask to monitor allow-none="1"> a %GCancellable or %NULL + line="4435">a %GCancellable or %NULL @@ -105109,7 +105109,7 @@ you call will then fail with a %G_IO_ERROR_TIMED_OUT. version="2.32"> Get the amount of data pending in the OS input buffer, without blocking. + line="3225">Get the amount of data pending in the OS input buffer, without blocking. If @socket is a UDP or SCTP socket, this will return the size of just the next packet, even if additional packets are buffered after @@ -105125,7 +105125,7 @@ exactly the right size. the number of bytes that can be read from the socket + line="3242">the number of bytes that can be read from the socket without blocking or truncating, or -1 on error. @@ -105133,7 +105133,7 @@ without blocking or truncating, or -1 on error. a #GSocket + line="3227">a #GSocket @@ -105193,7 +105193,7 @@ addresses. throws="1"> Returns the credentials of the foreign process connected to this + line="6260">Returns the credentials of the foreign process connected to this socket, if any (e.g. it is only supported for %G_SOCKET_FAMILY_UNIX sockets). @@ -105217,7 +105217,7 @@ g_unix_connection_receive_credentials() functions. %NULL if @error is set, otherwise a #GCredentials object + line="6286">%NULL if @error is set, otherwise a #GCredentials object that must be freed with g_object_unref(). @@ -105225,7 +105225,7 @@ that must be freed with g_object_unref(). a #GSocket. + line="6262">a #GSocket. @@ -105410,7 +105410,7 @@ g_socket_set_multicast_ttl() for more details. throws="1"> Gets the value of an integer-valued option on @socket, as with + line="6454">Gets the value of an integer-valued option on @socket, as with getsockopt(). (If you need to fetch a non-integer-valued option, you will need to call getsockopt() directly.) @@ -105427,7 +105427,7 @@ g_socket_get_option() will handle the conversion internally. success or failure. On failure, @error will be set, and + line="6476">success or failure. On failure, @error will be set, and the system error value (`errno` or WSAGetLastError()) will still be set to the result of the getsockopt() call. @@ -105436,19 +105436,19 @@ g_socket_get_option() will handle the conversion internally. a #GSocket + line="6456">a #GSocket the "API level" of the option (eg, `SOL_SOCKET`) + line="6457">the "API level" of the option (eg, `SOL_SOCKET`) the "name" of the option (eg, `SO_BROADCAST`) + line="6458">the "name" of the option (eg, `SO_BROADCAST`) transfer-ownership="full"> return location for the option value + line="6459">return location for the option value @@ -105587,19 +105587,19 @@ g_socket_set_ttl() for more details. version="2.22"> Checks whether a socket is closed. + line="4019">Checks whether a socket is closed. %TRUE if socket is closed, %FALSE otherwise + line="4025">%TRUE if socket is closed, %FALSE otherwise a #GSocket + line="4021">a #GSocket @@ -105638,7 +105638,7 @@ g_socket_check_connect_result(). throws="1"> Registers @socket to receive multicast messages sent to @group. + line="2561">Registers @socket to receive multicast messages sent to @group. @socket must be a %G_SOCKET_TYPE_DATAGRAM socket, and must have been bound to an appropriate interface and port with g_socket_bind(). @@ -105656,26 +105656,26 @@ g_socket_join_multicast_group_ssm() instead. %TRUE on success, %FALSE on error. + line="2584">%TRUE on success, %FALSE on error. a #GSocket. + line="2563">a #GSocket. a #GInetAddress specifying the group address to join. + line="2564">a #GInetAddress specifying the group address to join. %TRUE if source-specific multicast should be used + line="2566">%TRUE if source-specific multicast should be used allow-none="1"> Name of the interface to use, or %NULL + line="2565">Name of the interface to use, or %NULL @@ -105695,7 +105695,7 @@ g_socket_join_multicast_group_ssm() instead. throws="1"> Registers @socket to receive multicast messages sent to @group. + line="2818">Registers @socket to receive multicast messages sent to @group. @socket must be a %G_SOCKET_TYPE_DATAGRAM socket, and must have been bound to an appropriate interface and port with g_socket_bind(). @@ -105714,20 +105714,20 @@ packets from more than one source. %TRUE on success, %FALSE on error. + line="2843">%TRUE on success, %FALSE on error. a #GSocket. + line="2820">a #GSocket. a #GInetAddress specifying the group address to join. + line="2821">a #GInetAddress specifying the group address to join. allow-none="1"> a #GInetAddress specifying the + line="2822">a #GInetAddress specifying the source-specific multicast address or %NULL to ignore. @@ -105746,7 +105746,7 @@ source-specific multicast address or %NULL to ignore. allow-none="1"> Name of the interface to use, or %NULL + line="2824">Name of the interface to use, or %NULL @@ -105757,7 +105757,7 @@ source-specific multicast address or %NULL to ignore. throws="1"> Removes @socket from the multicast group defined by @group, @iface, + line="2598">Removes @socket from the multicast group defined by @group, @iface, and @source_specific (which must all have the same values they had when you joined the group). @@ -105770,26 +105770,26 @@ g_socket_leave_multicast_group_ssm() instead. %TRUE on success, %FALSE on error. + line="2616">%TRUE on success, %FALSE on error. a #GSocket. + line="2600">a #GSocket. a #GInetAddress specifying the group address to leave. + line="2601">a #GInetAddress specifying the group address to leave. %TRUE if source-specific multicast was used + line="2603">%TRUE if source-specific multicast was used allow-none="1"> Interface used + line="2602">Interface used @@ -105809,7 +105809,7 @@ g_socket_leave_multicast_group_ssm() instead. throws="1"> Removes @socket from the multicast group defined by @group, @iface, + line="2858">Removes @socket from the multicast group defined by @group, @iface, and @source_specific (which must all have the same values they had when you joined the group). @@ -105819,20 +105819,20 @@ unicast messages after calling this. %TRUE on success, %FALSE on error. + line="2874">%TRUE on success, %FALSE on error. a #GSocket. + line="2860">a #GSocket. a #GInetAddress specifying the group address to leave. + line="2861">a #GInetAddress specifying the group address to leave. allow-none="1"> a #GInetAddress specifying the + line="2862">a #GInetAddress specifying the source-specific multicast address or %NULL to ignore. @@ -105851,7 +105851,7 @@ source-specific multicast address or %NULL to ignore. allow-none="1"> Name of the interface to use, or %NULL + line="2864">Name of the interface to use, or %NULL @@ -105892,7 +105892,7 @@ g_socket_set_listen_backlog(). throws="1"> Receive data (up to @size bytes) from a socket. This is mainly used by + line="3467">Receive data (up to @size bytes) from a socket. This is mainly used by connection-oriented sockets; it is identical to g_socket_receive_from() with @address set to %NULL. @@ -105919,7 +105919,7 @@ On error -1 is returned and @error is set accordingly. Number of bytes read, or 0 if the connection was closed by + line="3500">Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -105927,7 +105927,7 @@ the peer, or -1 on error a #GSocket + line="3469">a #GSocket transfer-ownership="none"> + line="3470"> a buffer to read data into (which should be at least @size bytes long). @@ -105945,7 +105945,7 @@ the peer, or -1 on error the number of bytes you want to read from the socket + line="3472">the number of bytes you want to read from the socket allow-none="1"> a %GCancellable or %NULL + line="3473">a %GCancellable or %NULL @@ -105965,7 +105965,7 @@ the peer, or -1 on error throws="1"> Receives data (up to @size bytes) from a socket. + line="3404">Receives data (up to @size bytes) from a socket. This function is a variant of [method@Gio.Socket.receive] which returns a [struct@GLib.Bytes] rather than a plain buffer. @@ -105978,7 +105978,7 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. a bytes buffer containing the + line="3423">a bytes buffer containing the received bytes, or `NULL` on error @@ -105986,19 +105986,19 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. a #GSocket + line="3406">a #GSocket the number of bytes you want to read from the socket + line="3407">the number of bytes you want to read from the socket the timeout to wait for, in microseconds, or `-1` to block + line="3408">the timeout to wait for, in microseconds, or `-1` to block indefinitely @@ -106008,7 +106008,7 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. a %GCancellable, or `NULL` + line="3410">a %GCancellable, or `NULL` @@ -106019,7 +106019,7 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. Receive data (up to @size bytes) from a socket. + line="3548">Receive data (up to @size bytes) from a socket. This function is a variant of [method@Gio.Socket.receive_from] which returns a [struct@GLib.Bytes] rather than a plain buffer. @@ -106037,7 +106037,7 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. a bytes buffer containing the + line="3573">a bytes buffer containing the received bytes, or `NULL` on error @@ -106045,7 +106045,7 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. a #GSocket + line="3550">a #GSocket return location for a #GSocketAddress + line="3551">return location for a #GSocketAddress the number of bytes you want to read from the socket + line="3552">the number of bytes you want to read from the socket the timeout to wait for, in microseconds, or `-1` to block + line="3553">the timeout to wait for, in microseconds, or `-1` to block indefinitely @@ -106078,7 +106078,7 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. a #GCancellable, or `NULL` + line="3555">a #GCancellable, or `NULL` @@ -106089,7 +106089,7 @@ for that many microseconds for data before returning `G_IO_ERROR_TIMED_OUT`. Receive data (up to @size bytes) from a socket. + line="3627">Receive data (up to @size bytes) from a socket. If @address is non-%NULL then @address will be set equal to the source address of the received packet. @@ -106100,7 +106100,7 @@ See g_socket_receive() for additional information. Number of bytes read, or 0 if the connection was closed by + line="3646">Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -106108,7 +106108,7 @@ the peer, or -1 on error a #GSocket + line="3629">a #GSocket allow-none="1"> a pointer to a #GSocketAddress + line="3630">a pointer to a #GSocketAddress pointer, or %NULL @@ -106129,7 +106129,7 @@ the peer, or -1 on error transfer-ownership="none"> + line="3632"> a buffer to read data into (which should be at least @size bytes long). @@ -106138,7 +106138,7 @@ the peer, or -1 on error the number of bytes you want to read from the socket + line="3634">the number of bytes you want to read from the socket allow-none="1"> a %GCancellable or %NULL + line="3635">a %GCancellable or %NULL @@ -106158,7 +106158,7 @@ the peer, or -1 on error throws="1"> Receive data from a socket. For receiving multiple messages, see + line="6160">Receive data from a socket. For receiving multiple messages, see g_socket_receive_messages(); for easier use, see g_socket_receive() and g_socket_receive_from(). @@ -106221,7 +106221,7 @@ On error -1 is returned and @error is set accordingly. Number of bytes read, or 0 if the connection was closed by + line="6237">Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -106229,7 +106229,7 @@ the peer, or -1 on error a #GSocket + line="6162">a #GSocket allow-none="1"> a pointer to a #GSocketAddress + line="6163">a pointer to a #GSocketAddress pointer, or %NULL an array of #GInputVector structs + line="6165">an array of #GInputVector structs @@ -106255,7 +106255,7 @@ the peer, or -1 on error the number of elements in @vectors, or -1 + line="6166">the number of elements in @vectors, or -1 allow-none="1"> a pointer + line="6167">a pointer which may be filled with an array of #GSocketControlMessages, or %NULL transfer-ownership="full"> a pointer which will be filled with the number of + line="6169">a pointer which will be filled with the number of elements in @messages, or %NULL @@ -106292,7 +106292,7 @@ the peer, or -1 on error transfer-ownership="full"> a pointer to an int containing #GSocketMsgFlags flags, + line="6171">a pointer to an int containing #GSocketMsgFlags flags, which may additionally contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html) @@ -106303,7 +106303,7 @@ the peer, or -1 on error allow-none="1"> a %GCancellable or %NULL + line="6174">a %GCancellable or %NULL @@ -106314,7 +106314,7 @@ the peer, or -1 on error throws="1"> Receive multiple data messages from @socket in one go. This is the most + line="5881">Receive multiple data messages from @socket in one go. This is the most complicated and fully-featured version of this call. For easier use, see g_socket_receive(), g_socket_receive_from(), and g_socket_receive_message(). @@ -106366,7 +106366,7 @@ messages successfully received before the error will be returned. number of messages received, or -1 on error. Note that the number + line="5941">number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if in non-blocking mode, if the peer closed the connection, or if @num_messages was larger than `UIO_MAXIOV` (1024), in which case the caller may re-try @@ -106377,13 +106377,13 @@ messages successfully received before the error will be returned. a #GSocket + line="5883">a #GSocket an array of #GInputMessage structs + line="5884">an array of #GInputMessage structs @@ -106391,13 +106391,13 @@ messages successfully received before the error will be returned. the number of elements in @messages + line="5885">the number of elements in @messages an int containing #GSocketMsgFlags flags for the overall operation, + line="5886">an int containing #GSocketMsgFlags flags for the overall operation, which may additionally contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html) @@ -106408,7 +106408,7 @@ messages successfully received before the error will be returned. allow-none="1"> a %GCancellable or %NULL + line="5889">a %GCancellable or %NULL @@ -106419,14 +106419,14 @@ messages successfully received before the error will be returned. throws="1"> This behaves exactly the same as g_socket_receive(), except that + line="3517">This behaves exactly the same as g_socket_receive(), except that the choice of blocking or non-blocking behavior is determined by the @blocking argument rather than by @socket's properties. Number of bytes read, or 0 if the connection was closed by + line="3531">Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -106434,7 +106434,7 @@ the peer, or -1 on error a #GSocket + line="3519">a #GSocket transfer-ownership="none"> + line="3520"> a buffer to read data into (which should be at least @size bytes long). @@ -106452,13 +106452,13 @@ the peer, or -1 on error the number of bytes you want to read from the socket + line="3522">the number of bytes you want to read from the socket whether to do blocking or non-blocking I/O + line="3523">whether to do blocking or non-blocking I/O allow-none="1"> a %GCancellable or %NULL + line="3524">a %GCancellable or %NULL @@ -106478,7 +106478,7 @@ the peer, or -1 on error throws="1"> Tries to send @size bytes from @buffer on the socket. This is + line="3740">Tries to send @size bytes from @buffer on the socket. This is mainly used by connection-oriented sockets; it is identical to g_socket_send_to() with @address set to %NULL. @@ -106496,7 +106496,7 @@ On error -1 is returned and @error is set accordingly. Number of bytes written (which may be less than @size), or -1 + line="3764">Number of bytes written (which may be less than @size), or -1 on error @@ -106504,13 +106504,13 @@ on error a #GSocket + line="3742">a #GSocket the buffer + line="3743">the buffer containing the data to send. @@ -106519,7 +106519,7 @@ on error the number of bytes to send + line="3745">the number of bytes to send allow-none="1"> a %GCancellable or %NULL + line="3746">a %GCancellable or %NULL @@ -106539,7 +106539,7 @@ on error throws="1"> Send data to @address on @socket. For sending multiple messages see + line="4998">Send data to @address on @socket. For sending multiple messages see g_socket_send_messages(); for easier use, see g_socket_send() and g_socket_send_to(). @@ -106585,7 +106585,7 @@ On error -1 is returned and @error is set accordingly. Number of bytes written (which may be less than @size), or -1 + line="5055">Number of bytes written (which may be less than @size), or -1 on error @@ -106593,7 +106593,7 @@ on error a #GSocket + line="5000">a #GSocket allow-none="1"> a #GSocketAddress, or %NULL + line="5001">a #GSocketAddress, or %NULL an array of #GOutputVector structs + line="5002">an array of #GOutputVector structs @@ -106616,7 +106616,7 @@ on error the number of elements in @vectors, or -1 + line="5003">the number of elements in @vectors, or -1 allow-none="1"> a pointer to an + line="5004">a pointer to an array of #GSocketControlMessages, or %NULL. number of elements in @messages, or -1. + line="5006">number of elements in @messages, or -1. an int containing #GSocketMsgFlags flags, which may additionally + line="5007">an int containing #GSocketMsgFlags flags, which may additionally contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html) @@ -106653,7 +106653,7 @@ on error allow-none="1"> a %GCancellable or %NULL + line="5009">a %GCancellable or %NULL @@ -106664,7 +106664,7 @@ on error throws="1"> This behaves exactly the same as g_socket_send_message(), except that + line="5138">This behaves exactly the same as g_socket_send_message(), except that the choice of timeout behavior is determined by the @timeout_us argument rather than by @socket's properties. @@ -106675,7 +106675,7 @@ returned. @bytes_written will contain 0 in both cases. %G_POLLABLE_RETURN_OK if all data was successfully written, + line="5162">%G_POLLABLE_RETURN_OK if all data was successfully written, %G_POLLABLE_RETURN_WOULD_BLOCK if the socket is currently not writable, or %G_POLLABLE_RETURN_FAILED if an error happened and @error is set. @@ -106684,7 +106684,7 @@ returned. @bytes_written will contain 0 in both cases. a #GSocket + line="5140">a #GSocket allow-none="1"> a #GSocketAddress, or %NULL + line="5141">a #GSocketAddress, or %NULL an array of #GOutputVector structs + line="5142">an array of #GOutputVector structs @@ -106709,7 +106709,7 @@ returned. @bytes_written will contain 0 in both cases. the number of elements in @vectors, or -1 + line="5143">the number of elements in @vectors, or -1 allow-none="1"> a pointer to an + line="5144">a pointer to an array of #GSocketControlMessages, or %NULL. number of elements in @messages, or -1. + line="5146">number of elements in @messages, or -1. an int containing #GSocketMsgFlags flags, which may additionally + line="5147">an int containing #GSocketMsgFlags flags, which may additionally contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html) the maximum time (in microseconds) to wait, or -1 + line="5149">the maximum time (in microseconds) to wait, or -1 allow-none="1"> location to store the number of bytes that were written to the socket + line="5150">location to store the number of bytes that were written to the socket allow-none="1"> a %GCancellable or %NULL + line="5151">a %GCancellable or %NULL @@ -106774,7 +106774,7 @@ returned. @bytes_written will contain 0 in both cases. throws="1"> Send multiple data messages from @socket in one go. This is the most + line="5376">Send multiple data messages from @socket in one go. This is the most complicated and fully-featured version of this call. For easier use, see g_socket_send(), g_socket_send_to(), and g_socket_send_message(). @@ -106812,7 +106812,7 @@ successfully sent before the error will be returned. number of messages sent, or -1 on error. Note that the number of + line="5421">number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if the socket is non-blocking or if @num_messages was larger than UIO_MAXIOV (1024), in which case the caller may re-try to send the remaining messages. @@ -106822,13 +106822,13 @@ successfully sent before the error will be returned. a #GSocket + line="5378">a #GSocket an array of #GOutputMessage structs + line="5379">an array of #GOutputMessage structs @@ -106836,13 +106836,13 @@ successfully sent before the error will be returned. the number of elements in @messages + line="5380">the number of elements in @messages an int containing #GSocketMsgFlags flags, which may additionally + line="5381">an int containing #GSocketMsgFlags flags, which may additionally contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html) @@ -106852,7 +106852,7 @@ successfully sent before the error will be returned. allow-none="1"> a %GCancellable or %NULL + line="5383">a %GCancellable or %NULL @@ -106863,7 +106863,7 @@ successfully sent before the error will be returned. throws="1"> Tries to send @size bytes from @buffer to @address. If @address is + line="3812">Tries to send @size bytes from @buffer to @address. If @address is %NULL then the message is sent to the default receiver (set by g_socket_connect()). @@ -106872,7 +106872,7 @@ See g_socket_send() for additional information. Number of bytes written (which may be less than @size), or -1 + line="3828">Number of bytes written (which may be less than @size), or -1 on error @@ -106880,7 +106880,7 @@ on error a #GSocket + line="3814">a #GSocket allow-none="1"> a #GSocketAddress, or %NULL + line="3815">a #GSocketAddress, or %NULL the buffer + line="3816">the buffer containing the data to send. @@ -106904,7 +106904,7 @@ on error the number of bytes to send + line="3818">the number of bytes to send allow-none="1"> a %GCancellable or %NULL + line="3819">a %GCancellable or %NULL @@ -106924,14 +106924,14 @@ on error throws="1"> This behaves exactly the same as g_socket_send(), except that + line="3781">This behaves exactly the same as g_socket_send(), except that the choice of blocking or non-blocking behavior is determined by the @blocking argument rather than by @socket's properties. Number of bytes written (which may be less than @size), or -1 + line="3795">Number of bytes written (which may be less than @size), or -1 on error @@ -106939,13 +106939,13 @@ on error a #GSocket + line="3783">a #GSocket the buffer + line="3784">the buffer containing the data to send. @@ -106954,13 +106954,13 @@ on error the number of bytes to send + line="3786">the number of bytes to send whether to do blocking or non-blocking I/O + line="3787">whether to do blocking or non-blocking I/O allow-none="1"> a %GCancellable or %NULL + line="3788">a %GCancellable or %NULL @@ -107171,7 +107171,7 @@ the local network. throws="1"> Sets the value of an integer-valued option on @socket, as with + line="6526">Sets the value of an integer-valued option on @socket, as with setsockopt(). (If you need to set a non-integer-valued option, you will need to call setsockopt() directly.) @@ -107184,7 +107184,7 @@ headers. success or failure. On failure, @error will be set, and + line="6544">success or failure. On failure, @error will be set, and the system error value (`errno` or WSAGetLastError()) will still be set to the result of the setsockopt() call. @@ -107193,25 +107193,25 @@ headers. a #GSocket + line="6528">a #GSocket the "API level" of the option (eg, `SOL_SOCKET`) + line="6529">the "API level" of the option (eg, `SOL_SOCKET`) the "name" of the option (eg, `SO_BROADCAST`) + line="6530">the "name" of the option (eg, `SO_BROADCAST`) the value to set the option to + line="6531">the value to set the option to @@ -107294,7 +107294,7 @@ By default the platform-specific default value is used. throws="1"> Shut down part or all of a full-duplex connection. + line="3855">Shut down part or all of a full-duplex connection. If @shutdown_read is %TRUE then the receiving side of the connection is shut down, and further reading is disallowed. @@ -107312,26 +107312,26 @@ other side saw all sent data. %TRUE on success, %FALSE on error + line="3877">%TRUE on success, %FALSE on error a #GSocket + line="3857">a #GSocket whether to shut down the read side + line="3858">whether to shut down the read side whether to shut down the write side + line="3859">whether to shut down the write side @@ -107341,7 +107341,7 @@ other side saw all sent data. version="2.22"> Checks if a socket is capable of speaking IPv4. + line="2889">Checks if a socket is capable of speaking IPv4. IPv4 sockets are capable of speaking IPv4. On some operating systems and under some combinations of circumstances IPv6 sockets are also @@ -107354,14 +107354,14 @@ of speaking IPv4. %TRUE if this socket can be used with IPv4. + line="2903">%TRUE if this socket can be used with IPv4. a #GSocket + line="2891">a #GSocket