BSD 4_4 development
[unix-history] / usr / share / man / cat3 / mbrune.0
CommitLineData
8bb980a3
C
1MBRUNE(3) BSD Programmer's Manual MBRUNE(3)
2
3N\bNA\bAM\bME\bE
4 m\bmb\bbr\bru\bun\bne\be, m\bmb\bbr\brr\bru\bun\bne\be, m\bmb\bbm\bmb\bb - multibyte rune support for C
5
6S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
7 #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<r\bru\bun\bne\be.\b.h\bh>\b>
8
9 _\bc_\bh_\ba_\br _\b*
10 m\bmb\bbr\bru\bun\bne\be(_\bc_\bo_\bn_\bs_\bt _\bc_\bh_\ba_\br _\b*_\bs_\bt_\br_\bi_\bn_\bg, _\br_\bu_\bn_\be_\b__\bt _\br_\bu_\bn_\be);
11
12 _\bc_\bh_\ba_\br _\b*
13 m\bmb\bbr\brr\bru\bun\bne\be(_\bc_\bo_\bn_\bs_\bt _\bc_\bh_\ba_\br _\b*_\bs_\bt_\br_\bi_\bn_\bg, _\br_\bu_\bn_\be_\b__\bt _\br_\bu_\bn_\be);
14
15 _\bc_\bh_\ba_\br _\b*
16 m\bmb\bbm\bmb\bb(_\bc_\bo_\bn_\bs_\bt _\bc_\bh_\ba_\br _\b*_\bs_\bt_\br_\bi_\bn_\bg, _\bc_\bh_\ba_\br _\b*_\bp_\ba_\bt_\bt_\be_\br_\bn);
17
18D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
19 These routines provide the corresponding functionality of s\bst\btr\brc\bch\bhr\br(),
20 s\bst\btr\brr\brc\bch\bhr\br() and s\bst\btr\brs\bst\btr\br() for multibyte strings.
21
22 The m\bmb\bbr\bru\bun\bne\be() function locates the first occurence of r\bru\bun\bne\be() in the string
23 pointed to by _\bs_\bt_\br_\bi_\bn_\bg. The terminating NULL character is considered part
24 of the string. If _\br_\bu_\bn_\be is `\0', m\bmb\bbr\bru\bun\bne\be() locates the terminating `\0'.
25
26 The m\bmb\bbr\brr\bru\bun\bne\be() function locates the last occurrence of _\br_\bu_\bn_\be in the string
27 _\bs_\bt_\br_\bi_\bn_\bg. If _\br_\bu_\bn_\be is `\0', m\bmb\bbr\bru\bun\bne\be() locates the terminating `\0'.
28
29 The m\bmb\bbm\bmb\bb() function locates the first occurence of the null-terminated
30 string _\bp_\ba_\bt_\bt_\be_\br_\bn in the null-terminated string _\bs_\bt_\br_\bi_\bn_\bg_\b. If _\bp_\ba_\bt_\bt_\be_\br_\bn is the
31 empty string, m\bmb\bbm\bmb\bb() returns _\bs_\bt_\br_\bi_\bn_\bg; if _\bp_\ba_\bt_\bt_\be_\br_\bn occurs nowhere in _\bs_\bt_\br_\bi_\bn_\bg,
32 m\bmb\bbm\bmb\bb() returns NULL; otherwise m\bmb\bbm\bmb\bb() returns a pointer to the first
33 character of the first occurrence of _\bp_\ba_\bt_\bt_\be_\br_\bn.
34
35R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
36 The function m\bmb\bbr\bru\bun\bne\be() returns a pointer to the located character, or NULL
37 if the character does not appear in the string.
38
39 The m\bmb\bbr\brr\bru\bun\bne\be() function returns a pointer to the character, or NULL if the
40 character does not appear in the string.
41
42 The m\bmb\bbm\bmb\bb() function returns a pointer to the _\bp_\ba_\bt_\bt_\be_\br_\bn, or NULL if the
43 _\bp_\ba_\bt_\bt_\be_\br_\bn does not appear in the string.
44
45S\bSE\bEE\bE A\bAL\bLS\bSO\bO
46 euc(4), mbrune(3), rune(3), setlocale(3), utf2(4)
47
48H\bHI\bIS\bST\bTO\bOR\bRY\bY
49 The m\bmb\bbr\bru\bun\bne\be(), m\bmb\bbr\brr\bru\bun\bne\be(), and m\bmb\bbm\bmb\bb() functions first appeared in Plan 9
50 from Bell Labs as u\but\btf\bfr\bru\bun\bne\be(), u\but\btf\bfr\brr\bru\bun\bne\be(), and u\but\btf\bfu\but\btf\bf().
51
524.4BSD June 4, 1993 1