unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.4BSD-Lite2)
Page:
Section:
Apropos / Subsearch:
optional field

MBRUNE(3)                   BSD Programmer's Manual                  MBRUNE(3)

NAME
     mbrune, mbrrune, mbmb - multibyte rune support for C

SYNOPSIS
     #include <&lt;rune.h>&gt;

     char *
     mbrune(const char *string, rune_t rune);

     char *
     mbrrune(const char *string, rune_t rune);

     char *
     mbmb(const char *string, char *pattern);

DESCRIPTION
     These routines provide the corresponding functionality of strchr(),
     strrchr() and strstr() for multibyte strings.

     The mbrune() function locates the first occurrence of rune() in the
     string pointed to by string. The terminating NULL character is considered
     part of the string.  If rune is `\0', mbrune() locates the terminating
     `\0'.

     The mbrrune() function locates the last occurrence of rune in the string
     string. If rune is `\0', mbrune() locates the terminating `\0'.

     The mbmb() function locates the first occurrence of the null-terminated
     string pattern in the null-terminated string string. If pattern is the
     empty string, mbmb() returns string; if pattern occurs nowhere in string,
     mbmb() returns NULL; otherwise mbmb() returns a pointer to the first
     character of the first occurrence of pattern.

RETURN VALUES
     The function mbrune() returns a pointer to the located character, or NULL
     if the character does not appear in the string.

     The mbrrune() function returns a pointer to the character, or NULL if the
     character does not appear in the string.

     The mbmb() function returns a pointer to the pattern, or NULL if the
     pattern does not appear in the string.

SEE ALSO
     euc(4),  mbrune(3),  rune(3),  setlocale(3),  utf2(4)

HISTORY
     The mbrune(), mbrrune(), and mbmb() functions first appeared in Plan 9
     from Bell Labs as utfrune(), utfrrune(), and utfutf().

4.4BSD                          April 19, 1994                               1