DragonFly On-Line Manual Pages

Search: Section:  

FGETU8(3)             DragonFly Library Functions Manual             FGETU8(3)


NAME

     fgetu8 - utf-8 library function manual page


SYNOPSIS

     #include <utf-8.h>

     unsigned int
     fgetu8(FILE *input);

     unsigned int
     utf8fgetc(FILE *input);

     unsigned int
     utf8getc(FILE *input);

     unsigned int
     utf8getchar();


DESCRIPTION

     The fgetu8() function of utf-8 library reads one or more bytes from a
     UTF-8 formatted text file, and converts them to single UTC-4 (Unicode)
     value.

     utf8fgetc() and utfgetc() are macros which simply give fgetu8() a name
     that may be more convenient to remember. They are defined in <utf-8.h>.

     The fgetu8() function and the macros take one argument: input, which can
     be any open file.

     The utf8getchar() macro reads input from stdin.


RETURN VALUES

     If input is NULL, or if a premature end-of-file condition occurs,
     fgetu8() returns EOF.  If input contains valid UTF-8 codes, fgetu8()
     returns the converted UTC-4 value. Otherwise, it returns UTF8INVALID,
     defined in <utf-8.h>.


SEE ALSO

     libutf-8(3), fputu8(3), sgetu8(3), sputu8(3)

     F. Yergeau, UTF-8, a transformation format of Unicode and ISO 10646,
     RFC2044.

     D. Goldsmith, M. Davis, Using Unicode with MIME, RFC1641.


STANDARDS

     ISO 10646-1: 1993 (``Unicode''), RFC 2044: 1996 (``UTF-8''), ANSI
     X3.159-1989 ("ANSI C89").


DIAGNOSTICS

     You should always check the RETURN VALUES against EOF and UTF8INVALID.


AUTHORS

     This manual page was written by G. Adam Stanislav <adam@whizkidtech.net>.


BUGS

     None known.

DragonFly 6.5-DEVELOPMENT        April 1, 1999       DragonFly 6.5-DEVELOPMENT

Search: Section: