luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-20 15:48:54 +02:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'gvariant-parse-detail' into 'main'

Browse Source 
gvariant-parser: Mention annotated types

See merge request GNOME/glib!3811
This commit is contained in:
Philip Withnall
2024-01-15 17:24:53 +00:00
parent 0c9fe8156a 13a2ea7dd8
commit 166f04a57f
1 changed files with 5 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
glib/gvariant-parser.c
View File

@@ -2476,7 +2476,7 @@ parse (TokenStream *stream,
* *
* A single #GVariant is parsed from the content of @text. * A single #GVariant is parsed from the content of @text.
* *
* The format is described [here][gvariant-text]. * The format is described [here](gvariant-text-format.html).
* *
* The memory at @limit will never be accessed and the parser behaves as * The memory at @limit will never be accessed and the parser behaves as
* if the character at @limit is the nul terminator. This has the * if the character at @limit is the nul terminator. This has the
@@ -2496,13 +2496,14 @@ parse (TokenStream *stream,
* *
* In the event that the parsing is successful, the resulting #GVariant * In the event that the parsing is successful, the resulting #GVariant
* is returned. It is never floating, and must be freed with * is returned. It is never floating, and must be freed with
* g_variant_unref(). * [method@GLib.Variant.unref].
* *
* In case of any error, %NULL will be returned. If @error is non-%NULL * In case of any error, %NULL will be returned. If @error is non-%NULL
* then it will be set to reflect the error that occurred. * then it will be set to reflect the error that occurred.
* *
* Officially, the language understood by the parser is "any string * Officially, the language understood by the parser is “any string
* produced by g_variant_print()". * produced by [method@GLib.Variant.print]”. This explicitly includes
* `g_variant_print()`’s annotated types like `int64 -1000`.
* *
* There may be implementation specific restrictions on deeply nested values, * There may be implementation specific restrictions on deeply nested values,
* which would result in a %G_VARIANT_PARSE_ERROR_RECURSION error. #GVariant is * which would result in a %G_VARIANT_PARSE_ERROR_RECURSION error. #GVariant is