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

Technical Reference: Base Operating System and Extensions , Volume 2


wcswcs Subroutine

Purpose

Locates first occurrence of a wide character in a string.

Library

Standard C Library (libc.a)

Syntax

#include <string.h>

wchar_t *wcswcs( WcString1 WcString2)
const wchar_t *WcString1, *WcString2;

Description

The wcswcs subroutine locates the first occurrence, in the string pointed to by the WcString1 parameter, of a sequence of wchar_t characters (excluding the terminating wchar_t null character) from the string pointed to by the WcString2 parameter.

Parameters


WcString1 Points to the wide-character string being searched.
WcString2 Points to a wide-character string, which is a source string.

Return Values

The wcswcs subroutine returns a pointer to the located string, or a null value if the string is not found. If the WcString2 parameter points to a string with 0 length, the function returns the WcString1 value.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The mbspbrk subroutine, wcschr (wcscat, wcschr, wcscmp, wcscpy, or wcscspn Subroutine) subroutine, wcscspn (wcscat, wcschr, wcscmp, wcscpy, or wcscspn Subroutine) subroutine, wcspbrk (wcspbrk Subroutine) subroutine, wcsrchr (wcsrchr Subroutine) subroutine, wcsspn (wcsspn Subroutine) subroutine, wcstok (wcstok Subroutine) subroutine.

National Language Support Overview for Programming, Subroutines Overview, Understanding Wide Character String Search Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


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