[glibmm] Regenerate *_docs.xml files.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] Regenerate *_docs.xml files.
- Date: Mon, 23 Nov 2015 09:15:39 +0000 (UTC)
commit 0d13b4b18bd0aa607e7a8a244f6cea2415cd9f47
Author: Murray Cumming <murrayc murrayc com>
Date: Fri Nov 20 12:28:38 2015 +0100
Regenerate *_docs.xml files.
gio/src/gio_docs.xml | 634 ++++++++++++++++++++++++++++++++++++++----
glib/src/glib_docs.xml | 716 ++++++++++++++++++++++++++++++++++++++----------
2 files changed, 1152 insertions(+), 198 deletions(-)
---
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index c92519c..b2d1324 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -2113,9 +2113,9 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START">
-<parameter_description> If not set and the proxy if for a well-known name,
-then request the bus to launch an owner for the name if no-one owns the name. This flag can
-only be used in proxies for well-known names.
+<parameter_description> If the proxy is for a well-known name,
+do not ask the bus to launch an owner during proxy initialization or a method call.
+This flag is only meaningful in proxies for well-known names.
</parameter_description>
</parameter>
<parameter name="G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES">
@@ -2126,7 +2126,7 @@ only be used in proxies for well-known names.
<parameter_description> If the proxy is for a well-known name,
do not ask the bus to launch an owner during proxy initialization, but allow it to be
autostarted by a method call. This flag is only meaningful in proxies for well-known names,
-and only if %G_DBUS_PROXY_FLAGS_DO_NOT_AUTOSTART is not also specified.
+and only if %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is not also specified.
</parameter_description>
</parameter>
</parameters>
@@ -3212,6 +3212,10 @@ value, which has this more logical name. Since 2.44.
<parameter_description> Transport endpoint is not connected. Since 2.44
</parameter_description>
</parameter>
+<parameter name="G_IO_ERROR_MESSAGE_TOO_LARGE">
+<parameter_description> Message too large. Since 2.48.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -5670,7 +5674,7 @@ Since: 2.28
<property name="GTlsConnection:database">
<description>
The certificate database to use when verifying this TLS connection.
-If no cerificate database is set, then the default database will be
+If no certificate database is set, then the default database will be
used. See g_tls_backend_get_default_database().
Since: 2.30
@@ -11851,7 +11855,8 @@ containing the data to convert.
</parameter_description>
</parameter>
<parameter name="outbuf">
-<parameter_description> a buffer to write converted data in.
+<parameter_description> a buffer to write
+converted data in.
</parameter_description>
</parameter>
<parameter name="outbuf_size">
@@ -13220,6 +13225,324 @@ Sets the byte order of the data output stream to @order.
<return></return>
</function>
+<function name="g_datagram_based_condition_check">
+<description>
+Checks on the readiness of @datagram_based to perform operations. The
+operations specified in @condition are checked for and masked against the
+currently-satisfied conditions on @datagram_based. The result is returned.
+
+%G_IO_IN will be set in the return value if data is available to read with
+g_datagram_based_receive_messages(), or if the connection is closed remotely
+(EOS); and if the datagram_based has not been closed locally using some
+implementation-specific method (such as g_socket_close() or
+g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket).
+
+If the connection is shut down or closed (by calling g_socket_close() or
+g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket, for
+example), all calls to this function will return %G_IO_ERROR_CLOSED.
+
+%G_IO_OUT will be set if it is expected that at least one byte can be sent
+using g_datagram_based_send_messages() without blocking. It will not be set
+if the datagram_based has been closed locally.
+
+%G_IO_HUP will be set if the connection has been closed locally.
+
+%G_IO_ERR will be set if there was an asynchronous error in transmitting data
+previously enqueued using g_datagram_based_send_messages().
+
+Note that on Windows, it is possible for an operation to return
+%G_IO_ERROR_WOULD_BLOCK even immediately after
+g_datagram_based_condition_check() has claimed that the #GDatagramBased is
+ready for writing. Rather than calling g_datagram_based_condition_check() and
+then writing to the #GDatagramBased if it succeeds, it is generally better to
+simply try writing right away, and try again later if the initial attempt
+returns %G_IO_ERROR_WOULD_BLOCK.
+
+It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition; these
+conditions will always be set in the output if they are true. Apart from
+these flags, the output is guaranteed to be masked by @condition.
+
+This call never blocks.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="datagram_based">
+<parameter_description> a #GDatagramBased
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> a #GIOCondition mask to check
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GIOCondition mask of the current state
+
+</return>
+</function>
+
+<function name="g_datagram_based_condition_wait">
+<description>
+Waits for up to @timeout microseconds for condition to become true on
+ datagram_based If the condition is met, %TRUE is returned.
+
+If @cancellable is cancelled before the condition is met, or if @timeout is
+reached before the condition is met, then %FALSE is returned and @error is
+set appropriately (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT).
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="datagram_based">
+<parameter_description> a #GDatagramBased
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> a #GIOCondition mask to wait for
+</parameter_description>
+</parameter>
+<parameter name="timeout">
+<parameter_description> the maximum time (in microseconds) to wait, 0 to not block, or -1
+to block indefinitely
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the condition was met, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="g_datagram_based_create_source">
+<description>
+Creates a #GSource that can be attached to a #GMainContext to monitor for
+the availability of the specified @condition on the #GDatagramBased. The
+#GSource keeps a reference to the @datagram_based.
+
+The callback on the source is of the #GDatagramBasedSourceFunc type.
+
+It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition; these
+conditions will always be reported in the callback if they are true.
+
+If non-%NULL, @cancellable can be used to cancel the source, which will
+cause the source to trigger, reporting the current condition (which is
+likely 0 unless cancellation happened at the same time as a condition
+change). You can check for this in the callback using
+g_cancellable_is_cancelled().
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="datagram_based">
+<parameter_description> a #GDatagramBased
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> a #GIOCondition mask to monitor
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated #GSource
+
+</return>
+</function>
+
+<function name="g_datagram_based_receive_messages">
+<description>
+Receive one or more data messages from @datagram_based in one go.
+
+ messages must point to an array of #GInputMessage structs and
+ num_messages must be the length of this array. Each #GInputMessage
+contains a pointer to an array of #GInputVector structs describing the
+buffers that the data received in each message will be written to.
+
+ flags modify how all messages are received. The commonly available
+arguments for this are available in the #GSocketMsgFlags enum, but the
+values there are the same as the system values, and the flags
+are passed in as-is, so you can pass in system-specific flags too. These
+flags affect the overall receive operation. Flags affecting individual
+messages are returned in #GInputMessage.flags.
+
+The other members of #GInputMessage are treated as described in its
+documentation.
+
+If @timeout is negative the call will block until @num_messages have been
+received, the connection is closed remotely (EOS), @cancellable is cancelled,
+or an error occurs.
+
+If @timeout is 0 the call will return up to @num_messages without blocking,
+or %G_IO_ERROR_WOULD_BLOCK if no messages are queued in the operating system
+to be received.
+
+If @timeout is positive the call will block on the same conditions as if
+ timeout were negative. If the timeout is reached
+before any messages are received, %G_IO_ERROR_TIMED_OUT is returned,
+otherwise it will return the number of messages received before timing out.
+(Note: This is effectively the behaviour of `MSG_WAITFORONE` with
+recvmmsg().)
+
+To be notified when messages are available, wait for the %G_IO_IN condition.
+Note though that you may still receive %G_IO_ERROR_WOULD_BLOCK from
+g_datagram_based_receive_messages() even if you were previously notified of a
+%G_IO_IN condition.
+
+If the remote peer closes the connection, any messages queued in the
+underlying receive buffer will be returned, and subsequent calls to
+g_datagram_based_receive_messages() will return 0 (with no error set).
+
+If the connection is shut down or closed (by calling g_socket_close() or
+g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket, for
+example), all calls to this function will return %G_IO_ERROR_CLOSED.
+
+On error -1 is returned and @error is set accordingly. An error will only
+be returned if zero messages could be received; otherwise the number of
+messages successfully received before the error will be returned. If
+ cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any
+other error.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="datagram_based">
+<parameter_description> a #GDatagramBased
+</parameter_description>
+</parameter>
+<parameter name="messages">
+<parameter_description> an array of #GInputMessage structs
+</parameter_description>
+</parameter>
+<parameter name="num_messages">
+<parameter_description> the number of elements in @messages
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> an int containing #GSocketMsgFlags flags for the overall operation
+</parameter_description>
+</parameter>
+<parameter name="timeout">
+<parameter_description> the maximum time (in microseconds) to wait, 0 to not block, or -1
+to block indefinitely
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> number of messages received, or -1 on error. Note that the number
+of messages received may be smaller than @num_messages if @timeout is
+zero or positive, if the peer closed the connection, or if @num_messages
+was larger than `UIO_MAXIOV` (1024), in which case the caller may re-try
+to receive the remaining messages.
+
+</return>
+</function>
+
+<function name="g_datagram_based_send_messages">
+<description>
+Send one or more data messages from @datagram_based in one go.
+
+ messages must point to an array of #GOutputMessage structs and
+ num_messages must be the length of this array. Each #GOutputMessage
+contains an address to send the data to, and a pointer to an array of
+#GOutputVector structs to describe the buffers that the data to be sent
+for each message will be gathered from.
+
+ flags modify how the message is sent. The commonly available arguments
+for this are available in the #GSocketMsgFlags enum, but the
+values there are the same as the system values, and the flags
+are passed in as-is, so you can pass in system-specific flags too.
+
+The other members of #GOutputMessage are treated as described in its
+documentation.
+
+If @timeout is negative the call will block until @num_messages have been
+sent, @cancellable is cancelled, or an error occurs.
+
+If @timeout is 0 the call will send up to @num_messages without blocking,
+or will return %G_IO_ERROR_WOULD_BLOCK if there is no space to send messages.
+
+If @timeout is positive the call will block on the same conditions as if
+ timeout were negative. If the timeout is reached before any messages are
+sent, %G_IO_ERROR_TIMED_OUT is returned, otherwise it will return the number
+of messages sent before timing out.
+
+To be notified when messages can be sent, wait for the %G_IO_OUT condition.
+Note though that you may still receive %G_IO_ERROR_WOULD_BLOCK from
+g_datagram_based_send_messages() even if you were previously notified of a
+%G_IO_OUT condition. (On Windows in particular, this is very common due to
+the way the underlying APIs work.)
+
+If the connection is shut down or closed (by calling g_socket_close() or
+g_socket_shutdown() with @shutdown_write set, if it’s a #GSocket, for
+example), all calls to this function will return %G_IO_ERROR_CLOSED.
+
+On error -1 is returned and @error is set accordingly. An error will only
+be returned if zero messages could be sent; otherwise the number of messages
+successfully sent before the error will be returned. If @cancellable is
+cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="datagram_based">
+<parameter_description> a #GDatagramBased
+</parameter_description>
+</parameter>
+<parameter name="messages">
+<parameter_description> an array of #GOutputMessage structs
+</parameter_description>
+</parameter>
+<parameter name="num_messages">
+<parameter_description> the number of elements in @messages
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> an int containing #GSocketMsgFlags flags
+</parameter_description>
+</parameter>
+<parameter name="timeout">
+<parameter_description> the maximum time (in microseconds) to wait, 0 to not block, or -1
+to block indefinitely
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> number of messages sent, or -1 on error. Note that the number of
+messages sent may be smaller than @num_messages if @timeout is zero
+or positive, or if @num_messages was larger than `UIO_MAXIOV` (1024), in
+which case the caller may re-try to send the remaining messages.
+
+</return>
+</function>
+
<function name="g_dbus_action_group_get">
<description>
Obtains a #GDBusActionGroup for the action group which is exported at
@@ -13594,6 +13917,13 @@ g_dbus_connection_send_message_with_reply() relies on) will see the
message. Similary, if a filter consumes an outgoing message, the
message will not be sent to the other peer.
+If @user_data_free_func is non-%NULL, it will be called (in the
+thread-default main context of the thread you are calling this
+method from) at some point after @user_data is no longer
+needed. (It is not guaranteed to be called synchronously when the
+filter is removed, and may be called after @connection has been
+destroyed.)
+
Since: 2.26
</description>
@@ -14476,8 +14806,8 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> a #GCredentials or %NULL if not available.
-Do not free this object, it is owned by @connection.
+<return> a #GCredentials or %NULL if not
+available. Do not free this object, it is owned by @connection.
</return>
</function>
@@ -15012,6 +15342,13 @@ that can be used with g_dbus_connection_unregister_subtree() .
<description>
Removes a filter.
+Note that since filters run in a different thread, there is a race
+condition where it is possible that the filter will be running even
+after calling g_dbus_connection_remove_filter(), so you cannot just
+free data that the filter might be using. Instead, you should pass
+a #GDestroyNotify to g_dbus_connection_add_filter(), which will be
+called when it is guaranteed that the data is no longer needed.
+
Since: 2.26
</description>
@@ -15315,6 +15652,13 @@ If one of %G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE or
interpreted as part of a namespace or path. The first argument
of a signal is matched against that part as specified by D-Bus.
+If @user_data_free_func is non-%NULL, it will be called (in the
+thread-default main context of the thread you are calling this
+method from) at some point after @user_data is no longer
+needed. (It is not guaranteed to be called synchronously when the
+signal is unsubscribed from, and may be called after @connection
+has been destroyed.)
+
Since: 2.26
</description>
@@ -23601,7 +23945,8 @@ when no longer needed.
<function name="g_file_get_path">
<description>
-Gets the local pathname for #GFile, if one exists.
+Gets the local pathname for #GFile, if one exists. If non-%NULL, this is
+guaranteed to be an absolute, canonical path. It might contain symlinks.
This call does no blocking I/O.
@@ -23695,7 +24040,7 @@ Checks if @file has a parent, and optionally, if it is @parent.
If @parent is %NULL then this function returns %TRUE if @file has any
parent at all. If @parent is non-%NULL then %TRUE is only returned
-if @file is a child of @parent.
+if @file is an immediate child of @parent.
Since: 2.24
@@ -23710,8 +24055,8 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @file is a child of @parent (or any parent in the
-case that @parent is %NULL).
+<return> %TRUE if @file is an immediate child of @parent (or any parent in
+the case that @parent is %NULL).
</return>
</function>
@@ -23965,7 +24310,8 @@ Gets the attribute type, value and status for an attribute key.
</parameter_description>
</parameter>
<parameter name="value_pp">
-<parameter_description> return location for the attribute value, or %NULL
+<parameter_description> return location for the
+attribute value, or %NULL; the attribute value will not be %NULL
</parameter_description>
</parameter>
<parameter name="status">
@@ -25993,6 +26339,38 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_file_monitor_emit_event">
+<description>
+Emits the #GFileMonitor::changed signal if a change
+has taken place. Should be called from file monitor
+implementations only.
+
+Implementations are responsible to call this method from the
+[thread-default main context][g-main-context-push-thread-default] of the
+thread that the monitor was created in.
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor.
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+<parameter name="other_file">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+<parameter name="event_type">
+<parameter_description> a set of #GFileMonitorEvent flags.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_monitor_file">
<description>
Obtains a file monitor for the given file. If no file notification
@@ -31317,7 +31695,7 @@ Since: 2.22
<function name="g_io_stream_close">
<description>
Closes the stream, releasing resources related to it. This will also
-closes the individual input and output streams, if they are not already
+close the individual input and output streams, if they are not already
closed.
Once the stream is closed, all other operations will return
@@ -31973,6 +32351,30 @@ Since: 2.44
<return></return>
</function>
+<function name="g_list_store_sort">
+<description>
+Sort the items in @store according to @compare_func.
+
+Since: 2.46
+
+</description>
+<parameters>
+<parameter name="store">
+<parameter_description> a #GListStore
+</parameter_description>
+</parameter>
+<parameter name="compare_func">
+<parameter_description> pairwise comparison function for sorting
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for @compare_func
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_list_store_splice">
<description>
Changes @store by removing @n_removals items and adding @n_additions
@@ -32243,7 +32645,8 @@ write or truncate operation on the stream.
</parameter_description>
</parameter>
</parameters>
-<return> pointer to the stream's data
+<return> pointer to the stream's data, or %NULL if the data
+has been stolen
</return>
</function>
@@ -32416,7 +32819,8 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> the stream's data
+<return> the stream's data, or %NULL if it has previously
+been stolen
</return>
</function>
@@ -34895,18 +35299,18 @@ Since: 2.20
<function name="g_native_socket_address_new">
<description>
-Creates a new #GNativeSocketAddress for @address and @port.
+Creates a new #GNativeSocketAddress for @native and @len.
Since: 2.46
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GNativeAddress
+<parameter name="native">
+<parameter_description> a native address object
</parameter_description>
</parameter>
-<parameter name="port">
-<parameter_description> a port number
+<parameter name="len">
+<parameter_description> the length of @native, in bytes
</parameter_description>
</parameter>
</parameters>
@@ -37057,22 +37461,6 @@ Since: 2.26
</return>
</function>
-<function name="g_poll_file_monitor_new">
-<description>
-Polls @file for changes.
-
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> a #GFile.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new #GFileMonitor for the given #GFile.
-</return>
-</function>
-
<function name="g_pollable_input_stream_can_poll">
<description>
Checks if @stream is actually pollable. Some classes may implement
@@ -44171,6 +44559,30 @@ Since: 2.26
</return>
</function>
+<function name="g_socket_connectable_to_string">
+<description>
+Format a #GSocketConnectable as a string. This is a human-readable format for
+use in debugging output, and is not a stable serialization format. It is not
+suitable for use in user interfaces as it exposes too much information for a
+user.
+
+If the #GSocketConnectable implementation does not support string formatting,
+the implementation’s type name will be returned as a fallback.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable
+</parameter_description>
+</parameter>
+</parameters>
+<return> the formatted string
+
+</return>
+</function>
+
<function name="g_socket_connection_connect">
<description>
Connect @connection to the specified remote address.
@@ -44600,7 +45012,7 @@ Since: 2.22
<function name="g_socket_get_available_bytes">
<description>
-Get the amount of data pending in the OS input buffer.
+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
@@ -45013,6 +45425,11 @@ Since: 2.22
Check whether the socket is connected. This is only useful for
connection-oriented sockets.
+If using g_socket_shutdown(), this function will return %TRUE until the
+socket has been shut down for reading and writing. If you do a non-blocking
+connect, this function will not return %TRUE until after you call
+g_socket_check_connect_result().
+
Since: 2.22
</description>
@@ -45762,8 +46179,8 @@ the peer, or -1 on error
<function name="g_socket_receive_message">
<description>
-Receive data from a socket. This is the most complicated and
-fully-featured version of this call. For easier use, see
+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().
If @address is non-%NULL then @address will be set equal to the
@@ -45802,6 +46219,8 @@ for this are available in the #GSocketMsgFlags enum, but the
values there are the same as the system values, and the flags
are passed in as-is, so you can pass in system-specific flags too
(and g_socket_receive_message() may pass system-specific flags out).
+Flags passed in to the parameter affect the receive operation; flags returned
+out of it are relevant to the specific returned message.
As with g_socket_receive(), data may be discarded if @socket is
%G_SOCKET_TYPE_DATAGRAM or %G_SOCKET_TYPE_SEQPACKET and you do not
@@ -45870,6 +46289,95 @@ the peer, or -1 on error
</return>
</function>
+<function name="g_socket_receive_messages">
+<description>
+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().
+
+ messages must point to an array of #GInputMessage structs and
+ num_messages must be the length of this array. Each #GInputMessage
+contains a pointer to an array of #GInputVector structs describing the
+buffers that the data received in each message will be written to. Using
+multiple #GInputVectors is more memory-efficient than manually copying data
+out of a single buffer to multiple sources, and more system-call-efficient
+than making multiple calls to g_socket_receive(), such as in scenarios where
+a lot of data packets need to be received (e.g. high-bandwidth video
+streaming over RTP/UDP).
+
+ flags modify how all messages are received. The commonly available
+arguments for this are available in the #GSocketMsgFlags enum, but the
+values there are the same as the system values, and the flags
+are passed in as-is, so you can pass in system-specific flags too. These
+flags affect the overall receive operation. Flags affecting individual
+messages are returned in #GInputMessage.flags.
+
+The other members of #GInputMessage are treated as described in its
+documentation.
+
+If #GSocket:blocking is %TRUE the call will block until @num_messages have
+been received, or the end of the stream is reached.
+
+If #GSocket:blocking is %FALSE the call will return up to @num_messages
+without blocking, or %G_IO_ERROR_WOULD_BLOCK if no messages are queued in the
+operating system to be received.
+
+In blocking mode, if #GSocket:timeout is positive and is reached before any
+messages are received, %G_IO_ERROR_TIMED_OUT is returned, otherwise up to
+ num_messages are returned. (Note: This is effectively the
+behaviour of `MSG_WAITFORONE` with recvmmsg().)
+
+To be notified when messages are available, wait for the
+%G_IO_IN condition. Note though that you may still receive
+%G_IO_ERROR_WOULD_BLOCK from g_socket_receive_messages() even if you were
+previously notified of a %G_IO_IN condition.
+
+If the remote peer closes the connection, any messages queued in the
+operating system will be returned, and subsequent calls to
+g_socket_receive_messages() will return 0 (with no error set).
+
+On error -1 is returned and @error is set accordingly. An error will only
+be returned if zero messages could be received; otherwise the number of
+messages successfully received before the error will be returned.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="messages">
+<parameter_description> an array of #GInputMessage structs
+</parameter_description>
+</parameter>
+<parameter name="num_messages">
+<parameter_description> the number of elements in @messages
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> an int containing #GSocketMsgFlags flags for the overall operation
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> 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
+to receive the remaining messages.
+
+</return>
+</function>
+
<function name="g_socket_receive_with_blocking">
<description>
This behaves exactly the same as g_socket_receive(), except that
@@ -45963,8 +46471,8 @@ on error
<function name="g_socket_send_message">
<description>
-Send data to @address on @socket. This is the most complicated and
-fully-featured version of this call. For easier use, see
+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().
If @address is %NULL then the message is sent to the default receiver
@@ -46082,7 +46590,9 @@ wait for the %G_IO_OUT condition. Note though that you may still receive
notified of a %G_IO_OUT condition. (On Windows in particular, this is
very common due to the way the underlying APIs work.)
-On error -1 is returned and @error is set accordingly.
+On error -1 is returned and @error is set accordingly. An error will only
+be returned if zero messages could be sent; otherwise the number of messages
+successfully sent before the error will be returned.
Since: 2.44
@@ -46293,7 +46803,8 @@ Since: 2.22
<function name="g_socket_set_blocking">
<description>
Sets the blocking mode of the socket. In blocking mode
-all operations block until they succeed or there is an error. In
+all operations (which don’t take an explicit blocking parameter) block until
+they succeed or there is an error. In
non-blocking mode all functions return results immediately or
with a %G_IO_ERROR_WOULD_BLOCK error.
@@ -46550,7 +47061,7 @@ Since: 2.32
<function name="g_socket_shutdown">
<description>
-Shut down part of a full-duplex connection.
+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.
@@ -46560,9 +47071,10 @@ is shut down, and further writing is disallowed.
It is allowed for both @shutdown_read and @shutdown_write to be %TRUE.
-One example where this is used is graceful disconnect for TCP connections
-where you close the sending side, then wait for the other side to close
-the connection, thus ensuring that the other side saw all sent data.
+One example where it is useful to shut down only one side of a connection is
+graceful disconnect for TCP connections where you close the sending side,
+then wait for the other side to close the connection, thus ensuring that the
+other side saw all sent data.
Since: 2.22
@@ -53197,6 +53709,9 @@ Creates a new #GUnixSocketAddress of type @type with name @path.
If @type is %G_UNIX_SOCKET_ADDRESS_PATH, this is equivalent to
calling g_unix_socket_address_new().
+If @type is %G_UNIX_SOCKET_ADDRESS_ANONYMOUS, @path and @path_len will be
+ignored.
+
If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT, then @path_len
bytes of @path will be copied to the socket's path, and only those
bytes will be considered part of the name. (If @path_len is -1,
@@ -54484,7 +54999,7 @@ Since: 2.46
to watch the key only.
</parameter_description>
</parameter>
-<parameter name="change_flags">
+<parameter name="watch_flags">
<parameter_description> specifies the types of changes to watch for.
</parameter_description>
</parameter>
@@ -54852,16 +55367,20 @@ Since: 2.46
<parameter_description> a #GWin32RegistryValueIter
</parameter_description>
</parameter>
+<parameter name="auto_expand">
+<parameter_description> %TRUE to automatically expand G_WIN32_REGISTRY_VALUE_EXPAND_STR to
+G_WIN32_REGISTRY_VALUE_STR
+</parameter_description>
+</parameter>
<parameter name="value_data">
<parameter_description> Pointer to a
-location to store the data of the value (in UTF-8, if it's a string).
+location to store the data of the value (in UTF-8, if it's a string)
</parameter_description>
</parameter>
<parameter name="value_data_size">
<parameter_description> Pointer to a location to store the length
-of @value_data, in bytes (including any NUL-terminators, if it's a
-string).
-%NULL if length is not needed.
+of @value_data, in bytes (including any NUL-terminators, if it's a string).
+%NULL if length is not needed
</parameter_description>
</parameter>
<parameter name="error">
@@ -54889,18 +55408,17 @@ Since: 2.46
</parameter>
<parameter name="auto_expand">
<parameter_description> %TRUE to automatically expand G_WIN32_REGISTRY_VALUE_EXPAND_STR to
-G_WIN32_REGISTRY_VALUE_STR.
+G_WIN32_REGISTRY_VALUE_STR
</parameter_description>
</parameter>
<parameter name="value_data">
<parameter_description> Pointer to a
-location to store the data of the value (in UTF-16, if it's a string).
+location to store the data of the value (in UTF-16, if it's a string)
</parameter_description>
</parameter>
-<parameter name="value_data_len">
+<parameter name="value_data_size">
<parameter_description> Pointer to a location to store the size
-of @value_data, in bytes (including any NUL-terminators, if it's a
-string).
+of @value_data, in bytes (including any NUL-terminators, if it's a string).
%NULL if length is not needed.
</parameter_description>
</parameter>
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index e8d6834..3bcb9b5 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -3367,6 +3367,30 @@ Old South Arabian. Since 2.26
<parameter_description> Warang Citi. Since: 2.42
</parameter_description>
</parameter>
+<parameter name="G_UNICODE_SCRIPT_AHOM">
+<parameter_description> Ahom. Since 2.48
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_ANATOLIAN_HIEROGLYPHS">
+<parameter_description> Anatolian Hieroglyphs. Since 2.48
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_HATRAN">
+<parameter_description> Hatran. Since 2.48
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_MULTANI">
+<parameter_description> Multani. Since 2.48
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_OLD_HUNGARIAN">
+<parameter_description> Old Hungarian. Since 2.48
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_SIGNWRITING">
+<parameter_description> Signwriting. Since 2.48
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -4791,8 +4815,8 @@ you can reliably detect overflow and underflow.
</parameter_description>
</parameter>
<parameter name="endptr">
-<parameter_description> if non-%NULL, it returns the character after
-the last character used in the conversion.
+<parameter_description> if non-%NULL, it returns the
+character after the last character used in the conversion.
</parameter_description>
</parameter>
</parameters>
@@ -4829,8 +4853,8 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="endptr">
-<parameter_description> if non-%NULL, it returns the character after
-the last character used in the conversion.
+<parameter_description> if non-%NULL, it returns the
+character after the last character used in the conversion.
</parameter_description>
</parameter>
<parameter name="base">
@@ -4872,8 +4896,8 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="endptr">
-<parameter_description> if non-%NULL, it returns the character after
-the last character used in the conversion.
+<parameter_description> if non-%NULL, it returns the
+character after the last character used in the conversion.
</parameter_description>
</parameter>
<parameter name="base">
@@ -5086,6 +5110,45 @@ One of ==, !=, <, >, <=, >=.
<return></return>
</function>
+<function name="g_assert_cmpmem">
+<description>
+Debugging macro to compare memory regions. If the comparison fails,
+an error message is logged and the application is either terminated
+or the testcase marked as failed.
+
+The effect of `g_assert_cmpmem (m1, l1, m2, l2)` is
+the same as `g_assert_true (l1 == l2 && memcmp (m1, m2, l1) == 0)`.
+The advantage of this macro is that it can produce a message that
+includes the actual values of @l1 and @l2.
+
+|[<!-- language="C" -->
+g_assert_cmpmem (buf->data, buf->len, expected, sizeof (expected));
+]|
+
+Since: 2.46
+
+</description>
+<parameters>
+<parameter name="m1">
+<parameter_description> pointer to a buffer
+</parameter_description>
+</parameter>
+<parameter name="l1">
+<parameter_description> length of @m1
+</parameter_description>
+</parameter>
+<parameter name="m2">
+<parameter_description> pointer to another buffer
+</parameter_description>
+</parameter>
+<parameter name="l2">
+<parameter_description> length of @m2
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_assert_cmpstr">
<description>
Debugging macro to compare two strings. If the comparison fails,
@@ -5312,6 +5375,35 @@ Since: 2.38
<return></return>
</function>
+<function name="g_assertion_message_expr">
+<description>
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="file">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="line">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="expr">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_async_queue_length">
<description>
Returns the length of the queue.
@@ -5470,7 +5562,7 @@ Pushes the @data into the @queue. @data must not be %NULL.
<function name="g_async_queue_push_front">
<description>
-Pushes the @data into the @queue. @data must not be %NULL.
+Pushes the @item into the @queue. @item must not be %NULL.
In contrast to g_async_queue_push(), this function
pushes the new item ahead of the items already in the queue,
so that it will be the next one to be popped off the queue.
@@ -5483,8 +5575,8 @@ Since: 2.46
<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> @data to push into the @queue
+<parameter name="item">
+<parameter_description> data to push into the @queue
</parameter_description>
</parameter>
</parameters>
@@ -5493,7 +5585,7 @@ Since: 2.46
<function name="g_async_queue_push_front_unlocked">
<description>
-Pushes the @data into the @queue. @data must not be %NULL.
+Pushes the @item into the @queue. @item must not be %NULL.
In contrast to g_async_queue_push_unlocked(), this function
pushes the new item ahead of the items already in the queue,
so that it will be the next one to be popped off the queue.
@@ -5508,8 +5600,8 @@ Since: 2.46
<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> @data to push into the @queue
+<parameter name="item">
+<parameter_description> data to push into the @queue
</parameter_description>
</parameter>
</parameters>
@@ -5662,8 +5754,8 @@ Since: 2.46
<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> the @data to remove from the @queue
+<parameter name="item">
+<parameter_description> the data to remove from the @queue
</parameter_description>
</parameter>
</parameters>
@@ -5686,8 +5778,8 @@ Since: 2.46
<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> the @data to remove from the @queue
+<parameter name="item">
+<parameter_description> the data to remove from the @queue
</parameter_description>
</parameter>
</parameters>
@@ -6501,8 +6593,10 @@ my_func(void)
{
g_auto(GQueue) queue = G_QUEUE_INIT;
g_auto(GVariantBuilder) builder;
+g_auto(GStrv) strv;
g_variant_builder_init (&builder, G_VARIANT_TYPE_VARDICT);
+strv = g_strsplit("a:b:c", ":", -1);
...
@@ -6515,7 +6609,7 @@ return g_variant_builder_end (&builder);
}
]|
-You must initialise the variable in some way -- either by use of an
+You must initialize the variable in some way -- either by use of an
initialiser or by ensuring that an _init function will be called on
it unconditionally before it goes out of scope.
@@ -6596,9 +6690,8 @@ Consider the following example:
gboolean
check_exists(GVariant *dict)
{
-g_autoptr(GVariant) dirname;
-g_autoptr(GVariant) basename = NULL;
-g_autoptr(gchar) path = NULL;
+g_autoptr(GVariant) dirname, basename = NULL;
+g_autofree gchar *path = NULL;
dirname = g_variant_lookup_value (dict, "dirname", G_VARIANT_TYPE_STRING);
@@ -6622,6 +6715,8 @@ You must initialise the variable in some way -- either by use of an
initialiser or by ensuring that it is assigned to unconditionally
before it goes out of scope.
+See also g_auto(), g_autofree() and g_steal_pointer().
+
Since: 2.44
</description>
@@ -7031,7 +7126,8 @@ usually). To start searching from the 0th bit, set @nth_bit to -1.
</parameter_description>
</parameter>
</parameters>
-<return> the index of the first bit set which is higher than @nth_bit
+<return> the index of the first bit set which is higher than @nth_bit, or -1
+if no higher bits are set
</return>
</function>
@@ -7055,7 +7151,8 @@ usually). To start searching from the last bit, set @nth_bit to
</parameter_description>
</parameter>
</parameters>
-<return> the index of the first bit set which is lower than @nth_bit
+<return> the index of the first bit set which is lower than @nth_bit, or -1
+if no lower bits are set
</return>
</function>
@@ -8385,7 +8482,8 @@ Provide a copy of a boxed structure @src_boxed which is of type @boxed_type.
</parameter_description>
</parameter>
</parameters>
-<return> The newly created copy of the boxed structure.
+<return> The newly created copy of the boxed
+structure.
</return>
</function>
@@ -8967,8 +9065,8 @@ Since: 2.32
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the
-byte data, or %NULL
+<return>
+a pointer to the byte data, or %NULL
</return>
</function>
@@ -9146,7 +9244,8 @@ Since: 2.32
</description>
<parameters>
<parameter name="data">
-<parameter_description> the data to be used for the bytes
+<parameter_description>
+ the data to be used for the bytes
</parameter_description>
</parameter>
<parameter name="size">
@@ -9249,8 +9348,9 @@ Since: 2.32
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the same byte data, which should
-be freed with g_free()
+<return> (transfer full) (array length=size) (element-type guint8)
+(not nullable): a pointer to the same byte data, which should be
+freed with g_free()
</return>
</function>
@@ -11330,7 +11430,8 @@ value.
</parameter_description>
</parameter>
<parameter name="instance">
-<parameter_description> the instance on which the closure is invoked.
+<parameter_description> the instance on which the closure is
+invoked.
</parameter_description>
</parameter>
<parameter name="args_list">
@@ -11889,7 +11990,8 @@ Since: 2.34
</description>
<parameters>
<parameter name="pp">
-<parameter_description> a pointer to a variable, struct member etc. holding a pointer
+<parameter_description> a pointer to a variable, struct member etc. holding a
+pointer
</parameter_description>
</parameter>
<parameter name="destroy">
@@ -11994,7 +12096,8 @@ g_object_watch_closure() for an example of marshal guards.
</parameter_description>
</parameter>
<parameter name="pre_marshal_data">
-<parameter_description> data to pass to @pre_marshal_notify
+<parameter_description> data to pass
+to @pre_marshal_notify
</parameter_description>
</parameter>
<parameter name="pre_marshal_notify">
@@ -12002,7 +12105,8 @@ g_object_watch_closure() for an example of marshal guards.
</parameter_description>
</parameter>
<parameter name="post_marshal_data">
-<parameter_description> data to pass to @post_marshal_notify
+<parameter_description> data to pass
+to @post_marshal_notify
</parameter_description>
</parameter>
<parameter name="post_marshal_notify">
@@ -12268,7 +12372,8 @@ the right callback and passes it to the marshaller as the
</parameter_description>
</parameter>
<parameter name="marshal_data">
-<parameter_description> context-dependent data to pass to @meta_marshal
+<parameter_description> context-dependent data to pass
+to @meta_marshal
</parameter_description>
</parameter>
<parameter name="meta_marshal">
@@ -16981,7 +17086,7 @@ a certain case, your code will still work.
</description>
<parameters>
<parameter name="error">
-<parameter_description> a #GError or %NULL
+<parameter_description> a #GError
</parameter_description>
</parameter>
<parameter name="domain">
@@ -17409,7 +17514,8 @@ encoding used for filenames.
</parameter_description>
</parameter>
<parameter name="hostname">
-<parameter_description> Location to store hostname for the URI, or %NULL.
+<parameter_description> Location to store hostname for the
+URI.
If there is no hostname in the URI, %NULL will be
stored in this location.
</parameter_description>
@@ -17522,7 +17628,7 @@ for the @len parameter is unsafe)
</parameter_description>
</parameter>
<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
+<parameter_description> location to store the number of bytes in the
input string that were successfully converted, or %NULL.
Even if the conversion was successful, this may be
less than @len if there were partial characters
@@ -17533,8 +17639,8 @@ input sequence.
</parameter_description>
</parameter>
<parameter name="bytes_written">
-<parameter_description> the number of bytes stored in the output buffer (not
-including the terminating nul).
+<parameter_description> the number of bytes stored in the output
+buffer (not including the terminating nul).
</parameter_description>
</parameter>
<parameter name="error">
@@ -18759,10 +18865,10 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a #GList containing all the keys inside the hash
-table. The content of the list is owned by the hash table and
-should not be modified or freed. Use g_list_free() when done
-using the list.
+<return> a #GList containing all the keys
+inside the hash table. The content of the list is owned by the
+hash table and should not be modified or freed. Use g_list_free()
+when done using the list.
</return>
</function>
@@ -18824,10 +18930,10 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a #GList containing all the values inside the hash
-table. The content of the list is owned by the hash table and
-should not be modified or freed. Use g_list_free() when done
-using the list.
+<return> a #GList containing all the values
+inside the hash table. The content of the list is owned by the
+hash table and should not be modified or freed. Use g_list_free()
+when done using the list.
</return>
</function>
@@ -18928,11 +19034,11 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="key">
-<parameter_description> a location to store the key, or %NULL
+<parameter_description> a location to store the key
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> a location to store the value, or %NULL
+<parameter_description> a location to store the value
</parameter_description>
</parameter>
</parameters>
@@ -19065,11 +19171,12 @@ of @hash_table are %NULL-safe.
</parameter_description>
</parameter>
<parameter name="orig_key">
-<parameter_description> return location for the original key, or %NULL
+<parameter_description> return location for the original key
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> return location for the value associated with the key, or %NULL
+<parameter_description> return location for the value associated
+with the key
</parameter_description>
</parameter>
</parameters>
@@ -24028,7 +24135,7 @@ for the @len parameter is unsafe)
</parameter_description>
</parameter>
<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
+<parameter_description> location to store the number of bytes in the
input string that were successfully converted, or %NULL.
Even if the conversion was successful, this may be
less than @len if there were partial characters
@@ -24039,8 +24146,8 @@ input sequence.
</parameter_description>
</parameter>
<parameter name="bytes_written">
-<parameter_description> the number of bytes stored in the output buffer (not
-including the terminating nul).
+<parameter_description> the number of bytes stored in the output
+buffer (not including the terminating nul).
</parameter_description>
</parameter>
<parameter name="error">
@@ -24076,7 +24183,7 @@ for the @len parameter is unsafe)
</parameter_description>
</parameter>
<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
+<parameter_description> location to store the number of bytes in the
input string that were successfully converted, or %NULL.
Even if the conversion was successful, this may be
less than @len if there were partial characters
@@ -24087,8 +24194,8 @@ input sequence.
</parameter_description>
</parameter>
<parameter name="bytes_written">
-<parameter_description> the number of bytes stored in the output buffer (not
-including the terminating nul).
+<parameter_description> the number of bytes stored in the output
+buffer (not including the terminating nul).
</parameter_description>
</parameter>
<parameter name="error">
@@ -24116,7 +24223,8 @@ manually.
</description>
<parameters>
<parameter name="log_domain">
-<parameter_description> the log domain, usually #G_LOG_DOMAIN
+<parameter_description> the log domain, usually #G_LOG_DOMAIN, or %NULL
+for the default
</parameter_description>
</parameter>
<parameter name="log_level">
@@ -24164,7 +24272,8 @@ the rest.
</description>
<parameters>
<parameter name="log_domain">
-<parameter_description> the log domain of the message
+<parameter_description> the log domain of the message, or %NULL for the
+default "" application domain
</parameter_description>
</parameter>
<parameter name="log_level">
@@ -24382,7 +24491,8 @@ manually.
</description>
<parameters>
<parameter name="log_domain">
-<parameter_description> the log domain
+<parameter_description> the log domain, or %NULL for the default ""
+application domain
</parameter_description>
</parameter>
<parameter name="log_level">
@@ -28455,7 +28565,8 @@ thread. Use #GWeakRef if thread-safety is required.
</parameter_description>
</parameter>
<parameter name="weak_pointer_location">
-<parameter_description> The memory address of a pointer.
+<parameter_description> The memory address
+of a pointer.
</parameter_description>
</parameter>
</parameters>
@@ -29217,8 +29328,8 @@ Since: 2.4
</description>
<parameters>
<parameter name="g_iface">
-<parameter_description> any interface vtable for the interface, or the default
-vtable for the interface
+<parameter_description> any interface vtable for the
+interface, or the default vtable for the interface
</parameter_description>
</parameter>
<parameter name="property_name">
@@ -29254,7 +29365,8 @@ Since: 2.4
</description>
<parameters>
<parameter name="g_iface">
-<parameter_description> any interface vtable for the interface, or the default
+<parameter_description> any interface vtable for the
+interface, or the default
vtable for the interface.
</parameter_description>
</parameter>
@@ -29279,8 +29391,8 @@ Since: 2.4
</description>
<parameters>
<parameter name="g_iface">
-<parameter_description> any interface vtable for the interface, or the default
-vtable for the interface
+<parameter_description> any interface vtable for the
+interface, or the default vtable for the interface
</parameter_description>
</parameter>
<parameter name="n_properties_p">
@@ -29338,7 +29450,8 @@ name/value pairs, followed by %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new instance of @object_type
+<return> a new instance of
+ object_type
</return>
</function>
@@ -29563,7 +29676,8 @@ to match the one used with g_object_add_weak_pointer().
</parameter_description>
</parameter>
<parameter name="weak_pointer_location">
-<parameter_description> The memory address of a pointer.
+<parameter_description> The memory address
+of a pointer.
</parameter_description>
</parameter>
</parameters>
@@ -30231,7 +30345,8 @@ Since: 2.14
</description>
<parameters>
<parameter name="location">
-<parameter_description> location of a static initializable variable containing 0
+<parameter_description> location of a static initializable variable
+containing 0
</parameter_description>
</parameter>
</parameters>
@@ -30254,7 +30369,8 @@ Since: 2.14
</description>
<parameters>
<parameter name="location">
-<parameter_description> location of a static initializable variable containing 0
+<parameter_description> location of a static initializable variable
+containing 0
</parameter_description>
</parameter>
<parameter name="result">
@@ -31402,15 +31518,15 @@ Get the short description of a #GParamSpec.
<function name="g_param_spec_get_default_value">
<description>
-Gets the default value of @param as a pointer to a #GValue.
+Gets the default value of @pspec as a pointer to a #GValue.
-The #GValue will remain value for the life of @param.
+The #GValue will remain value for the life of @pspec.
Since: 2.38
</description>
<parameters>
-<parameter name="param">
+<parameter name="pspec">
<parameter_description> a #GParamSpec
</parameter_description>
</parameter>
@@ -31439,6 +31555,24 @@ This allows for pointer-value comparisons.
</return>
</function>
+<function name="g_param_spec_get_name_quark">
+<description>
+Gets the GQuark for the name.
+
+Since: 2.46
+
+</description>
+<parameters>
+<parameter name="pspec">
+<parameter_description> a #GParamSpec
+</parameter_description>
+</parameter>
+</parameters>
+<return> the GQuark for @pspec->name.
+
+</return>
+</function>
+
<function name="g_param_spec_get_nick">
<description>
Get the nickname of a #GParamSpec.
@@ -33021,7 +33155,7 @@ Since: 2.16
</description>
<parameters>
<parameter name="err">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> a return location for a #GError
</parameter_description>
</parameter>
<parameter name="format">
@@ -33228,6 +33362,8 @@ the #GDestroyNotify for @key is not called on the old value.
If @dest is %NULL, free @src; otherwise, moves @src into * dest
The error variable @dest points to must be %NULL.
+ src must be non-%NULL.
+
Note that @src is no longer valid after this call. If you want
to keep using the same GError*, you need to set it to %NULL
after calling this function on it.
@@ -36554,6 +36690,27 @@ should therefore not depend on any side effects of @expr.
<return></return>
</function>
+<function name="g_return_if_fail_warning">
+<description>
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="pretty_function">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="expression">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_return_if_reached">
<description>
Logs a critical message and returns from the current function.
@@ -37555,7 +37712,9 @@ Since: 2.14
<function name="g_sequence_get_length">
<description>
-Returns the length of @seq
+Returns the length of @seq. Note that this method is O(h) where `h' is the
+height of the tree. It is thus more efficient to use g_sequence_is_empty()
+when comparing the length to zero.
Since: 2.14
@@ -37672,6 +37831,28 @@ Since: 2.14
</return>
</function>
+<function name="g_sequence_is_empty">
+<description>
+Returns %TRUE if the sequence contains zero items.
+
+This function is functionally identical to checking the result of
+g_sequence_get_length() being equal to zero. However this function is
+implemented in O(1) running time.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="seq">
+<parameter_description> a #GSequence
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the sequence is empty, otherwise %FALSE.
+
+</return>
+</function>
+
<function name="g_sequence_iter_compare">
<description>
Returns a negative number if @a comes before @b, 0 if they are equal,
@@ -38386,7 +38567,7 @@ must be %NULL. A new #GError is created and assigned to * err
</description>
<parameters>
<parameter name="err">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> a return location for a #GError
</parameter_description>
</parameter>
<parameter name="domain">
@@ -38422,7 +38603,7 @@ Since: 2.18
</description>
<parameters>
<parameter name="err">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> a return location for a #GError
</parameter_description>
</parameter>
<parameter name="domain">
@@ -38612,16 +38793,16 @@ domain. Free the returned vector with g_strfreev().
</parameter_description>
</parameter>
<parameter name="argcp">
-<parameter_description> return location for number of args, or %NULL
+<parameter_description> return location for number of args
</parameter_description>
</parameter>
<parameter name="argvp">
<parameter_description> return
-location for array of args, or %NULL
+location for array of args
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> return location for error
</parameter_description>
</parameter>
</parameters>
@@ -38834,7 +39015,8 @@ Since: 2.18
</description>
<parameters>
<parameter name="instance">
-<parameter_description> the instance the signal is being emitted on.
+<parameter_description> the instance the signal is being
+emitted on.
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -39039,7 +39221,8 @@ is not safe).
</parameter_description>
</parameter>
<parameter name="gobject">
-<parameter_description> the object to pass as data to @c_handler.
+<parameter_description> the object to pass as data
+to @c_handler.
</parameter_description>
</parameter>
<parameter name="connect_flags">
@@ -39172,7 +39355,8 @@ if no handlers are connected, in contrast to g_signal_emitv().
</description>
<parameters>
<parameter name="instance">
-<parameter_description> the instance the signal is being emitted on.
+<parameter_description> the instance the signal is being
+emitted on.
</parameter_description>
</parameter>
<parameter name="signal_id">
@@ -39649,6 +39833,9 @@ connected both without detail and with the given detail. This is
consistent with how a signal emitted with @detail would be delivered
to those handlers.
+Since 2.46 this also checks for a non-default class closure being
+installed, as this is basically always what you want.
+
One example of when you might use this is when the arguments to the
signal are difficult to compute. A class implementor may opt to not
emit the signal if no one is attached anyway, thus saving the cost
@@ -40258,6 +40445,66 @@ structure which is to be invoked by the new closure
</return>
</function>
+<function name="g_size_checked_add">
+<description>
+Performs a checked addition of @a and @b, storing the result in
+ dest
+
+If the operation is successful, %TRUE is returned. If the operation
+overflows then the state of @dest is undefined and %FALSE is
+returned.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="dest">
+<parameter_description> a pointer to the #gsize destination
+</parameter_description>
+</parameter>
+<parameter name="a">
+<parameter_description> the #gsize left operand
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> the #gsize right operand
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there was no overflow
+</return>
+</function>
+
+<function name="g_size_checked_mul">
+<description>
+Performs a checked multiplication of @a and @b, storing the result in
+ dest
+
+If the operation is successful, %TRUE is returned. If the operation
+overflows then the state of @dest is undefined and %FALSE is
+returned.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="dest">
+<parameter_description> a pointer to the #gsize destination
+</parameter_description>
+</parameter>
+<parameter name="a">
+<parameter_description> the #gsize left operand
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> the #gsize right operand
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there was no overflow
+</return>
+</function>
+
<function name="g_slice_alloc">
<description>
Allocates a block of memory from the slice allocator.
@@ -40279,7 +40526,8 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the allocated memory block
+<return> a pointer to the allocated memory block, which will be %NULL if and
+only if @mem_size is 0
</return>
</function>
@@ -40300,7 +40548,8 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the allocated block
+<return> a pointer to the allocated block, which will be %NULL if and only
+if @mem_size is 0
</return>
</function>
@@ -40310,6 +40559,8 @@ Since: 2.10
Allocates a block of memory from the slice allocator
and copies @block_size bytes into it from @mem_block.
+ mem_block must be non-%NULL if @block_size is non-zero.
+
Since: 2.14
</description>
@@ -40323,7 +40574,8 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the allocated memory block
+<return> a pointer to the allocated memory block, which will be %NULL if and
+only if @mem_size is 0
</return>
</function>
@@ -40340,6 +40592,8 @@ Note that the underlying slice allocation mechanism can
be changed with the [`G_SLICE=always-malloc`][G_SLICE]
environment variable.
+This can never return %NULL.
+
Since: 2.14
</description>
@@ -40353,7 +40607,8 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the allocated block, cast to a pointer to @type
+<return> a pointer to the allocated block, cast to a pointer
+to @type
</return>
</function>
@@ -40369,6 +40624,8 @@ Note that the exact release behaviour can be changed with the
[`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
[`G_SLICE`][G_SLICE] for related debugging options.
+If @mem is %NULL, this macro does nothing.
+
Since: 2.10
</description>
@@ -40395,6 +40652,8 @@ specified upon allocation. Note that the exact release behaviour
can be changed with the [`G_DEBUG=gc-friendly`][G_DEBUG] environment
variable, also see [`G_SLICE`][G_SLICE] for related debugging options.
+If @mem_block is %NULL, this function does nothing.
+
Since: 2.10
</description>
@@ -40422,6 +40681,8 @@ Note that the exact release behaviour can be changed with the
[`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
[`G_SLICE`][G_SLICE] for related debugging options.
+If @mem_chain is %NULL, this function does nothing.
+
Since: 2.10
</description>
@@ -40454,6 +40715,8 @@ Note that the exact release behaviour can be changed with the
[`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
[`G_SLICE`][G_SLICE] for related debugging options.
+If @mem_chain is %NULL, this function does nothing.
+
Since: 2.10
</description>
@@ -40485,6 +40748,9 @@ cast in the source code. Note that the underlying slice allocation
mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE]
environment variable.
+This can never return %NULL as the minimum allocation size from
+`sizeof (@type)` is 1 byte.
+
Since: 2.10
</description>
@@ -40494,7 +40760,8 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the allocated block, cast to a pointer to @type
+<return> a pointer to the allocated block, cast to a pointer
+to @type
</return>
</function>
@@ -40511,6 +40778,9 @@ Note that the underlying slice allocation mechanism can
be changed with the [`G_SLICE=always-malloc`][G_SLICE]
environment variable.
+This can never return %NULL as the minimum allocation size from
+`sizeof (@type)` is 1 byte.
+
Since: 2.10
</description>
@@ -40520,7 +40790,10 @@ Since: 2.10
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a pointer to the allocated block, cast to a pointer
+to @type
+
+</return>
</function>
<function name="g_slist_alloc">
@@ -44007,10 +44280,14 @@ on a %NULL value, g_strdupv() simply returns %NULL.
<function name="g_strerror">
<description>
-Returns a string corresponding to the given error code, e.g.
-"no such process". You should use this function in preference to
-strerror(), because it returns a string in UTF-8 encoding, and since
-not all platforms support the strerror() function.
+Returns a string corresponding to the given error code, e.g. "no
+such process". Unlike strerror(), this always returns a string in
+UTF-8 encoding, and the pointer is guaranteed to remain valid for
+the lifetime of the process.
+
+Note that the string may be translated according to the current locale.
+
+The value of %errno will not be changed by this function.
</description>
@@ -44022,7 +44299,7 @@ documentation
</parameter>
</parameters>
<return> a UTF-8 string describing the error code. If the error code
-is unknown, it returns "unknown error (<code>)".
+is unknown, it returns a string like "unknown error (<code>)".
</return>
</function>
@@ -44711,7 +44988,7 @@ Creates a new #GString, initialized with the given string.
<parameters>
<parameter name="init">
<parameter_description> the initial text to copy into the string, or %NULL to
-start with an empty string.
+start with an empty string
</parameter_description>
</parameter>
</parameters>
@@ -45573,8 +45850,8 @@ point in some locales, causing unexpected results.
</parameter_description>
</parameter>
<parameter name="endptr">
-<parameter_description> if non-%NULL, it returns the character after
-the last character used in the conversion.
+<parameter_description> if non-%NULL, it returns the
+character after the last character used in the conversion.
</parameter_description>
</parameter>
</parameters>
@@ -47041,7 +47318,7 @@ message.
|[<!-- language="C" -->
static void
-test_create_large_object_subprocess (void)
+test_create_large_object (void)
{
if (g_test_subprocess ())
{
@@ -48713,6 +48990,7 @@ Returns the height of a #GTrashStack.
Note that execution of this function is of O(N) complexity
where N denotes the number of items on the stack.
+Deprecated: 2.48: #GTrashStack is deprecated without replacement
</description>
<parameters>
@@ -48730,6 +49008,7 @@ where N denotes the number of items on the stack.
Returns the element at the top of a #GTrashStack
which may be %NULL.
+Deprecated: 2.48: #GTrashStack is deprecated without replacement
</description>
<parameters>
@@ -48746,6 +49025,7 @@ which may be %NULL.
<description>
Pops a piece of memory off a #GTrashStack.
+Deprecated: 2.48: #GTrashStack is deprecated without replacement
</description>
<parameters>
@@ -48761,6 +49041,7 @@ Pops a piece of memory off a #GTrashStack.
<function name="g_trash_stack_push">
<description>
Pushes a piece of memory onto a #GTrashStack.
+Deprecated: 2.48: #GTrashStack is deprecated without replacement
</description>
<parameters>
@@ -49317,7 +49598,7 @@ Attempts to allocate @n_structs elements of type @struct_type, initialized
to 0's, and returns %NULL on failure. Contrast with g_new0(), which aborts
the program on failure.
The returned pointer is cast to a pointer to the given type.
-The function returns %NULL when @n_structs is 0 of if an overflow occurs.
+The function returns %NULL when @n_structs is 0 or if an overflow occurs.
Since: 2.8
@@ -49703,7 +49984,8 @@ Since: 2.4
</description>
<parameters>
<parameter name="g_class">
-<parameter_description> class structure for an instantiatable type
+<parameter_description> class structure for an instantiatable
+type
</parameter_description>
</parameter>
<parameter name="private_size">
@@ -50997,15 +51279,15 @@ If @len < 0, then the string is nul-terminated.
</parameter_description>
</parameter>
<parameter name="items_read">
-<parameter_description> location to store number of bytes read,
-or %NULL. If an error occurs then the index of the invalid input
-is stored here.
+<parameter_description> location to store number of
+bytes read, or %NULL. If an error occurs then the index of the invalid
+input is stored here.
</parameter_description>
</parameter>
<parameter name="items_written">
-<parameter_description> location to store number of #gunichar2
-written, or %NULL. The value stored here does not include the
-trailing 0.
+<parameter_description> location to store number
+of #gunichar2 written, or %NULL. The value stored here does not include
+the trailing 0.
</parameter_description>
</parameter>
<parameter name="error">
@@ -51039,14 +51321,14 @@ If @len < 0, then the string is nul-terminated.
</parameter_description>
</parameter>
<parameter name="items_read">
-<parameter_description> location to store number of characters
-read, or %NULL.
+<parameter_description> location to store number of
+characters read, or %NULL.
</parameter_description>
</parameter>
<parameter name="items_written">
-<parameter_description> location to store number of bytes
-written or %NULL. The value here stored does not include the
-trailing 0 byte.
+<parameter_description> location to store number
+of bytes written or %NULL. The value here stored does not include the
+trailing 0 byte.
</parameter_description>
</parameter>
<parameter name="error">
@@ -51063,6 +51345,126 @@ will be set to the position of the first invalid input character.
</return>
</function>
+<function name="g_uint64_checked_add">
+<description>
+Performs a checked addition of @a and @b, storing the result in
+ dest
+
+If the operation is successful, %TRUE is returned. If the operation
+overflows then the state of @dest is undefined and %FALSE is
+returned.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="dest">
+<parameter_description> a pointer to the #guint64 destination
+</parameter_description>
+</parameter>
+<parameter name="a">
+<parameter_description> the #guint64 left operand
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> the #guint64 right operand
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there was no overflow
+</return>
+</function>
+
+<function name="g_uint64_checked_mul">
+<description>
+Performs a checked multiplication of @a and @b, storing the result in
+ dest
+
+If the operation is successful, %TRUE is returned. If the operation
+overflows then the state of @dest is undefined and %FALSE is
+returned.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="dest">
+<parameter_description> a pointer to the #guint64 destination
+</parameter_description>
+</parameter>
+<parameter name="a">
+<parameter_description> the #guint64 left operand
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> the #guint64 right operand
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there was no overflow
+</return>
+</function>
+
+<function name="g_uint_checked_add">
+<description>
+Performs a checked addition of @a and @b, storing the result in
+ dest
+
+If the operation is successful, %TRUE is returned. If the operation
+overflows then the state of @dest is undefined and %FALSE is
+returned.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="dest">
+<parameter_description> a pointer to the #guint destination
+</parameter_description>
+</parameter>
+<parameter name="a">
+<parameter_description> the #guint left operand
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> the #guint right operand
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there was no overflow
+</return>
+</function>
+
+<function name="g_uint_checked_mul">
+<description>
+Performs a checked multiplication of @a and @b, storing the result in
+ dest
+
+If the operation is successful, %TRUE is returned. If the operation
+overflows then the state of @dest is undefined and %FALSE is
+returned.
+
+Since: 2.48
+
+</description>
+<parameters>
+<parameter name="dest">
+<parameter_description> a pointer to the #guint destination
+</parameter_description>
+</parameter>
+<parameter name="a">
+<parameter_description> the #guint left operand
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> the #guint right operand
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there was no overflow
+</return>
+</function>
+
<function name="g_unichar_break_type">
<description>
Determines the break type of @c. @c should be a Unicode character
@@ -51658,9 +52060,9 @@ Converts a single character to UTF-8.
</parameter_description>
</parameter>
<parameter name="outbuf">
-<parameter_description> output buffer, must have at least 6 bytes of space.
-If %NULL, the length will be computed and returned
-and nothing will be written to @outbuf.
+<parameter_description> output buffer, must have at
+least 6 bytes of space. If %NULL, the length will be computed and
+returned and nothing will be written to @outbuf.
</parameter_description>
</parameter>
</parameters>
@@ -52391,16 +52793,16 @@ If @len < 0, then the string is nul-terminated.
</parameter_description>
</parameter>
<parameter name="items_read">
-<parameter_description> location to store number of words read,
-or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be
-returned in case @str contains a trailing partial character. If
+<parameter_description> location to store number of
+words read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will
+be returned in case @str contains a trailing partial character. If
an error occurs then the index of the invalid input is stored here.
</parameter_description>
</parameter>
<parameter name="items_written">
-<parameter_description> location to store number of characters
-written, or %NULL. The value stored here does not include the trailing
-0 character.
+<parameter_description> location to store number
+of characters written, or %NULL. The value stored here does not include
+the trailing 0 character.
</parameter_description>
</parameter>
<parameter name="error">
@@ -52445,15 +52847,16 @@ If @len < 0, then the string is nul-terminated.
</parameter_description>
</parameter>
<parameter name="items_read">
-<parameter_description> location to store number of words read,
-or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be
-returned in case @str contains a trailing partial character. If
+<parameter_description> location to store number of
+words read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will
+be returned in case @str contains a trailing partial character. If
an error occurs then the index of the invalid input is stored here.
</parameter_description>
</parameter>
<parameter name="items_written">
-<parameter_description> location to store number of bytes written,
-or %NULL. The value stored here does not include the trailing 0 byte.
+<parameter_description> location to store number
+of bytes written, or %NULL. The value stored here does not include the
+trailing 0 byte.
</parameter_description>
</parameter>
<parameter name="error">
@@ -53074,7 +53477,8 @@ then the string is nul-terminated.
</parameter_description>
</parameter>
<parameter name="items_read">
-<parameter_description> location to store number of bytes read, or %NULL.
+<parameter_description> location to store number of
+bytes read, or %NULL.
If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be
returned in case @str contains a trailing partial
character. If an error occurs then the index of the
@@ -53082,9 +53486,9 @@ invalid input is stored here.
</parameter_description>
</parameter>
<parameter name="items_written">
-<parameter_description> location to store number of characters
-written or %NULL. The value here stored does not include the
-trailing 0 character.
+<parameter_description> location to store number
+of characters written or %NULL. The value here stored does not include
+the trailing 0 character.
</parameter_description>
</parameter>
<parameter name="error">
@@ -53121,8 +53525,8 @@ then the string is nul-terminated.
</parameter_description>
</parameter>
<parameter name="items_written">
-<parameter_description> location to store the number of
-characters in the result, or %NULL.
+<parameter_description> location to store the
+number of characters in the result, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -53149,16 +53553,16 @@ If @len < 0, then the string is nul-terminated.
</parameter_description>
</parameter>
<parameter name="items_read">
-<parameter_description> location to store number of bytes read,
-or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be
-returned in case @str contains a trailing partial character. If
+<parameter_description> location to store number of
+bytes read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will
+be returned in case @str contains a trailing partial character. If
an error occurs then the index of the invalid input is stored here.
</parameter_description>
</parameter>
<parameter name="items_written">
-<parameter_description> location to store number of #gunichar2
-written, or %NULL. The value stored here does not include the
-trailing 0.
+<parameter_description> location to store number
+of #gunichar2 written, or %NULL. The value stored here does not include
+the trailing 0.
</parameter_description>
</parameter>
<parameter name="error">
@@ -54769,10 +55173,10 @@ transform function must be registered.
<function name="g_value_unset">
<description>
-Clears the current value in @value and "unsets" the type,
-this releases all resources associated with this GValue.
-An unset value is the same as an uninitialized (zero-filled)
-#GValue structure.
+Clears the current value in @value (if any) and "unsets" the type,
+this releases all resources associated with this GValue. An unset
+value is the same as an uninitialized (zero-filled) #GValue
+structure.
</description>
<parameters>
@@ -59364,6 +59768,35 @@ Since: 2.16
<return></return>
</function>
+<function name="g_warn_message">
+<description>
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="file">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="line">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="warnexpr">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_warning">
<description>
A convenience function/macro to log a warning message.
@@ -60087,6 +60520,9 @@ against at application run time.
<function name="glib_mem_profiler_table">
<description>
+Used to be a #GMemVTable containing profiling variants of the memory
+allocation functions, but this variable shouldn't be modified anymore.
+
Deprecated: 2.46: Use other memory profiling tools instead
</description>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
