wcschr - cppreference.com (original) (raw)

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.

[edit] Parameters

[edit] Return value

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

[edit] 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

[edit] References

• C11 standard (ISO/IEC 9899:2011):

• 7.29.4.5.1 The wcschr function (p: 435)

• C99 standard (ISO/IEC 9899:1999):

• 7.24.4.5.1 The wcschr function (p: 381)

[edit] See also

| | finds the last occurrence of a wide character in a wide string (function) [edit] | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | finds the first location of any wide character in one wide string, in another wide string (function) [edit] | | |