std::filesystem::path::compare
提供: cppreference.com
<tbody>
</tbody>
int compare( const path& p ) const noexcept; |
(1) | (C++17以上) |
int compare( const string_type& str ) const; int compare( std::basic_string_view<value_type> str ) const; |
(2) | (C++17以上) |
int compare( const value_type* s ) const; |
(3) | (C++17以上) |
パスと別のパスの字句的表現を比較します。
1)
root_name().native().compare(p.root_name().native()) が非ゼロの場合は、その値を返します。 そうでなく、
has_root_directory() != p.has_root_directory() の場合は、has_root_directory() が false であればゼロより小さな値、そうでなければゼロより大きな値を返します。 そうでなければ、パスの相対部分 (
relative_path()) が p の相対部分 (p.relative_path()) より辞書的に小さい、等しい、または大きい場合に、それぞれ 0 より小さい、等しい、または大きい値を返します。 比較は、両方のパスを begin() から end() までイテレートし、それぞれの要素に対して native() の結果を比較したかのように、要素ごとに行われます。2)
compare(path(str)) と同等です。3)
compare(path(s)) と同等です。引数
| p | - | 比較するパス |
| str | - | 比較するパスを表す文字列または文字列ビュー |
| s | - | 比較するパスを表すヌル終端文字列 |
戻り値
パスが指定されたパスより辞書的に小さければ 0 より小さい値。
パスが指定されたパスと辞書的に等しければ 0 と等しい値。
パスが指定されたパスより辞書的に大きければ 0 より大きい値。
例外
2-3) (なし)
ノート
二方比較に対しては二項演算子の方が適している場合があります。
例
Run this code
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
void demo(int rc, fs::path p1, fs::path p2) {
if(rc < 0) std::cout << p1 << " < " << p2 << '\n';
else if(rc > 0) std::cout << p1 << " > " << p2 << '\n';
else if(rc == 0) std::cout << p1 << "==" << p2 << '\n';
}
int main() {
fs::path p1 = "/a/b/"; // as if "a/b/." for lexicographical iteration
fs::path p2 = "/a/b/#";
demo(p1.compare(p2), p1, p2);
demo(p1.compare("a/b/_"), p1, "a/b/_");
}
出力:
"/a/b/" > "/a/b/#"
"/a/b/" < "a/b/_"
欠陥報告
以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。
| DR | 適用先 | 発行時の動作 | 正しい動作 |
|---|---|---|---|
| LWG 2936 | C++17 | compared all path elements directly | root name and root directory handled separately |
関連項目
(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20) |
2つのパスを辞書的に比較します (関数) |