need_uconvert(3) Allegro manual need_uconvert(3)NAMEneed_uconvert - Tells if a string requires encoding conversion. Allegro
game programming library.
SYNOPSIS
#include <allegro.h>
int need_uconvert(const char *s, int type, int newtype);
DESCRIPTION
Given a pointer to a string (`s'), a description of the type of the
string (`type'), and the type that you would like this string to be
converted into (`newtype'), this function tells you whether any conver‐
sion is required. No conversion will be needed if `type' and `newtype'
are the same, or if one type is ASCII, the other is UTF-8, and the
string contains only character values less than 128. As a convenience
shortcut, you can pass the value U_CURRENT as either of the type param‐
eters, to represent whatever text encoding format is currently
selected. Example:
if (need_uconvert(text, U_UTF8, U_CURRENT)) {
/* conversion is required */
}
RETURN VALUE
Returns non-zero if any conversion is required or zero otherwise.
SEE ALSOset_uformat(3), get_uformat(3), do_uconvert(3), uconvert(3)Allegro version 4.4.2 need_uconvert(3)
