std::filesystem::path::assign

path& assign( string_type&& source );	(1)	(C++17以降)
template< class Source > path& assign( const Source& source );	(2)	(C++17以降)
template< class InputIt > path& assign( InputIt first, InputIt last );	(3)	(C++17以降)

指定された文字シーケンスから構築された新しいパス名で、path オブジェクトの内容を置き換えます。

1) 有効だが未規定の状態にある、検出されたフォーマットの文字列sourceによって識別されるパス名を代入します。

2) 検出されたフォーマットの文字範囲sourceによって識別されるパス名を代入します。

3) 検出されたフォーマットの文字範囲[first, last)によって識別されるパス名を代入します。

(2) Source と path が同じ型でなく、かつ次のいずれかの条件を満たす場合にのみ、オーバーロード解決に参加します。

Sourceがstd::basic_stringまたはstd::basic_string_viewの特殊化であるか、または
std::iterator_traits<std::decay_t<Source>>::value_type が有効で、符号化文字型（char、char8_t、(since C++20)char16_t、char32_t、または wchar_t）の可能性のある const 修飾型を示す場合。

source	-	使用する文字範囲。`std::string`、`std::string_view`、null 終端マルチバイト文字列へのポインタ、または null 終端マルチバイト文字列を指す char 値型の入力イテレータとして表現されます。
first, last	-	使用する文字範囲
型要件
- `InputIt` は LegacyInputIterator の要件を満たす必要があります。
- `InputIt` の値型は、符号化文字型（char、wchar_t、char16_t、および char32_t）のいずれかである必要があります。

*this

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 3244	C++17	`Source`が`path`ではないという制約が欠落していました	追加された

別のパスを代入します。
(public member function) [編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

目次