Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual page 496

Functions Related to UTF-8
Syntax
#include "slapi-plugin.h"
int slapi_UTF8NCASECMP(char *s0, char *s1, int n);
Parameters
This function takes the following parameters:
s0
s1
n
Returns
This function returns one of the following values:
• A positive number if
•
0
• A negative number if
Description
This function has the following rules:
• If both UTF-8 strings are NULL or zero-length,
• If one of the strings is NULL or zero-length, the NULL/zero-length string is
smaller.
• If one or both of the strings are not UTF-8, system provided
used.
• If one of the two strings contains no 8-bit characters,
• The strings are compared after they are converted to lower-case UTF-8.
• Each character is compared from the beginning.
Evaluation occurs in this order:
• If the length of one character is shorter then the other, the difference of the
two lengths is returned.
• If the length of the corresponding characters is the same, each byte in the
characters is compared.
496 Netscape Directory Server Plug-in Programmer's Guide • October 2004
A null-terminated UTF-8 string.
A null-terminated UTF-8 string.
The number of UTF-8 characters (not bytes) from s0 and s1 to
compare.
s0
if the two string are identical, ignoring case.
s1
is after .
s1
is after .
s0
is returned.
0
strcasecmp
is used.
strcasecmp
is