devela::_dep::sdl3::sys::stdinc

Function SDL_wcsnstr

pub unsafe extern "C" fn SDL_wcsnstr(
    haystack: *const u32,
    needle: *const u32,
    maxlen: usize,
) -> *mut u32
Available on crate feature dep_sdl3 only.
Expand description

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

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.

§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 haystack.

§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.