mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-10 19:36:18 +01:00
Convert GVariantType table to a list
This commit is contained in:
Matthias Clasen
parent
f04dbac47d
commit
38b1d63b24
@ -117,311 +117,53 @@
|
|||||||
* "a(aa(ui)(qna{ya(yd)}))".
|
* "a(aa(ui)(qna{ya(yd)}))".
|
||||||
*
|
*
|
||||||
* The meaning of each of the characters is as follows:
|
* The meaning of each of the characters is as follows:
|
||||||
* <informaltable>
|
* - `b`: the type string of %G_VARIANT_TYPE_BOOLEAN; a boolean value.
|
||||||
* <tgroup cols='2'>
|
* - `y`: the type string of %G_VARIANT_TYPE_BYTE; a byte.
|
||||||
* <tbody>
|
* - `n`: the type string of %G_VARIANT_TYPE_INT16; a signed 16 bit integer.
|
||||||
* <row>
|
* - `q`: the type string of %G_VARIANT_TYPE_UINT16; an unsigned 16 bit integer.
|
||||||
* <entry>
|
* - `i`: the type string of %G_VARIANT_TYPE_INT32; a signed 32 bit integer.
|
||||||
* <para>
|
* - `u`: the type string of %G_VARIANT_TYPE_UINT32; an unsigned 32 bit integer.
|
||||||
* <emphasis role='strong'>Character</emphasis>
|
* - `x`: the type string of %G_VARIANT_TYPE_INT64; a signed 64 bit integer.
|
||||||
* </para>
|
* - `t`: the type string of %G_VARIANT_TYPE_UINT64; an unsigned 64 bit integer.
|
||||||
* </entry>
|
* - `h`: the type string of %G_VARIANT_TYPE_HANDLE; a signed 32 bit value
|
||||||
* <entry>
|
* that, by convention, is used as an index into an array of file
|
||||||
* <para>
|
* descriptors that are sent alongside a D-Bus message.
|
||||||
* <emphasis role='strong'>Meaning</emphasis>
|
* - `d`: the type string of %G_VARIANT_TYPE_DOUBLE; a double precision
|
||||||
* </para>
|
* floating point value.
|
||||||
* </entry>
|
* - `s`: the type string of %G_VARIANT_TYPE_STRING; a string.
|
||||||
* </row>
|
* - `o`: the type string of %G_VARIANT_TYPE_OBJECT_PATH; a string in the form
|
||||||
* <row>
|
* of a D-Bus object path.
|
||||||
* <entry>
|
* - `g`: the type string of %G_VARIANT_TYPE_STRING; a string in the form of
|
||||||
* <para>
|
* a D-Bus type signature.
|
||||||
* b
|
* - `?`: the type string of %G_VARIANT_TYPE_BASIC; an indefinite type that
|
||||||
* </para>
|
* is a supertype of any of the basic types.
|
||||||
* </entry>
|
* - `v`: the type string of %G_VARIANT_TYPE_VARIANT; a container type that
|
||||||
* <entry>
|
* contain any other type of value.
|
||||||
* <para>
|
* - `a`: used as a prefix on another type string to mean an array of that
|
||||||
* the type string of %G_VARIANT_TYPE_BOOLEAN; a boolean value.
|
* type; the type string "ai", for example, is the type of an array of
|
||||||
* </para>
|
* signed 32-bit integers.
|
||||||
* </entry>
|
* - `m`: used as a prefix on another type string to mean a "maybe", or
|
||||||
* </row>
|
* "nullable", version of that type; the type string "ms", for example,
|
||||||
* <row>
|
* is the type of a value that maybe contains a string, or maybe contains
|
||||||
* <entry>
|
* nothing.
|
||||||
* <para>
|
* - `()`: used to enclose zero or more other concatenated type strings to
|
||||||
* y
|
* create a tuple type; the type string "(is)", for example, is the type of
|
||||||
* </para>
|
* a pair of an integer and a string.
|
||||||
* </entry>
|
* - `r`: the type string of %G_VARIANT_TYPE_TUPLE; an indefinite type that is
|
||||||
* <entry>
|
* a supertype of any tuple type, regardless of the number of items.
|
||||||
* <para>
|
* - `{}`: used to enclose a basic type string concatenated with another type
|
||||||
* the type string of %G_VARIANT_TYPE_BYTE; a byte.
|
* string to create a dictionary entry type, which usually appears inside of
|
||||||
* </para>
|
* an array to form a dictionary; the type string "a{sd}", for example, is
|
||||||
* </entry>
|
* the type of a dictionary that maps strings to double precision floating
|
||||||
* </row>
|
* point values.
|
||||||
* <row>
|
*
|
||||||
* <entry>
|
* The first type (the basic type) is the key type and the second type is
|
||||||
* <para>
|
* the value type. The reason that the first type is restricted to being a
|
||||||
* n
|
* basic type is so that it can easily be hashed.
|
||||||
* </para>
|
* - `*`: the type string of %G_VARIANT_TYPE_ANY; the indefinite type that is
|
||||||
* </entry>
|
* a supertype of all types. Note that, as with all type strings, this
|
||||||
* <entry>
|
* character represents exactly one type. It cannot be used inside of tuples
|
||||||
* <para>
|
* to mean "any number of items".
|
||||||
* the type string of %G_VARIANT_TYPE_INT16; a signed 16 bit
|
|
||||||
* integer.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* q
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_UINT16; an unsigned 16 bit
|
|
||||||
* integer.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* i
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_INT32; a signed 32 bit
|
|
||||||
* integer.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* u
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_UINT32; an unsigned 32 bit
|
|
||||||
* integer.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* x
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_INT64; a signed 64 bit
|
|
||||||
* integer.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* t
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_UINT64; an unsigned 64 bit
|
|
||||||
* integer.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* h
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_HANDLE; a signed 32 bit
|
|
||||||
* value that, by convention, is used as an index into an array
|
|
||||||
* of file descriptors that are sent alongside a D-Bus message.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* d
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_DOUBLE; a double precision
|
|
||||||
* floating point value.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* s
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_STRING; a string.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* o
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_OBJECT_PATH; a string in
|
|
||||||
* the form of a D-Bus object path.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* g
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_STRING; a string in the
|
|
||||||
* form of a D-Bus type signature.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* ?
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_BASIC; an indefinite type
|
|
||||||
* that is a supertype of any of the basic types.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* v
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_VARIANT; a container type
|
|
||||||
* that contain any other type of value.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* a
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* used as a prefix on another type string to mean an array of
|
|
||||||
* that type; the type string "ai", for example, is the type of
|
|
||||||
* an array of signed 32-bit integers.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* m
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* used as a prefix on another type string to mean a "maybe", or
|
|
||||||
* "nullable", version of that type; the type string "ms", for example,
|
|
||||||
* is the type of a value that maybe contains a string, or maybe
|
|
||||||
* contains nothing.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* ()
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* used to enclose zero or more other concatenated type strings
|
|
||||||
* to create a tuple type; the type string "(is)", for example,
|
|
||||||
* is the type of a pair of an integer and a string.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* r
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_TUPLE; an indefinite type
|
|
||||||
* that is a supertype of any tuple type, regardless of the
|
|
||||||
* number of items.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* {}
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* used to enclose a basic type string concatenated with another
|
|
||||||
* type string to create a dictionary entry type, which usually
|
|
||||||
* appears inside of an array to form a dictionary; the type
|
|
||||||
* string "a{sd}", for example, is the type of a dictionary that
|
|
||||||
* maps strings to double precision floating point values.
|
|
||||||
* </para>
|
|
||||||
* <para>
|
|
||||||
* The first type (the basic type) is the key type and the second
|
|
||||||
* type is the value type. The reason that the first type is
|
|
||||||
* restricted to being a basic type is so that it can easily be
|
|
||||||
* hashed.
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* <row>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* *
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* <entry>
|
|
||||||
* <para>
|
|
||||||
* the type string of %G_VARIANT_TYPE_ANY; the indefinite type
|
|
||||||
* that is a supertype of all types. Note that, as with all type
|
|
||||||
* strings, this character represents exactly one type. It
|
|
||||||
* cannot be used inside of tuples to mean "any number of items".
|
|
||||||
* </para>
|
|
||||||
* </entry>
|
|
||||||
* </row>
|
|
||||||
* </tbody>
|
|
||||||
* </tgroup>
|
|
||||||
* </informaltable>
|
|
||||||
*
|
*
|
||||||
* Any type string of a container that contains an indefinite type is,
|
* Any type string of a container that contains an indefinite type is,
|
||||||
* itself, an indefinite type. For example, the type string "a*"
|
* itself, an indefinite type. For example, the type string "a*"
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user