std::experimental::filesystem:: canonical
|
Definido en el encabezado
<experimental/filesystem>
|
||
|
path canonical
(
const
path
&
p,
const
path
&
base
=
current_path
(
)
)
;
|
(1) | (filesystem TS) |
|
path canonical
(
const
path
&
p, error_code
&
ec
)
;
|
(2) | (filesystem TS) |
|
path canonical
(
const
path
&
p,
const
path
&
base, error_code
&
ec
)
;
|
(3) | (filesystem TS) |
Convierte la ruta p a una ruta absoluta canónica, es decir, una ruta absoluta que no tiene elementos punto, punto-punto o enlaces simbólicos.
Si p no es una ruta absoluta, la función se comporta como si primero se hiciera absoluta mediante absolute ( p, base ) o absolute ( p ) para (2) .
La ruta p debe existir.
Contenidos |
Parámetros
| p | - | una ruta que puede ser absoluta o relativa a base , y que debe ser una ruta existente |
| base | - | ruta base que se utilizará en caso de que p sea relativa |
| ec | - | código de error para almacenar el estado del error |
Valor de retorno
Una ruta absoluta que resuelve al mismo archivo que absolute ( p, base ) (o absolute ( p ) para (2) ).
Excepciones
The overload that does not take an error_code & parameter throws filesystem_error on underlying OS API errors, constructed with p as the first argument, base as the second argument, and the OS error code as the error code argument. std:: bad_alloc may be thrown if memory allocation fails. The overload taking an error_code & parameter sets it to the OS API error code if an OS API call fails, and executes ec. clear ( ) if no errors occur. This overload hasEsta función está modelada según la versión POSIX de realpath .
Ejemplo
#include <experimental/filesystem> #include <iostream> namespace fs = std::experimental::filesystem; int main() { fs::path p = fs::path("..") / ".." / "AppData"; std::cout << "Current path is " << fs::current_path() << '\n' << "Canonical path for " << p << " is " << fs::canonical(p) << '\n'; }
Salida posible:
Current path is "C:\Users\abcdef\AppData\Local\Temp" Canonical path for "..\..\AppData" is "C:\Users\abcdef\AppData"
Véase también
|
representa una ruta
(clase) |
|
|
compone una ruta absoluta
convierte una ruta a ruta absoluta replicando comportamiento específico del SO (función) |