BSD 4_4 development
[unix-history] / usr / share / man / cat3 / mbrune.0
MBRUNE(3) BSD Programmer's Manual MBRUNE(3)
N\bNA\bAM\bME\bE
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
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<r\bru\bun\bne\be.\b.h\bh>\b>
_\bc_\bh_\ba_\br _\b*
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);
_\bc_\bh_\ba_\br _\b*
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);
_\bc_\bh_\ba_\br _\b*
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);
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
These routines provide the corresponding functionality of s\bst\btr\brc\bch\bhr\br(),
s\bst\btr\brr\brc\bch\bhr\br() and s\bst\btr\brs\bst\btr\br() for multibyte strings.
The m\bmb\bbr\bru\bun\bne\be() function locates the first occurence of r\bru\bun\bne\be() in the string
pointed to by _\bs_\bt_\br_\bi_\bn_\bg. The terminating NULL character is considered part
of the string. If _\br_\bu_\bn_\be is `\0', m\bmb\bbr\bru\bun\bne\be() locates the terminating `\0'.
The m\bmb\bbr\brr\bru\bun\bne\be() function locates the last occurrence of _\br_\bu_\bn_\be in the string
_\bs_\bt_\br_\bi_\bn_\bg. If _\br_\bu_\bn_\be is `\0', m\bmb\bbr\bru\bun\bne\be() locates the terminating `\0'.
The m\bmb\bbm\bmb\bb() function locates the first occurence of the null-terminated
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
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,
m\bmb\bbm\bmb\bb() returns NULL; otherwise m\bmb\bbm\bmb\bb() returns a pointer to the first
character of the first occurrence of _\bp_\ba_\bt_\bt_\be_\br_\bn.
R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
The function m\bmb\bbr\bru\bun\bne\be() returns a pointer to the located character, or NULL
if the character does not appear in the string.
The m\bmb\bbr\brr\bru\bun\bne\be() function returns a pointer to the character, or NULL if the
character does not appear in the string.
The m\bmb\bbm\bmb\bb() function returns a pointer to the _\bp_\ba_\bt_\bt_\be_\br_\bn, or NULL if the
_\bp_\ba_\bt_\bt_\be_\br_\bn does not appear in the string.
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
euc(4), mbrune(3), rune(3), setlocale(3), utf2(4)
H\bHI\bIS\bST\bTO\bOR\bRY\bY
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
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().
4.4BSD June 4, 1993 1