DragonFly On-Line Manual Pages

Search: Section:  

FPUTU8(3)             DragonFly Library Functions Manual             FPUTU8(3)


NAME

     fputu8 - utf-8 library function manual page


SYNOPSIS

     #include <utf-8.h>

     int
     fputu8(unsigned int c, FILE *output);

     int
     utf8fputc(unsigned int c, FILE *output);

     int
     utf8putc(unsigned int c, FILE *output);

     int
     utf8putchar(unsigned int c);


DESCRIPTION

     The fputu8() function of utf-8 library converts a UTC-4 (31-bit Unicode)
     integer to one or more bytes representing its UTF-8 value, and writes the
     result to a file.

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

     The fputu8() function and the macros take two arguments: c, the UTC-4
     code, and input, which can be any open file.

     The utf8putchar() macro sends output to stdout.


RETURN VALUES

     fputu8() returns 0 on success; EOF if output is NULL or cannot be written
     to; 1 if c is not a valid UTC-4 code (i.e., its high bit is set).


SEE ALSO

     libutf-8(3), fgetu8(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.


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: