std::experimental::filesystem::path:: concat, std::experimental::filesystem::path:: operator+=
From cppreference.net
<
cpp
|
experimental
|
fs
|
path
|
path
&
operator
+
=
(
const
path
&
p
)
;
|
(1) | (filesystem TS) |
|
path
&
operator
+
=
(
const
string_type
&
str
)
;
|
(2) | (filesystem TS) |
|
path
&
operator
+
=
(
const
value_type
*
ptr
)
;
|
(3) | (filesystem TS) |
|
path
&
operator
+
=
(
value_type x
)
;
|
(4) | (filesystem TS) |
|
template
<
class
Source
>
path & operator + = ( const Source & source ) ; |
(5) | (filesystem TS) |
|
template
<
class
CharT
>
path & operator + = ( CharT x ) ; |
(6) | (filesystem TS) |
|
template
<
class
Source
>
path & concat ( const Source & source ) ; |
(7) | (filesystem TS) |
|
template
<
class
InputIt
>
path & concat ( InputIterator first, InputIterator last ) ; |
(8) | (filesystem TS) |
` ont été préservés conformément aux instructions. Seul le texte descriptif a été traduit en français. Les termes spécifiques au C++ (comme "path", "operator", "const", etc.) et le contenu des balises de code n'ont pas été traduits.
Concatène le chemin actuel et l'argument.
1)
Concatène
*
this
et
p
de telle manière que
native()
du résultat soit exactement le
native()
original concaténé avec
p.
native
(
)
.
2)
Identique à
(1)
, sauf que le résultat de
native()
est une concaténation du
native()
original et de la chaîne
str
.
3)
Identique à
(1)
, sauf que le résultat de
native()
est une concaténation du
native()
original et de la chaîne terminée par un caractère nul dont le premier caractère est pointé par
ptr
.
4)
Identique à
(1)
, sauf que le résultat de
native()
est une concaténation du
native()
original et du caractère unique
x
.
5)
Identique à
(1)
, sauf que le résultat
native()
est une concaténation du
native()
original et de la séquence (qui peut être au format portable ou natif) représentée par
source
, qui peut être une
std::
basic_string
, une chaîne de caractères multioctets terminée par un caractère nul, ou un itérateur d'entrée pointant vers une séquence de caractères multioctets terminée par un caractère nul.
6)
Identique à
(4)
, sauf qu'une conversion de caractères peut être effectuée.
7)
Identique à
(5)
.
8)
Identique à
(5)
, sauf que la séquence est représentée par toute paire d'itérateurs qui désigne une chaîne de caractères multiples.
Table des matières |
Paramètres
| p | - | chemin à ajouter |
| str | - | chaîne à ajouter |
| ptr | - | pointeur vers le début d'une chaîne null-terminated à ajouter |
| x | - | caractère unique à ajouter |
| source | - | std:: basic_string , chaîne multicaractère null-terminated, ou un itérateur d'entrée pointant vers une séquence multicaractère null-terminated, qui représente un nom de chemin (soit en format portable, soit en format natif) |
| first, last | - | paire de LegacyInputIterator s qui spécifie une séquence multicaractère représentant un nom de chemin |
| Exigences de type | ||
-
InputIt
doit satisfaire aux exigences de
LegacyInputIterator
.
|
||
-
InputIt
doit être l'un des types de caractères encodés (
char
,
wchar_t
,
char16_t
et
char32_t
).
|
||
-
CharT
doit être l'un des types de caractères encodés (
char
,
wchar_t
,
char16_t
et
char32_t
).
|
||
Valeur de retour
* this
Exceptions
Peut lever filesystem_error en cas d'erreurs de l'API système sous-jacente ou std:: bad_alloc si l'allocation mémoire échoue.
Notes
Contrairement à append() ou operator/= , les séparateurs de répertoire supplémentaires ne sont jamais introduits.
Exemple
Exécuter ce code
#include <experimental/filesystem> #include <iostream> namespace fs = std::experimental::filesystem; int main() { fs::path p1; // chemin vide p1 += "var"; // n'insère pas de séparateur std::cout << "\"\" + \"var\" == " << p1 << '\n'; p1 += "lib"; // n'insère pas de séparateur std::cout << "\"\" + \"var\" + \"lib\" == " << p1 << '\n'; }
Sortie :
"" + "var" == "var" "" + "var" + "lib" == "varlib"
Voir aussi
|
ajoute des éléments au chemin
(fonction membre publique) |
|
|
concatène deux chemins avec un séparateur de répertoire
(fonction) |