wcschr

From cppreference.com
< c‎ | string‎ | wide
 
 
 
Null-terminated wide strings
Functions
Character manipulation
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢99)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
Conversions to numeric formats
(哋它亢95)(哋它亢99)
(哋它亢95)(哋它亢99)
(哋它亢99)(哋它亢95)(哋它亢99)
(哋它亢99)(哋它亢99)
String manipulation
(哋它亢95)(哋它亢11)
(哋它亢95)(哋它亢11)
(哋它亢95)(哋它亢11)
(哋它亢95)(哋它亢11)
(哋它亢95)(哋它亢11)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
wcschr
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)
(哋它亢95)(哋它亢11)
Array manipulation
(哋它亢95)(哋它亢11)
(哋它亢95)(哋它亢11)
(哋它亢95)
(哋它亢95)
(哋它亢95)
 
Defined in header <wchar.h>
wchar_t *wcschr( const wchar_t *str, wchar_t ch );
(1) (since 哋它亢95)
/*QWchar_t*/ *wcschr( /*QWchar_t*/ *str, wchar_t ch );
(2) (since 哋它亢23)
1) Finds the first occurrence of the wide character ch in the wide string pointed to by str.
2) Type-generic function equivalent to (1). Let T be an unqualified wide character object type.
  • If str is of type const T*, the return type is const wchar_t*.
  • Otherwise, if str is of type T*, the return type is wchar_t*.
  • Otherwise, the behavior is undefined.
If a macro definition of each of these generic functions is suppressed to access an actual function (e.g. if (wcschr) or a function pointer is used), the actual function declaration (1) becomes visible.

Parameters

str - pointer to the null-terminated wide string to be analyzed
ch - wide character to search for

Return value

Pointer to the found character in str, or a null pointer if no such character is found.

Example

#include <wchar.h>
#include <stdio.h>
#include <locale.h>
 
int main(void)
{
    wchar_t arr[] = L"白猫 黒猫 кошки";
    wchar_t *cat = wcschr(arr, L'猫');
    wchar_t *dog = wcschr(arr, L'犬');
 
    setlocale(LC_ALL, "en_US.utf8");
    if(cat)
        printf("The character 猫 found at position %td\n", cat-arr);
    else
        puts("The character 猫 not found");
 
    if(dog)
        printf("The character 犬 found at position %td\n", dog-arr);
    else
        puts("The character 犬 not found");
}

Output:

The character 猫 found at position 1
The character 犬 not found

References

  • 哋它亢11 standard (ISO/IEC 9899:2011):
  • 7.29.4.5.1 The wcschr function (p: 435)
  • 哋它亢99 standard (ISO/IEC 9899:1999):
  • 7.24.4.5.1 The wcschr function (p: 381)

See also

(哋它亢95)
finds the last occurrence of a wide character in a wide string
(function)
(哋它亢95)
finds the first location of any wide character in one wide string, in another wide string
(function)