function
<cwchar>

wmemchr

const wchar_t* wmemchr (const wchar_t* ptr, wchar_t wc, size_t num);
      wchar_t* wmemchr (      wchar_t* ptr, wchar_t wc, size_t num);
Locate character in block of wide characters
Searches within the first num wide characters of the block pointed by ptr for the first occurrence of wc, and returns a pointer to it (or a null pointer if not found).

Notice that, unlike wcschr, the function does not stop comparing after finding a null wide character.

This is the wide character equivalent of memchr (<cstring>).

Parameters

ptr
Pointer to the array of wchar_t elements to be searched.
wc
Wide character to be located.
num
Number of elements of type wchar_t to compare.
size_t is an unsigned integral type.

Return Value

A pointer to the first occurrence of wc in the array pointed by ptr.
If the wc is not found, the function returns a null pointer.

Portability

In C, this function is only declared as:

wchar_t * wmemchr ( const wchar_t *, wchar_t, size_t );

instead of the two overloaded versions provided in C++.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
/* wmemchr example */
#include <wchar.h>

int main ()
{
  wchar_t * pwc;
  wchar_t wcs[] = L"Example wide string";
  pwc = wmemchr (wcs, L'p', wcslen(wcs));
  if (pwc!=NULL)
    wprintf (L"'p' found at position %d.\n", pwc-wcs+1);
  else
    wprintf (L"'p' not found.\n");
  return 0;
}


Output:

'p' found at position 5.

See also

memchr
Locate character in block of memory (function )
wmemcmp
Compare two blocks of wide characters (function )
wcschr
Locate first occurrence of character in wide string (function )
wcsrchr
Locate last occurrence of character in wide string (function )

C++