名前空間
変種

    std::filesystem::path::concat, std::filesystem::path::operator+=

    提供: cppreference.com
     
    C++
     
    ファイルシステムライブラリ
    クラス
    関数
    ファイル種別
     
    std::filesystem::path
    定数
    メンバ関数
    パスの分解
    非メンバ関数
    (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20)
     
    <tbody> </tbody>
    path& operator+=( const path& p );
    		 (1) (C++17以上)
    path& operator+=( const string_type& str ); path& operator+=( std::basic_string_view<value_type> str );
    		 (2) (C++17以上)
    path& operator+=( const value_type* ptr );
    		 (3) (C++17以上)
    template< class Source > path& operator+=( const Source& source );
    		 (4) (C++17以上)
    template< class Source > path& concat( const Source& source );
    		 (5) (C++17以上)
    path& operator+=( value_type x );
    		 (6) (C++17以上)
    template< class CharT > path& operator+=( CharT x );
    		 (7) (C++17以上)
    template< class InputIt > path& concat( InputIterator first, InputIterator last );
    		 (8) (C++17以上)

    現在のパスと引数を連結します。

    1-5) ネイティブ形式で *this に格納されているパス名に path(other).native() を追加します。 これは native() の値を直接操作します。 オペレーティングシステム間で移植性がない場合があります。
    6-7) return *this += std::basic_string_view(&x, 1); と同じです。
    8) return *this += path(first, last); と同じです。

    引数

    p - 追加するパス
    str - 追加する文字列または文字列ビュー
    ptr - 追加するヌル終端文字列の先頭を指すポインタ
    x - 追加する単一の文字
    source - 移植性のある形式かネイティブ形式のいずれかでパス名を表す std::basic_string、 std::basic_string_view、ヌル終端文字列、またはヌル終端文字シーケンスを指す入力イテレータ
    first, last - パス名を表す文字シーケンスを表す一組の LegacyInputIterator
    型の要件
    -
    InputIt は LegacyInputIterator の要件を満たさなければなりません。
    -
    InputIt の値型はエンコードされた文字型 (char, wchar_t, char16_t, char32_t) のいずれかでなければなりません。
    -
    CharT はエンコードされた文字型 (char, wchar_t, char16_t, char32_t) のいずれかでなければなりません。

    戻り値

    *this。

    例外

    メモリ確保に失敗した場合は std::bad_alloc を投げる可能性があります。

    ノート

    append() や operator/= と異なり、追加のディレクトリ区切り文字が挿入されることはありません。

    例

    Run this code
    #include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
int main() {
    fs::path p1; // empty path
    p1 += "var"; // does not insert a separator
    std::cout << "\"\" + \"var\" == " << p1 << '\n';
    p1 += "lib"; // does not insert a separator
    std::cout << "\"\" + \"var\" + \"lib\" == " << p1 << '\n';
}

    出力: 

    "" + "var" == "var"
"" + "var" + "lib" == "varlib"

    欠陥報告

    以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

    DR 適用先 発行時の動作 正しい動作
    LWG 3055 C++17 the specification of concatenating a single character was ill-formed made well-formed

    関連項目

    		 パスに要素をディレクトリ区切り文字付きで追加します
    (パブリックメンバ関数) [edit]
    		2つのパスをディレクトリ区切り文字付きで連結します
    (関数) [edit]