std::filesystem::path::compare
提供: cppreference.com
< cpp | filesystem | path
int compare(const path& p )constnoexcept; | (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';elseif(rc >0)std::cout<< p1 <<" > "<< p2 <<'\n';elseif(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つのパスを辞書的に比較します (関数) |
