GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
FGETU8(3) FreeBSD Library Functions Manual FGETU8(3)

fgetu8
utf-8 library function manual page

#include <utf-8.h>

unsigned int
fgetu8(FILE *input);

unsigned int
utf8fgetc(FILE *input);

unsigned int
utf8getc(FILE *input);

unsigned int
utf8getchar();

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.

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⟩.

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.

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

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

This manual page was written by G. Adam Stanislav ⟨adam@whizkidtech.net⟩.

None known.
April 1, 1999 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.