On this page
wcschr
Defined in header <wchar.h> |
||
|---|---|---|
|
(1) | (since C95) |
|
(2) | (since C23) |
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
stris of typeconst T*, the return type isconst wchar_t*. - Otherwise, if
stris of typeT*, the return type iswchar_t*. - Otherwise, the behavior is undefined.
(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
- 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)
See also
|
(C95)
|
finds the last occurrence of a wide character in a wide string (function) |
|
(C95)
|
finds the first location of any wide character in one wide string, in another wide string (function) |
C++ documentation for wcschr |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/string/wide/wcschr