Case-insensitive compare of two UCS-4 strings.
Defined in <physfs.h>
int PHYSFS_ucs4stricmp(const PHYSFS_uint32 *str1, const PHYSFS_uint32 *str2);| const PHYSFS_uint32 * | str1 | First string to compare. |
| const PHYSFS_uint32 * | str2 | Second string to compare. |
(int) Returns -1 if str1 is "less than" str2, 1 if "greater than", 0 if equal.
This is a strcasecmp/stricmp replacement that expects both strings to be in UCS-4 (aka UTF-32) encoding. It will do "case folding" to decide if the Unicode codepoints in the strings match.
It will report which string is "greater than" the other, but be aware that this doesn't necessarily mean anything: 'a' may be "less than" 'b', but a Japanese kuten has no meaningful alphabetically relationship to a Greek lambda, but being able to assign a reliable "value" makes sorting algorithms possible, if not entirely sane. Most cases should treat the return value as "equal" or "not equal".
Like stricmp, this expects both strings to be NULL-terminated.
It is safe to call this function from any thread.
This function is available since PhysicsFS 2.1.0.