diff options
author | Thomas Voss <mail@thomasvoss.com> | 2024-10-30 01:51:14 +0100 |
---|---|---|
committer | Thomas Voss <mail@thomasvoss.com> | 2024-10-30 01:51:14 +0100 |
commit | 042e43247f396a9000fead59d9bff87bf12806d6 (patch) | |
tree | e902784464cbe9ce3c5114d513b016523e7e4b29 /vendor/librune/man/u8wdth.3 | |
parent | 170b8a92434233241c990c3e9432786de3262bcd (diff) |
Completely revamp the grab source code
Some of the (many) few changes are:
- Multithreading for significantly faster performance
- The -p/--predicate flag
- Byte offsets as the default
- No customizable colors (maybe this will come back later)
- Newer edition of mlib (formerly librune)
Diffstat (limited to 'vendor/librune/man/u8wdth.3')
-rw-r--r-- | vendor/librune/man/u8wdth.3 | 69 |
1 files changed, 0 insertions, 69 deletions
diff --git a/vendor/librune/man/u8wdth.3 b/vendor/librune/man/u8wdth.3 deleted file mode 100644 index 60fcada..0000000 --- a/vendor/librune/man/u8wdth.3 +++ /dev/null @@ -1,69 +0,0 @@ -.Dd January 16 2024 -.Dt U8WDTH 3 -.Os -.Sh NAME -.Nm u8wdth -.Nd Unicode codepoint width -.Sh LIBRARY -.Lb librune -.Sh SYNOPSIS -.In utf8.h -.Ft int -.Fn u8wdth "rune ch" -.Sh DESCRIPTION -The -.Fn u8wdth -function returns the number of bytes that would be occupied by the -Unicode-codepoint -.Fa ch -if it was encoded as UTF-8. -If -.Fa ch -is greater than -.Dv RUNE_MAX , -a width of 0 is returned. -.Pp -If the exact UTF-8 encoded size of a codepoint is not relevant and you -simply wish to allocate a buffer capable of holding a given number of -UTF-8 codepoints, -the -.Dv U8_LEN_MAX -macro may be preferable. -.Pp -This function treats invalid codepoints smaller than -.Dv RUNE_MAX -such as UTF-16 surrogates as valid. -.Sh RETURN VALUES -The -.Fn u8wdth -function returns the number of bytes required to UTF-8 encode the -codepoint -.Fa ch . -.Sh EXAMPLES -The following example allocates a buffer which is exactly large enough to -hold the given UTF-32 string once it is converted to UTF-8. -.Bd -literal -offset indent -#define lengthof(a) (sizeof(a) / sizeof(*(a))) - -size_t bufsiz = 0; -char8_t *buf; -char32_t s[] = U\(dqIJsselmeer\(dq; /* ‘IJ’ takes 2 bytes */ - -for (size_t i = 0; i < lengthof(s) - 1; i++) - bufsiz += u8wdth(s[i]); -buf = malloc(bufsiz); -.Ed -.Sh SEE ALSO -.Xr u8glen 3 , -.Xr u8len 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 |