Merge branch 'utf16-to-utf8-docs' into 'main'

gutf8: Document that out args from g_utf16_to_utf8() are non-negative

See merge request GNOME/glib!2295
This commit is contained in:
Philip Withnall 2021-10-18 11:58:54 +00:00
commit 68295cb2fb

View File

@ -987,9 +987,10 @@ g_ucs4_to_utf8 (const gunichar *str,
* words read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will
* be returned in case @str contains a trailing partial character. If
* an error occurs then the index of the invalid input is stored here.
* Its guaranteed to be non-negative.
* @items_written: (out) (optional): location to store number
* of bytes written, or %NULL. The value stored here does not include the
* trailing 0 byte.
* trailing 0 byte. Its guaranteed to be non-negative.
* @error: location to store the error occurring, or %NULL to ignore
* errors. Any of the errors in #GConvertError other than
* %G_CONVERT_ERROR_NO_CONVERSION may occur.