SDL_wcsstr(3)

SDL_wcsstr3

Search a wide string for the first instance of a specific substring.

Usage

#include "SDL3/SDL.h"

wchar_t * SDL_wcsstr(const wchar_t *haystack, const wchar_t *needle);

Header file

Defined in SDL3/SDL_stdinc.h

Overview

The search ends once it finds the requested substring, or a null terminator byte to end the string.

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.

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.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.