C++ cstring strrchr() Function

The strrchr() function is a built-in function in C++ which is defined in <cstring> header file. The strrchr() function is used for finding the last occurrence of a character in a string.

The strrchr() function is similar to the strchr() function but the difference is that strchr() function finds the first occurrence of a character in a string whereas strrchr() function finds the last occurrence of a character in a string.

This function has some exceptions. If the character is not found in the string, the function returns a null pointer. If the character is '\0', the function returns a pointer to the null terminating character.

Syntax

Following is the syntax of the strrchr() function.

char *strrchr(const char *str, int c);

Parameters

Parameters of the strrchr() function are as follows:

• str This is the pointer to the string where the search is performed.
• c This is the character to be located. It is passed as its int promotion.

Return Value

The strrchr() function returns a pointer to the last occurrence of the character c in the string, or NULL if the character does not occur in the string.

Example 1

We will take a string str and then search for the last occurrence of the character 'o' in the string using the strrchr() function. This example will help you to understand the usage of the strrchr() function.

#include <iostream>
#include <cstring>
using namespace std;

int main() {
   char str[] = "tutorialspoint";
   char *ret;

   ret = strrchr(str, 'o');

   if(ret) {
      cout << "Character found: " << *ret << endl;
   } else {
      cout << "Character not found" << endl;
   }

   return 0;
}

Output

Following is the output of the above C++ program −

Character found: t

Example 2

Now, let's take another example where we will search for the character that is not present in the string.

For this, we will take a string str and then search for the last occurrence of the character 'z' in the string using the strrchr() function. This example will help you to understand the exception case of the strrchr() function.

#include <iostream>
#include <cstring>
using namespace std;

int main() {
   char str[] = "tutorialspoint";
   char *ret;

   ret = strrchr(str, 'z');

   if(ret) {
      cout << "Character found: " << *ret << endl;
   }else {
      cout << "Character not found" << endl;
   }

   return 0;
}

Output

Following is the output of the above C++ program:

Character not found