Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::strchr(3)		      C++ Standard Libary		std::strchr(3)

NAME
       std::strchr - std::strchr

Synopsis
	  Defined in header <cstring>
	  const	char* strchr( const char* str, int ch );
	  char*	strchr(	char* str, int ch );

	  Finds	the first occurrence of	the character static_cast<char>(ch) in
       the byte	string
	  pointed to by	str.

	  The  terminating  null  character  is	considered to be a part	of the
       string and can be
	  found	if searching for '\0'.

Parameters
	  str -	pointer	to the null-terminated byte string to be analyzed
	  ch  -	character to search for

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

Example
       // Run this code

	#include <iostream>
	#include <cstring>

	int main()
	{
	  const	char *str = "Try not. Do, or do	not. There is no try.";
	  char target =	'T';
	  const	char *result = str;

	  while	((result = std::strchr(result, target))	!= nullptr) {
	    std::cout << "Found	'" << target
		      << "' starting at	'" << result <<	"'\n";

	    // Increment result, otherwise we'll find target at	the same loca-
       tion
	    ++result;
	  }
	}

Output:
	Found 'T' starting at 'Try not.	Do, or do not. There is	no try.'
	Found 'T' starting at 'There is	no try.'

See also
	  memchr  searches an array for	the first occurrence of	a character
		  (function)
	  find	  find characters in the string
		  (public	 member	      function	     of	      std::ba-
       sic_string<CharT,Traits,Allocator>)
	  wcschr  finds	the first occurrence of	a wide	character  in  a  wide
       string
		  (function)
	  strrchr finds	the last occurrence of a character
		  (function)
	  strpbrk finds	the first location of any character from a set of sep-
       arators
		  (function)

http://cppreference.com		  2022.07.31			std::strchr(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::strchr&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help