Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wcsstr(3C)

Name

wcsstr - find a wide-character substring

Synopsis

#include <wchar.h>

wchar_t *wcsstr(const wchar_t *restrict ws1, const wchar_t *restrict ws2);

ISO C++

#include <wchar.h>

const wchar_t *wcsstr(const wchar_t *ws1, const wchar_t *ws2);
#include <cwchar>

wchar_t *std::wcsstr(wchar_t *ws1, const wchar_t *ws2);

Description

The wcsstr() function locates the first occurrence in the wide-character string pointed to by ws1 of the sequence of wide-characters (excluding the terminating null wide-character) in the wide-character string pointed to by ws2.

Return Values

On successful completion, wcsstr() returns a pointer to the located wide-character string, or a null pointer if the wide-character string is not found.

If ws2 points to a wide-character string with zero length, the function returns ws1.

Errors

No errors are defined.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Async-Signal-Safe
Standard

See Also

wschr(3C), attributes(7), standards(7)