std::filesystem::path::assign
Von cppreference.com
< cpp | filesystem | path
| path& assign( string_type&& source ); |
(1) | (seit C++17) |
| template< class Source > path& assign( const Source& source ); |
(2) | (seit C++17) |
| template< class InputIt > path& assign( InputIt first, InputIt last ); |
(3) | (seit C++17) |
Ersetzt den Inhalt des path-Objekts durch einen neuen Pfadnamen, der aus der gegebenen Zeichenfolge konstruiert wurde.
1) Weist den durch die Zeichenfolge
source identifizierten Pfadnamen zu, welche in einem gültigen, aber undefinierten Zustand hinterlassen wird.2) Weist den durch den Zeichenbereich
source identifizierten Pfadnamen zu.3) Weist den durch den Zeichenbereich
[first, last) identifizierten Pfadnamen zu.(2) nimmt an der Überladungsauflösung teil, nur wenn Source und path nicht denselben Typ haben und entweder
-
Sourceeine Spezialisierung von std::basic_string oder std::basic_string_view ist, oder - std::iterator_traits<std::decay_t<Source>>::value_type gültig ist und einen möglicherweise mit const qualifizierten Kodierungszeichentyp bezeichnet (char, char8_t, (seit C++20)char16_t, char32_t oder wchar_t).
Inhalt |
[bearbeiten] Parameter
| source | - | ein zu verwendender Zeichenbereich, dargestellt als std::string, std::string_view, Zeiger auf eine nullterminierte Multibyte-Zeichenfolge oder als Eingabeiterator mit char-Werttyp, der auf eine nullterminierte Multibyte-Zeichenfolge zeigt |
| first, last | - | ein zu verwendender Zeichenbereich |
| Typanforderungen | ||
-InputIt muss die Anforderungen von LegacyInputIterator erfüllen. | ||
-Der Werttyp von InputIt muss einer der kodierten Zeichentypen sein (char, wchar_t, char16_t und char32_t) | ||
[bearbeiten] Rückgabewert
*this
[bearbeiten] Fehlerberichte
Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | angewendet auf | Verhalten wie veröffentlicht | Korrigiertes Verhalten |
|---|---|---|---|
| LWG 3244 | C++17 | Es fehlte die Bedingung, dass Source nicht path sein kann |
hinzugefügt |
[bearbeiten] Siehe auch
| weist einen anderen Pfad zu (member function) |