(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_wcsnstr

Search a wide string, up to n wide chars, for the first instance of a specific substring.

Header File

Defined in <SDL3/SDL_stdinc.h>

Syntax

wchar_t * SDL_wcsnstr(const wchar_t *haystack, const wchar_t *needle, size_t maxlen);

Function Parameters

const wchar_t *	haystack	the wide string to search. Must not be NULL.
const wchar_t *	needle	the wide string to search for. Must not be NULL.
size_t	maxlen	the maximum number of wide characters to search in haystack.

Return Value

(wchar_t *) Returns a pointer to the first instance of needle in the string, or NULL if not found.

Remarks

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.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.1.3.

---

CategoryAPI, CategoryAPIFunction, CategoryStdinc

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.