diff options
Diffstat (limited to 'vendor/librune/man/u8len.3')
-rw-r--r-- | vendor/librune/man/u8len.3 | 70 |
1 files changed, 0 insertions, 70 deletions
diff --git a/vendor/librune/man/u8len.3 b/vendor/librune/man/u8len.3 deleted file mode 100644 index 4e58e14..0000000 --- a/vendor/librune/man/u8len.3 +++ /dev/null @@ -1,70 +0,0 @@ -.Dd January 15 2024 -.Dt U8LEN 3 -.Os -.Sh NAME -.Nm u8len -.Nd count Unicode codepoints -.Sh LIBRARY -.Lb librune -.Sh SYNOPSIS -.In utf8.h -.Ft size_t -.Fn u8len "const char8_t *s" "size_t n" -.Sh DESCRIPTION -The -.Fn u8len -function returns the number of UTF-8 encoded Unicode codepoints in the -buffer -.Fa s -of length -.Fa n -bytes. -.Pp -This function assumes that -.Fa s -contains only valid UTF-8. -.Sh RETURN VALUES -The -.Fn u8len -function returns the number of codepoints in the buffer -.Fa s . -.Sh EXAMPLES -The following call to -.Fn u8len -will return 17 while the call to -.Fn strlen -will return 22 as a result of use of multibyte-characters in -.Fa s . -.Bd -literal -offset indent -char8_t s[] = u8\(dq„Der Große Duden“\(dq; -size_t blen, cplen; - -blen = strlen((char *)s); -cplen = u8len(s, sizeof(s) - 1); -.Ed -.Sh SEE ALSO -.Xr u8glen 3 , -.Xr u8wdth 3 , -.Xr unicode 7 , -.Xr utf\-8 7 -.Sh STANDARDS -.Rs -.%A F. Yergeau -.%D November 2003 -.%R RFC 3629 -.%T UTF-8, a transformation format of ISO 10646 -.Re -.Sh AUTHORS -.An Thomas Voss Aq Mt mail@thomasvoss.com -.Sh CAVEATS -The return value of -.Fn u8len -does not necessarily represent the number of human-preceived characters -in the given buffer; -multiple codepoints may combine to form one human-preceived character -that spans a single column. -To count user-preceived codepoints -.Pq also known as graphemes , -you may want to use the -.Xr u8glen 3 -function. |