SDL_wcsnstr3
Search a wide string, up to n wide chars, for the first instance of a specific substring.
Usage
#include "SDL3/SDL.h"
wchar_t * SDL_wcsnstr(const wchar_t *haystack, const wchar_t *needle, size_t maxlen);
Header file
Defined in SDL3/SDL_stdinc.h
Overview
The search ends once it finds the requested substring, or a null terminator value to end the string, or maxlen wide character have been examined. It is possible to use this function on a wide string without a null terminator.
Note that this looks for strings of _wide characters_, not _codepoints_, so it's legal to search for malformed and incomplete UTF-16 sequences.
Function parameters
haystack
|
the wide string to search. Must not be NULL. |
|---|---|
needle
|
the wide string to search for. Must not be NULL. |
maxlen
|
the maximum number of wide characters to search in |
Return value
Returns a pointer to the first instance of needle in the string, or NULL if not found.
Thread safety
It is safe to call this function from any thread.