std::experimental::filesystem::path::compare

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Filesystem library

Template:cpp/experimental/fs/navbar content

 

path

Template:cpp/experimental/fs/path/navbar content

 

int compare( const path& p ) const;	(1)	(filesystem TS)
int compare( const std::string& str ) const;	(2)	(filesystem TS)
int compare( const value_type& s ) const;	(3)	(filesystem TS)

Compares the lexical representations of the path and another path.

1) Returns a value less than, equal to or greater than 0 if the native representation of the path (native()) is respectively lexicographically less than, equal to or greater than the native representation of p (p.native()).

2) Equivalent to compare(path(str)).

3) Equivalent to compare(path(s)).

Parameters

p	-	a path to compare to
str	-	a string representing path to compare to }
s	-	a null-terminated string representing path to compare to

Return value

A value less than 0 if the path is lexicographically less than the given path.

A value equal to 0 if the path is lexicographically equal to the given path.

A value greater than 0 if the path is lexicographically greater than the given path.

Exceptions

1)

noexcept specification:  

noexcept

  

2-3) (none)

See also

operator==operator!=operator<operator<=operator>operator>=

lexicographically compares two paths (function)