[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1

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.

Related Information

The mbsncat, mbsncmp, mbsncpy (mbsncat, mbsncmp, or mbsncpy Subroutine) subroutine, wcscat, wcscmp, wcscpy subroutine.

Subroutines, Example Programs, and Libraries in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

National Language Support Overview in AIX 5L Version 5.2 National Language Support Guide and Reference.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]