Searches the string haystack for the first occurrence
of the string needle, limiting the length of the search
to haystack_len or a nul terminator byte (whichever is reached first).
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.
Parameters
haystack: string
a string to search in
haystack_len: number
the maximum length of haystack in bytes, or -1 to search it entirely
needle: string
the string to search for
Returns string
a pointer to the found occurrence, or NULL if not found
Searches the string
haystackfor the first occurrence of the stringneedle, limiting the length of the search tohaystack_lenor a nul terminator byte (whichever is reached first).A length of
-1can be used to mean “search the entire string”, likestrstr().The fact that this function returns
gchar *rather thanconst gchar *is a historical artifact.