fdo-mirrors/NetworkManager
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git synced 2026-01-09 03:00:20 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

glib-aux/trivial: add comment when nm_utils_buf_utf8safe_escape() returns NULL

Browse source
This commit is contained in:
Thomas Haller 2021-05-21 12:48:31 +02:00
parent 7c148b53ab
commit 41a6e40bb9
No known key found for this signature in database
GPG key ID: 29C2366E4DFC5728
1 changed files with 6 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
src/libnm-glib-aux/nm-shared-utils.c
View file

@ -2882,7 +2882,9 @@ nm_utils_buf_utf8safe_unescape(const char * str,
* nm_utils_buf_utf8safe_escape:
* @buf: byte array, possibly in utf-8 encoding, may have NUL characters.
* @buflen: the length of @buf in bytes, or -1 if @buf is a NUL terminated
* string.
* string. Note that if @buflen is zero, then the function returns NULL.
* If @buflen is negative, then the function returns NULL if @buf is NULL
* and @buf if @buf is "".
* @flags: #NMUtilsStrUtf8SafeFlags flags
* @to_free: (out): return the pointer location of the string
* if a copying was necessary.
@ -2908,6 +2910,9 @@ nm_utils_buf_utf8safe_unescape(const char * str,
* is necessary, it returns the input @buf. Otherwise, an allocated
* string @to_free is returned which must be freed by the caller
* with g_free. The escaping can be reverted by g_strcompress().
* There are cases where this function can return NULL:
* - if @buflen is 0
* - if @buflen is negative and @buf is NULL.
**/
const char *
nm_utils_buf_utf8safe_escape(gconstpointer buf,