summaryrefslogtreecommitdiff
path: root/gir/glib-2.0.c
diff options
context:
space:
mode:
authorChristoph Reiter <reiter.christoph@gmail.com>2018-12-16 16:02:33 +0100
committerChristoph Reiter <reiter.christoph@gmail.com>2018-12-16 16:04:36 +0100
commit45899ed068735afb9a6a59629e85f7c022073d9e (patch)
tree89b5d846c6a271b79fb9a8580af2b37c43f04362 /gir/glib-2.0.c
parent84dd0eb1de964d570e05debda4ee93055451a149 (diff)
downloadgobject-introspection-45899ed068735afb9a6a59629e85f7c022073d9e.tar.gz
Update glib annotations
Diffstat (limited to 'gir/glib-2.0.c')
-rw-r--r--gir/glib-2.0.c8
1 files changed, 7 insertions, 1 deletions
diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c
index 43fc6ef7..c70f2746 100644
--- a/gir/glib-2.0.c
+++ b/gir/glib-2.0.c
@@ -9838,7 +9838,8 @@
* @base that is within inclusive bounds limited by @min and @max. If
* this is true, then the converted number is stored in @out_num. An
* empty string is not a valid input. A string with leading or
- * trailing whitespace is also an invalid input.
+ * trailing whitespace is also an invalid input. A string with a leading sign
+ * (`-` or `+`) is not a valid input for the unsigned parser.
*
* @base can be between 2 and 36 inclusive. Hexadecimal numbers must
* not be prefixed with "0x" or "0X". Such a problem does not exist
@@ -9958,6 +9959,11 @@
* changing the current locale, since that would not be
* thread-safe.
*
+ * Note that input with a leading minus sign (`-`) is accepted, and will return
+ * the negation of the parsed number, unless that would overflow a #guint64.
+ * Critically, this means you cannot assume that a short fixed length input will
+ * never result in a low return value, as the input could have a leading `-`.
+ *
* This function is typically used when reading configuration
* files or other non-user input that should be locale independent.
* To handle input from the user you should normally use the