Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ wcswcs(3) — Digital UNIX 4.0d

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

strstr(3)

wcschr(3)

wcspbrk(3)

wcsstr(3)

standards(5)

wcswcs(3)  —  Subroutines

NAME

wcswcs − Searches for a substring in a wide-character string. 

LIBRARY

Standard C Library (libc.so, libc.a)

SYNOPSIS

#include <wchar.h>

wchar_t ∗wcswcs(
const wchar_t ∗wcstring1,
const wchar_t ∗wcstring2);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

wcswcs():  XPG4

Refer to the standards(5) reference page for more information about industry standards and associated tags. 

PARAMETERS

wcstring1
Points to the wide-character string being searched.

wcstring2
Points to the wide-character string to be located.

DESCRIPTION

The wcswcs() function locates the first occurrence of a wide-character string in another wide-character string.  The function locates the first occurrence in the string pointed to by the wcstring1 parameter of the sequence of wchar_t characters (excluding the terminating null wide character) in the string pointed to by the wcstring2 parameter. 

RETURN VALUES

The wcswcs() function returns a pointer to the located wide-character string or a null pointer if the wide-character string is not found.  If the wcstring2 parameter points to a wide-character string with zero length, the function returns the wcstring1 parameter. 

RELATED INFORMATION

Functions: strstr(3), wcschr(3), wcspbrk(3), wcsstr(3)

Standards: standards(5)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026