gstrfuncs: Mention slightly odd return types in docs

See the previous commit for details.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
Helps: #3286
This commit is contained in:
Philip Withnall 2024-03-13 15:06:34 +00:00
parent 6c3ad23634
commit e0c18a2f04

View File

@ -2732,6 +2732,9 @@ g_strjoin (const gchar *separator,
* A length of `-1` can be used to mean search the entire string, like
* `strstr()`.
*
* The fact that this function returns `gchar *` rather than `const gchar *` is
* a historical artifact.
*
* Returns: (transfer none) (nullable): a pointer to the found occurrence, or
* `NULL` if not found
*/
@ -2785,6 +2788,9 @@ g_strstr_len (const gchar *haystack,
* Searches the string @haystack for the last occurrence
* of the string @needle.
*
* The fact that this function returns `gchar *` rather than `const gchar *` is
* a historical artifact.
*
* Returns: (transfer none) (nullable): a pointer to the found occurrence, or
* `NULL` if not found
*/
@ -2837,6 +2843,9 @@ g_strrstr (const gchar *haystack,
* of the string @needle, limiting the length of the search
* to @haystack_len.
*
* The fact that this function returns `gchar *` rather than `const gchar *` is
* a historical artifact.
*
* Returns: (transfer none) (nullable): a pointer to the found occurrence, or
* `NULL` if not found
*/