MBRUNE(3) BSD Library Functions Manual MBRUNE(3)

NAME
     mmbbrruunnee, mmbbrrrruunnee, mmbbmmbb - multibyte rune support for C

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     char *
     mmbbrruunnee(const char *string, runet rune);

     char *
     mmbbrrrruunnee(const char *string, runet rune);

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

DESCRIPTION
     The 4.4BSD ``rune'' functions have been deprecated in favour of the ISO
     C99 extended multibyte and wide character facilities and should not be
     used in new applications.  Consider working with wide characters instead,
     and using wcschr(3), wcsrchr(3), and wcsstr(3) instead of these func-
     tions.

     These routines provide the corresponding functionality of ssttrrcchhrr(),
     ssttrrrrcchhrr() and ssttrrssttrr() for multibyte strings.

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

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

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

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

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

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

SEE ALSO
     rune(3), setlocale(3), euc(4), utf2(4), utf8(5)

HISTORY     The mmbbrruunnee(), mmbbrrrruunnee(), and mmbbmmbb() functions first appeared in Plan 9
     from Bell Labs as uuttffrruunnee(), uuttffrrrruunnee(), and uuttffuuttff().

BSD                             April 19, 1994                             BSD