mbscat, mbscmp, or mbscpy Subroutine

Purpose

Performs operations on multibyte character strings.

Library

Standard C Library (libc.a)

Syntax

#include <mbstr.h>
char *mbscat(MbString1MbString2)
char *MbString1, *MbString2;
int mbscmp(MbString1MbString2)
char *MbString1, *MbString2;
char *mbscpy(MbString1MbString2)
char *MbString1, *MbString2;

Description

The mbscat, mbscmp, and mbscpy subroutines operate on null-terminated multibyte character strings.

The mbscat subroutine appends multibyte characters from the MbString2 parameter to the end of the MbString1 parameter, appends a null character to the result, and returns MbString1.

The mbscmp subroutine compares multibyte characters based on their collation weights as specified in the LC_COLLATE category. The mbscmp subroutine compares the MbString1 parameter to the MbString2 parameter, and returns an integer greater than 0 if MbString1 is greater than MbString2. It returns 0 if the strings are equivalent and returns an integer less than 0 if MbString1 is less than MbString2.

The mbscpy subroutine copies multibyte characters from the MbString2 parameter to the MbString1 parameter and returns MbString1. The copy operation terminates with the copying of a null character.