rune man page on Inferno

Man page or keyword search:  
man Server   579 pages
apropos Keyword Search (all sections)
Output format
Inferno logo
[printable version]

RUNE(10.2)							    RUNE(10.2)

NAME
       runetochar,  chartorune,	 runelen, runenlen, fullrune, utfecpy, utflen,
       utfnlen, utfrune, utfrrune, utfutf - rune/UTF conversion

SYNOPSIS
       int    runetochar(char *s, Rune *r)

       int    chartorune(Rune *r, char *s)

       int    runelen(long r)

       int    runenlen(Rune *r, int n)

       int    fullrune(char *s, int n)

       char*  utfecpy(char *s1, char *es1, char *s2)

       int    utflen(char *s)

       int    utfnlen(char *s, long n)

       char*  utfrune(char *s, long c)

       char*  utfrrune(char *s, long c)

       char*  utfutf(char *s1, char *s2)

DESCRIPTION
       These routines convert to and from a UTF byte stream and runes.

       Runetochar copies one rune at r to at most UTFmax bytes starting	 at  s
       and  returns  the  number  of  bytes  copied.   UTFmax, defined as 4 in
       <libc.h>, is the maximum number of bytes required to represent a rune.

       Chartorune copies at most UTFmax bytes starting at s to one rune	 at  r
       and returns the number of bytes copied.	If the input is not exactly in
       UTF format, chartorune will convert to Runeerror (0xFFFD) and return 1.

       Runelen returns the number of bytes required to convert r into UTF.

       Runenlen returns the number of bytes required to convert	 the  n	 runes
       pointed to by r into UTF.

       Fullrune	 returns  1  if	 the string s of length n is long enough to be
       decoded by chartorune and 0 otherwise.  This does  not  guarantee  that
       the string contains a legal UTF encoding.  This routine is used by pro‐
       grams that obtain input a byte at a time and need to know when  a  full
       rune has arrived.

       The  following  routines are analogous to the corresponding string rou‐
       tines with utf substituted for str and rune substituted for chr.

       Utflen returns the number of runes that	are  represented  by  the  UTF
       string s.

       Utfnlen	returns	 the  number of complete runes that are represented by
       the first n bytes of UTF string s.  If the last few bytes of the string
       contain	an  incompletely  coded	 rune, utfnlen will not count them; in
       this way, it differs from utflen, which	includes  every	 byte  of  the
       string.

       Utfrune	(utfrrune) returns a pointer to the first (last) occurrence of
       rune c in the UTF string s, or 0 if c does not  occur  in  the  string.
       The  NUL	 byte  terminating  a  string  is considered to be part of the
       string s.

       Utfutf returns a pointer to the first occurrence of the UTF  string  s2
       as  a  UTF  substring  of s1, or 0 if there is none.  If s2 is the null
       string, utfutf returns s1.

SOURCE
       /libkern/rune.c
       /libkern/runestrlen.c
       /libkern/utflen.c
       /libkern/utfrrune.c
       /libkern/utfrune.c

SEE ALSO
       convcs(2), utf(6)

								    RUNE(10.2)
[top]

List of man pages available for Inferno

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net