Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
need_uconvert(3)		 Allegro manual 		need_uconvert(3)

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  en-
     coding 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)

Allegro 			  version 4.4.3 		need_uconvert(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=need_uconvert&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help