luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-23 16:10:03 +01:00
Code Issues Packages Projects Releases Wiki Activity

Improve g_ascii_formatd docs and preconditions

Browse Source
This commit is contained in:
Matthias Clasen 2022-01-19 00:14:55 +00:00 committed by Philip Withnall
parent 185e0565e0
commit 6749b343fe
1 changed files with 8 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
glib/gstrfuncs.c
View File

@ -927,7 +927,7 @@ g_ascii_dtostr (gchar *buffer,
* @buffer: A buffer to place the resulting string in * @buffer: A buffer to place the resulting string in
* @buf_len: The length of the buffer. * @buf_len: The length of the buffer.
* @format: The printf()-style format to use for the * @format: The printf()-style format to use for the
* code to use for converting. * code to use for converting
* @d: The #gdouble to convert * @d: The #gdouble to convert
* *
* Converts a #gdouble to a string, using the '.' as * Converts a #gdouble to a string, using the '.' as
@ -935,6 +935,9 @@ g_ascii_dtostr (gchar *buffer,
* a printf()-style format string. Allowed conversion * a printf()-style format string. Allowed conversion
* specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'. * specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'.
* *
* The @format must just be a single format specifier
* starting with `%`, expecting a #gdouble argument.
*
* The returned buffer is guaranteed to be nul-terminated. * The returned buffer is guaranteed to be nul-terminated.
* *
* If you just want to want to serialize the value into a * If you just want to want to serialize the value into a
@ -951,6 +954,10 @@ g_ascii_formatd (gchar *buffer,
#ifdef USE_XLOCALE #ifdef USE_XLOCALE
locale_t old_locale; locale_t old_locale;
g_return_val_if_fail (buffer != NULL, NULL);
g_return_val_if_fail (format[0] == '%', NULL);
g_return_val_if_fail (strpbrk (format + 1, "'l%") == NULL, NULL);
old_locale = uselocale (get_C_locale ()); old_locale = uselocale (get_C_locale ());
_g_snprintf (buffer, buf_len, format, d); _g_snprintf (buffer, buf_len, format, d);
uselocale (old_locale); uselocale (old_locale);