Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
MBRUNE(3)		 BSD Library Functions Manual		     MBRUNE(3)

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

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <rune.h>

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

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

     char *
     mbmb(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 functions.

     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 NUL 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
     rune(3), setlocale(3), euc(5), utf2(5), utf8(5)

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

BSD				April 19, 1994				   BSD
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mbrune&sektion=3&manpath=FreeBSD+5.2-RELEASE+and+Ports>

home | help