Function

GLibascii_strncasecmp

Declaration

gint
g_ascii_strncasecmp (
  const gchar* s1,
  const gchar* s2,
  gsize n
)

Description

Compare s1 and s2, ignoring the case of ASCII characters and any characters after the first n in each string. If either string is less than n bytes long, comparison will stop at the first nul byte encountered.

Unlike the BSD strncasecmp() function, this only recognizes standard ASCII letters and ignores the locale, treating all non-ASCII characters as if they are not letters.

The same warning as in g_ascii_strcasecmp() applies: Use this function only on strings known to be in encodings where bytes corresponding to ASCII letters always represent themselves.

Parameters

s1

Type: const gchar*

String to compare with s2

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
s2

Type: const gchar*

String to compare with s1

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
n

Type: gsize

Number of characters to compare.

Return value

Type: gint

0 if the strings match, a negative value if s1 < s2, or a positive value if s1 > s2