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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::wcscmp - std::wcscmp

Synopsis
	  Defined in header <cwchar>
	  int wcscmp( const wchar_t* lhs, const	wchar_t* rhs );

	  Compares two null-terminated wide strings lexicographically.

	  The  sign  of	 the  result is	the sign of the	difference between the
       values of the first
	  pair of wide characters that differ in the strings being compared.

	  The behavior is undefined if lhs or rhs are not  pointers  to	 null-
       terminated wide
	  strings.

Parameters
	  lhs, rhs - pointers to the null-terminated wide strings to compare

Return value
	  Negative value if lhs	appears	before rhs in lexicographical order.

	  Zero if lhs and rhs compare equal.

	  Positive value if lhs	appears	after rhs in lexicographical order.

Notes
	  This	function is not	locale-sensitive, unlike std::wcscoll, and the
       order may not be
	  meaningful when characters from different Unicode  blocks  are  used
       together	or when
	  the order of code units does not match collation order.

Example
       // Run this code

	#include <vector>
	#include <cwchar>
	#include <algorithm>
	#include <iostream>

	int main()
	{
	    std::vector<const wchar_t*>	leaders{L"", L"", L"",
		L"", L"", L"", L"", L""};

	    std::sort(leaders.begin(), leaders.end(), [](auto strA, auto strB)
       {
		return std::wcscmp(strA, strB) < 0;
	    });

	    std::setlocale(LC_ALL, "en_US.utf8");
	    std::wcout.imbue(std::locale("en_US.utf8"));
	    for	(auto leader : leaders)
		std::wcout << leader <<	'\n';
	}

Possible output:

See also
	  wcsncmp  compares  a	certain	 amount	 of  characters	 from two wide
       strings
		  (function)
	  wmemcmp compares a certain amount of wide characters from two	arrays
		  (function)
	  strcmp  compares two strings
		  (function)
	  wcscoll compares two wide strings in accordance to the  current  lo-
       cale
		  (function)

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

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

home | help