need_uconvert

Section: Allegro manual (3)
Updated: version 4.2.2
Index Return to Main Contents
 

NAME

need_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 conversion 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 parameters, 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 ALSO

set_uformat(3), get_uformat(3), do_uconvert(3), uconvert(3)