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 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 se-
       lected. 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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

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

home | help