mbscat, mbscmp, or mbscpy Subroutine

Purpose

Performs operations on multibyte character strings.

Library

Standard C Library (libc.a)

Syntax

#include <mbstr.h>

char *mbscat(MbString1, MbString2)
char *MbString1, *MbString2;

int mbscmp(MbString1, MbString2)
char *MbString1, *MbString2;

char *mbscpy(MbString1, MbString2)
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.

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

Related Information

The mbsncat, mbsncmp, mbsncpy subroutine, wcscat, wcscmp, wcscpy subroutine.

National Language Support Overview for Programming, Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.