logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_wcsncmp - Compare two wide strings up to a number of wchar_t values.

Availability

       This function is available since SDL 3.2.0.

Simple Directmedia Layer                           SDL 3.2.20                                     SDL_wcsncmp(3)

Description

       This  only  compares  wchar_t  values;  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.

       Note that while this function is intended to be used with UTF-16 (or UTF-32, depending on your platform's
       definition of wchar_t), it is comparing raw wchar_t values and not Unicode codepoints: maxlen specifies a
       wchar_t limit! If the limit lands in the middle of a multi-wchar UTF-16 sequence, it will only compare  a
       portion of the final character.

       maxlen  specifies  a  maximum  number  of wchar_t to compare; if the strings match to this number of wide
       chars (or both have matched to a null-terminator character before this count), they  will  be  considered
       equal.

Function Parameters

str1   the first string to compare. NULL is not permitted!

       str2   the second string to compare. NULL is not permitted!

       maxlen the maximum number of wchar_t to compare.

Name

       SDL_wcsncmp - Compare two wide strings up to a number of wchar_t values.

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.

Synopsis

#include<SDL3/SDL_stdinc.h>intSDL_wcsncmp(constwchar_t*str1,constwchar_t*str2,size_tmaxlen);

Thread Safety

       It is safe to call this function from any thread.

See Also