diff options
Diffstat (limited to 'glib')
| -rw-r--r-- | glib/docs.c | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/glib/docs.c b/glib/docs.c index 9e5269236..93decb109 100644 --- a/glib/docs.c +++ b/glib/docs.c @@ -64,6 +64,15 @@ * A standard boolean type. * Variables of this type should only contain the value * %TRUE or %FALSE. + * + * Never directly compare the contents of a #gboolean variable with the values + * %TRUE or %FALSE. Use `if (condition)` to check a #gboolean is "true", instead + * of `if (condition == TRUE)`. Likewise use `if (!condition)` to check a + * #gboolean is "false". + * + * There is no validation when assigning to a #gboolean variable and so it could + * contain any value represented by a #gint. This is why the use of `if + * (condition)` is recommended. All non-zero values in C evaluate to "true". */ /** |