mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-10 03:16:17 +01:00
parent
4a1f1e3681
commit
156e0c865a
@ -76,6 +76,7 @@ The equivalent C types are as follows:
|
|||||||
| `h` | `gint32` (handle) |
|
| `h` | `gint32` (handle) |
|
||||||
| `d` | `gdouble` |
|
| `d` | `gdouble` |
|
||||||
|
|
||||||
|
<a id="varargs"></a>
|
||||||
Note that in C, small integer types in variable argument lists are promoted
|
Note that in C, small integer types in variable argument lists are promoted
|
||||||
up to `int` or `unsigned int` as appropriate, and read back accordingly. `int`
|
up to `int` or `unsigned int` as appropriate, and read back accordingly. `int`
|
||||||
is 32 bits on every platform on which GLib is currently supported. This
|
is 32 bits on every platform on which GLib is currently supported. This
|
||||||
|
@ -135,7 +135,7 @@ g_action_map_remove_action (GActionMap *action_map,
|
|||||||
* activate function for this action, given as a single
|
* activate function for this action, given as a single
|
||||||
* GVariant type string (or %NULL for no parameter)
|
* GVariant type string (or %NULL for no parameter)
|
||||||
* @state: the initial state for this action, given in
|
* @state: the initial state for this action, given in
|
||||||
* [GVariant text format][gvariant-text]. The state is parsed
|
* [GVariant text format](gvariant-text-format.html). The state is parsed
|
||||||
* with no extra type information, so type tags must be added to
|
* with no extra type information, so type tags must be added to
|
||||||
* the string if they are necessary. Stateless actions should
|
* the string if they are necessary. Stateless actions should
|
||||||
* give %NULL here.
|
* give %NULL here.
|
||||||
|
@ -2587,7 +2587,7 @@ g_variant_parse (const GVariantType *type,
|
|||||||
*
|
*
|
||||||
* Note that the arguments in @app must be of the correct width for their types
|
* Note that the arguments in @app must be of the correct width for their types
|
||||||
* specified in @format when collected into the #va_list. See
|
* specified in @format when collected into the #va_list. See
|
||||||
* the [GVariant varargs documentation][gvariant-varargs].
|
* the [GVariant varargs documentation](gvariant-format-strings.html#varargs).
|
||||||
*
|
*
|
||||||
* In order to behave correctly in all cases it is necessary for the
|
* In order to behave correctly in all cases it is necessary for the
|
||||||
* calling function to g_variant_ref_sink() the return result before
|
* calling function to g_variant_ref_sink() the return result before
|
||||||
@ -2646,7 +2646,7 @@ g_variant_new_parsed_va (const gchar *format,
|
|||||||
*
|
*
|
||||||
* Note that the arguments must be of the correct width for their types
|
* Note that the arguments must be of the correct width for their types
|
||||||
* specified in @format. This can be achieved by casting them. See
|
* specified in @format. This can be achieved by casting them. See
|
||||||
* the [GVariant varargs documentation][gvariant-varargs].
|
* the [GVariant varargs documentation](gvariant-format-strings.html#varargs).
|
||||||
*
|
*
|
||||||
* Consider this simple example:
|
* Consider this simple example:
|
||||||
* |[<!-- language="C" -->
|
* |[<!-- language="C" -->
|
||||||
@ -2699,7 +2699,7 @@ g_variant_new_parsed (const gchar *format,
|
|||||||
*
|
*
|
||||||
* Note that the arguments must be of the correct width for their types
|
* Note that the arguments must be of the correct width for their types
|
||||||
* specified in @format_string. This can be achieved by casting them. See
|
* specified in @format_string. This can be achieved by casting them. See
|
||||||
* the [GVariant varargs documentation][gvariant-varargs].
|
* the [GVariant varargs documentation](gvariant-format-strings.html#varargs).
|
||||||
*
|
*
|
||||||
* This function might be used as follows:
|
* This function might be used as follows:
|
||||||
*
|
*
|
||||||
|
@ -1112,7 +1112,7 @@ g_variant_lookup_value (GVariant *dictionary,
|
|||||||
*
|
*
|
||||||
* @element_size must be the size of a single element in the array,
|
* @element_size must be the size of a single element in the array,
|
||||||
* as given by the section on
|
* as given by the section on
|
||||||
* [serialized data memory][gvariant-serialized-data-memory].
|
* [serialized data memory](struct.Variant.html#serialized-data-memory).
|
||||||
*
|
*
|
||||||
* In particular, arrays of these fixed-sized types can be interpreted
|
* In particular, arrays of these fixed-sized types can be interpreted
|
||||||
* as an array of the given C type, with @element_size set to the size
|
* as an array of the given C type, with @element_size set to the size
|
||||||
@ -1258,7 +1258,7 @@ g_variant_new_fixed_array (const GVariantType *element_type,
|
|||||||
*
|
*
|
||||||
* @string must be valid UTF-8, and must not be %NULL. To encode
|
* @string must be valid UTF-8, and must not be %NULL. To encode
|
||||||
* potentially-%NULL strings, use g_variant_new() with `ms` as the
|
* potentially-%NULL strings, use g_variant_new() with `ms` as the
|
||||||
* [format string][gvariant-format-strings-maybe-types].
|
* [format string](gvariant-format-strings.html#maybe-types).
|
||||||
*
|
*
|
||||||
* Returns: (transfer none): a floating reference to a new string #GVariant instance
|
* Returns: (transfer none): a floating reference to a new string #GVariant instance
|
||||||
*
|
*
|
||||||
@ -2641,7 +2641,7 @@ g_variant_print_string (GVariant *value,
|
|||||||
*
|
*
|
||||||
* Pretty-prints @value in the format understood by g_variant_parse().
|
* Pretty-prints @value in the format understood by g_variant_parse().
|
||||||
*
|
*
|
||||||
* The format is described [here][gvariant-text].
|
* The format is described [here](gvariant-text-format.html).
|
||||||
*
|
*
|
||||||
* If @type_annotate is %TRUE, then type information is included in
|
* If @type_annotate is %TRUE, then type information is included in
|
||||||
* the output.
|
* the output.
|
||||||
@ -4361,7 +4361,7 @@ g_variant_dict_unref (GVariantDict *dict)
|
|||||||
* not be accessed and the effect is otherwise equivalent to if the
|
* not be accessed and the effect is otherwise equivalent to if the
|
||||||
* character at @limit were nul.
|
* character at @limit were nul.
|
||||||
*
|
*
|
||||||
* See the section on [GVariant format strings][gvariant-format-strings].
|
* See the section on [GVariant format strings](gvariant-format-strings.html).
|
||||||
*
|
*
|
||||||
* Returns: %TRUE if there was a valid format string
|
* Returns: %TRUE if there was a valid format string
|
||||||
*
|
*
|
||||||
@ -5376,7 +5376,7 @@ g_variant_valist_get (const gchar **str,
|
|||||||
*
|
*
|
||||||
* The type of the created instance and the arguments that are expected
|
* The type of the created instance and the arguments that are expected
|
||||||
* by this function are determined by @format_string. See the section on
|
* by this function are determined by @format_string. See the section on
|
||||||
* [GVariant format strings][gvariant-format-strings]. Please note that
|
* [GVariant format strings](gvariant-format-strings.html). Please note that
|
||||||
* the syntax of the format string is very likely to be extended in the
|
* the syntax of the format string is very likely to be extended in the
|
||||||
* future.
|
* future.
|
||||||
*
|
*
|
||||||
@ -5386,7 +5386,7 @@ g_variant_valist_get (const gchar **str,
|
|||||||
*
|
*
|
||||||
* Note that the arguments must be of the correct width for their types
|
* Note that the arguments must be of the correct width for their types
|
||||||
* specified in @format_string. This can be achieved by casting them. See
|
* specified in @format_string. This can be achieved by casting them. See
|
||||||
* the [GVariant varargs documentation][gvariant-varargs].
|
* the [GVariant varargs documentation](gvariant-format-strings.html#varargs).
|
||||||
*
|
*
|
||||||
* |[<!-- language="C" -->
|
* |[<!-- language="C" -->
|
||||||
* MyFlags some_flags = FLAG_ONE | FLAG_TWO;
|
* MyFlags some_flags = FLAG_ONE | FLAG_TWO;
|
||||||
@ -5447,7 +5447,7 @@ g_variant_new (const gchar *format_string,
|
|||||||
*
|
*
|
||||||
* Note that the arguments in @app must be of the correct width for their
|
* Note that the arguments in @app must be of the correct width for their
|
||||||
* types specified in @format_string when collected into the #va_list.
|
* types specified in @format_string when collected into the #va_list.
|
||||||
* See the [GVariant varargs documentation][gvariant-varargs].
|
* See the [GVariant varargs documentation](gvariant-format-strings.html#varargs).
|
||||||
*
|
*
|
||||||
* These two generalisations allow mixing of multiple calls to
|
* These two generalisations allow mixing of multiple calls to
|
||||||
* g_variant_new_va() and g_variant_get_va() within a single actual
|
* g_variant_new_va() and g_variant_get_va() within a single actual
|
||||||
@ -5503,7 +5503,7 @@ g_variant_new_va (const gchar *format_string,
|
|||||||
* determined by @format_string. @format_string also restricts the
|
* determined by @format_string. @format_string also restricts the
|
||||||
* permissible types of @value. It is an error to give a value with
|
* permissible types of @value. It is an error to give a value with
|
||||||
* an incompatible type. See the section on
|
* an incompatible type. See the section on
|
||||||
* [GVariant format strings][gvariant-format-strings].
|
* [GVariant format strings](gvariant-format-strings.html).
|
||||||
* Please note that the syntax of the format string is very likely to be
|
* Please note that the syntax of the format string is very likely to be
|
||||||
* extended in the future.
|
* extended in the future.
|
||||||
*
|
*
|
||||||
@ -5603,7 +5603,7 @@ g_variant_get_va (GVariant *value,
|
|||||||
*
|
*
|
||||||
* Note that the arguments must be of the correct width for their types
|
* Note that the arguments must be of the correct width for their types
|
||||||
* specified in @format_string. This can be achieved by casting them. See
|
* specified in @format_string. This can be achieved by casting them. See
|
||||||
* the [GVariant varargs documentation][gvariant-varargs].
|
* the [GVariant varargs documentation](gvariant-format-strings.html#varargs).
|
||||||
*
|
*
|
||||||
* This function might be used as follows:
|
* This function might be used as follows:
|
||||||
*
|
*
|
||||||
|
Loading…
Reference in New Issue
Block a user