std::experimental::basic_string_view<CharT,Traits>::compare

From cppreference.com

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros(C++20)
Language support library
Concepts library(C++20)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Experimental

Technical Specification
Filesystem library(filesystem TS)
Library fundamentals(library fundamentals TS)
Library fundamentals 2(library fundamentals TS v2)
Library fundamentals 3(library fundamentals TS v3)
Extensions for parallelism(parallelism TS)
Extensions for parallelism 2(parallelism TS v2)
Extensions for concurrency(concurrency TS)
Extensions for concurrency 2(concurrency TS v2)
Concepts(concepts TS)
Ranges(ranges TS)
Reflection(reflection TS)
Mathematical special functions(special functions TR)
Experimental Non-TS
Pattern Matching
Linear Algebra
std::execution
Contracts
2D Graphics

[edit]

Library fundamentals

experimental::optional
experimental::any
experimental::basic_string_view
experimental::sample
experimental::shared_ptr
experimental::weak_ptr
experimental::apply
experimental::invocation_typeexperimental::raw_invocation_type
experimental::search
experimental::default_searcherexperimental::make_default_searcher
experimental::boyer_moore_searcherexperimental::make_boyer_moore_searcher
experimental::boyer_moore_horspool_searcherexperimental::make_boyer_moore_horspool_searcher
Type-erased and polymorphic allocators
Variable templates for type traits

[edit]

std::experimental::basic_string_view

Member functions
basic_string_view::basic_string_view
basic_string_view::operator=
Iterators
basic_string_view::beginbasic_string_view::cbegin
basic_string_view::endbasic_string_view::cend
basic_string_view::rbeginbasic_string_view::crbegin
basic_string_view::rendbasic_string_view::crend
Element access
basic_string_view::at
basic_string_view::operator[]
basic_string_view::front
basic_string_view::back
basic_string_view::data
Capacity
basic_string_view::sizebasic_string_view::length
basic_string_view::max_size
basic_string_view::empty
Modifiers
basic_string_view::remove_prefix
basic_string_view::remove_suffix
basic_string_view::swap

Operations
basic_string_view::to_stringbasic_string_view::operator basic_string
basic_string_view::copy
basic_string_view::substr
basic_string_view::compare
basic_string_view::find
basic_string_view::rfind
basic_string_view::find_first_of
basic_string_view::find_last_of
basic_string_view::find_first_not_of
basic_string_view::find_last_not_of
Constants
basic_string_view::npos
Non-member functions
operator==operator!=operator<operator>operator<=operator>=
operator<<
Helper classes
hash<std::string_view>hash<std::wstring_view>hash<std::u16string_view>hash<std::u32string_view>

[edit]

constexprint compare(basic_string_view v)constnoexcept;	(1)	(library fundamentals TS)
constexprint compare(size_type pos1, size_type count1, basic_string_view v)const	(2)	(library fundamentals TS)
constexprint compare(size_type pos1, size_type count1, basic_string_view v, size_type pos2, size_type count2)const;	(3)	(library fundamentals TS)
constexprint compare(const CharT* s)const;	(4)	(library fundamentals TS)
constexprint compare(size_type pos1, size_type count1, const CharT* s)const;	(5)	(library fundamentals TS)
constexprint compare(size_type pos1, size_type count1, const CharT* s, size_type count2)const;	(6)	(library fundamentals TS)

Compares two character sequences.

1) The lengthrlen of the sequences to compare is the smaller ofsize() andv.size(). The function compares the two views by callingtraits::compare(data(), v.data(), rlen), and returns a value according to the following table:

Condition		Result	Return value
`Traits::compare(data(), v.data(),rlen) < 0`		`this` isless than`v`	<0
`Traits::compare(data(), v.data(),rlen) == 0`	`size() < v.size()`	`this` isless than`v`	<0
	`size() == v.size()`	`this` isequal to`v`	0
	`size() > v.size()`	`this` isgreater than`v`	>0
`Traits::compare(data(), v.data(),rlen) > 0`		`this` isgreater than`v`	>0

2) Equivalent tosubstr(pos1, count1).compare(v).

3) Equivalent tosubstr(pos1, count1).compare(v.substr(pos2, count2)).

4) Equivalent tocompare(basic_string_view(s)).

5) Equivalent tosubstr(pos1, count1).compare(basic_string_view(s)).

6) Equivalent tosubstr(pos1, count1).compare(basic_string_view(s, count2)).

[edit]Parameters

v	-	view to compare
s	-	pointer to the character string to compare to
count1	-	number of characters of this view to compare
pos1	-	position of the first character in this view to compare
count2	-	number of characters of the given view to compare
pos2	-	position of the first character of the given view to compare

[edit]Return value

negative value if this view is less than the other character sequence, zero if the both character sequences are equal, positive value if this view is greater than the other character sequence.