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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::wcsstr - std::wcsstr

Synopsis
	  Defined in header <cwchar>
	  const	wchar_t* wcsstr( const wchar_t*	dest, const wchar_t* src );
	  wchar_t* wcsstr( wchar_t* dest, const	wchar_t* src );

	  Finds	the first occurrence of	the wide string	src in the wide	string
       pointed to by
	  dest.	The terminating	null characters	are not	compared.

Parameters
	  dest - pointer to the	null-terminated	wide string to examine
	  src  - pointer to the	null-terminated	wide string to search for

Return value
	  Pointer  to the first	character of the found substring in dest, or a
       null pointer if
	  no such substring is found. If src points to an empty	 string,  dest
       is returned.

Example
       // Run this code

	#include <iostream>
	#include <cwchar>
	#include <clocale>

	int main()
	{
	    wchar_t const* origin = L",	, , , ,	.";
	    wchar_t const* target = L"";
	    wchar_t const* result = origin;

	    std::setlocale(LC_ALL, "en_US.utf8");
	    std::wcout << L"Substring to find: \"" << target <<	L"\"\n"
		       << L"String to search: \"" << origin << L"\"\n\n";

	    for	 (;  (result  =	std::wcsstr(result, target)) !=	nullptr; ++re-
       sult)
		std::wcout << L"Found: \"" << result <<	L"\"\n";
	}

Possible output:
	Substring to find: ""
	String to search: ", , , , , ."

	Found: ", , , ,	."
	Found: ", ."

See also
	  find	  find characters in the string
		  (public	member	     function	    of	      std::ba-
       sic_string<CharT,Traits,Allocator>)
	  strstr  finds	the first occurrence of	a substring of characters
		  (function)
	  wcschr   finds  the  first  occurrence of a wide character in	a wide
       string
		  (function)
	  wcsrchr finds	the last occurrence of a  wide	character  in  a  wide
       string
		  (function)

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

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

home | help