blob: e50c250240152d830147506c4e4e35f3d5bee074 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
.Dd January 27 2024
.Dt U8GNEXT 3
.Os
.Sh NAME
.Nm u8gnext ,
.Nd iterate over Unicode codepoints
.Sh LIBRARY
.Lb librune
.Sh SYNOPSIS
.In gbrk.h
.Ft size_t
.Fn u8gnext "struct u8view *v" "const char8_t **s" "size_t *n"
.Sh DESCRIPTION
The
.Fn u8gnext
function stores a view of the first grapheme in the buffer
.Fa s
of length
.Fa n
in the structure pointed to by
.Fa v .
It then updates
.Fa s
to point to the next grapheme in the buffer and also updates
.Fa n
accordingly.
.Pp
The
.Vt "struct u8view"
type is described in the
.Xr u8view 3
manual.
.Sh RETURN VALUES
The
.Fn u8gnext
function returns the length of the grapheme iterated over in bytes,
or 0 at the end of iteration.
.Sh EXAMPLES
The following calls to
.Fn u8gnext
iterate over and print all the graphemes in
.Va s .
.Bd -literal -offset indent
#define STRING u8"नमस्कार विश्व"
struct u8view v;
const char8_t *s = STRING;
size_t n = sizeof(STRING) - 1;
while (u8gnext(&v, &s, &n))
printf("‘%.*s’\en", (int)g.len, g.p);
.Ed
.Sh SEE ALSO
.Xr u8next 3 ,
.Xr u8view 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
.Pp
.Lk https://www.unicode.org/versions/Unicode15.1.0/ \
"The Unicode\(rg Standard Version 15.1.0"
.Sh AUTHORS
.An Thomas Voss Aq Mt mail@thomasvoss.com
|
