C++ <cstring> - memchr() Function

The C++ <cstring> memchr() function is used to find the first occurrence of ch (after conversion to unsigned char) in first num characters of the block of memory (each interpreted as unsigned char) pointed to by ptr.

The function returns pointer to the first occurrence of ch in ptr, or null pointer if ch is not found in ptr.

Syntax

const void * memchr ( const void * ptr, int ch, size_t num );
void * memchr ( void * ptr, int ch, size_t num );

Parameters

Return Value

Returns pointer to the first occurrence of ch in ptr, or null pointer if ch is not found in ptr.

Example:

The example below shows the usage of memchr() function.

#include <iostream>
#include <cstring>
using namespace std;
 
int main (){
  char MyStr[100] = "To be, or not to be, that is the question.";
  char * search;
  
  //searching for first occurrence of 'e' 
  //in first 25 characters of MyStr
  search = (char*) memchr(MyStr, 'e', 25);

  //displaying the result
  if(search != NULL)
    cout<<"Found at: "<<(search-MyStr+1)<<"\n";
  else
    cout<<"Not Found."<<"\n";
 
  return 0;
}

The output of the above code will be:

Found at: 5