diff options
| author | Charles Forsyth <charles.forsyth@gmail.com> | 2013-06-08 09:00:50 +0000 |
|---|---|---|
| committer | Charles Forsyth <charles.forsyth@gmail.com> | 2013-06-08 09:00:50 +0000 |
| commit | b82549ec3500645cb6c8ff9d911d7c22ea451b98 (patch) | |
| tree | 3ccf075eafd210409a1f231b0ebd28cf22c671f4 | |
| parent | 1fe3d156aee5929de9347e2cb6f5140e80379814 (diff) | |
Rune/UTF changes
| -rw-r--r-- | man/10/rune | 39 |
1 files changed, 36 insertions, 3 deletions
diff --git a/man/10/rune b/man/10/rune index 8c3b6324..62574979 100644 --- a/man/10/rune +++ b/man/10/rune @@ -1,6 +1,6 @@ .TH RUNE 10.2 .SH NAME -runetochar, chartorune, runelen, fullrune, utflen, utfrune, utfrrune, utfutf \- rune/UTF conversion +runetochar, chartorune, runelen, runenlen, fullrune, utfecpy, utflen, utfnlen, utfrune, utfrrune, utfutf \- rune/UTF conversion .SH SYNOPSIS .ta \w'\fLchar*xx'u .PP @@ -14,12 +14,20 @@ int chartorune(Rune *r, char *s) int runelen(long r) .PP .B +int runenlen(Rune *r, int n) +.PP +.B int fullrune(char *s, int n) .PP .B +char* utfecpy(char *s1, char *es1, char *s2) +.PP +.B int utflen(char *s) .PP .B +int utfnlen(char *s, long n) +.PP char* utfrune(char *s, long c) .PP .B @@ -42,7 +50,7 @@ bytes starting at and returns the number of bytes copied. .BR UTFmax , defined as -.B 3 +.B 4 in .BR <libc.h> , is the maximum number of bytes required to represent a rune. @@ -59,7 +67,9 @@ If the input is not exactly in .SM UTF format, .I chartorune -will convert to 0x80 and return 1. +will convert to +.B Runeerror +(0xFFFD) and return 1. .PP .I Runelen returns the number of bytes @@ -68,6 +78,15 @@ required to convert into .SM UTF. .PP +.I Runenlen +returns the number of bytes +required to convert the +.I n +runes pointed to by +.I r +into +.SM UTF. +.PP .I Fullrune returns 1 if the string .I s @@ -102,6 +121,20 @@ are represented by the string .IR s . .PP +.I Utfnlen +returns the number of complete runes that +are represented by the first +.I n +bytes of +.SM UTF +string +.IR s . +If the last few bytes of the string contain an incompletely coded rune, +.I utfnlen +will not count them; in this way, it differs from +.IR utflen , +which includes every byte of the string. +.PP .I Utfrune .RI ( utfrrune ) returns a pointer to the first (last) |
