SDL_wcscmp(3)

SDL_wcscmp3

Compare two null-terminated wide strings.

Usage

#include "SDL3/SDL.h"

int SDL_wcscmp(const wchar_t *str1, const wchar_t *str2);

Header file

Defined in SDL3/SDL_stdinc.h

Overview

This only compares wchar_t values until it hits a null-terminating character; it does not care if the string is well-formed UTF-16 (or UTF-32, depending on your platform's wchar_t size), or uses valid Unicode values.

Function parameters

str1

the first string to compare. NULL is not permitted!

str2

the second string to compare. NULL is not permitted!

Return value

Returns less than zero if str1 is "less than" str2, greater than zero if str1 is "greater than" str2, and zero if the strings match exactly.

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.