std::experimental::filesystem:: path

Definido en el encabezado <experimental/filesystem>
class path ;		(filesystem TS)

Los objetos de tipo path representan rutas en un sistema de archivos. Solo se manejan aspectos sintácticos de las rutas: el nombre de ruta puede representar una ruta inexistente o incluso una que no está permitida existir en el sistema de archivos o SO actual.

El nombre de la ruta tiene la siguiente sintaxis:

1. root-name (opcional) : identifica la raíz en un sistema de archivos con múltiples raíces (como "C:" o "//myserver" ). Los sistemas de archivos POSIX tienen una única raíz.
2. root-directory (opcional) : un separador de directorio que, si está presente, marca esta ruta como absoluta . Si falta (y el primer elemento distinto del nombre de raíz es un nombre de archivo), entonces la ruta es relativa y requiere otra ruta como ubicación inicial para resolverse en un nombre de archivo.
3. Cero o más de los siguientes:

• file-name : secuencia de caracteres que no son separadores de directorio o separadores de directorio preferidos (pueden existir limitaciones adicionales impuestas por el SO o sistema de archivos). Este nombre puede identificar un archivo, un enlace físico, un enlace simbólico o un directorio. Se reconocen dos file-name s especiales:

• dot : el nombre de archivo que consiste en un solo carácter punto . es un nombre de directorio que se refiere al directorio actual.
• dot-dot : el nombre de archivo que consiste en dos caracteres punto .. es un nombre de directorio que se refiere al directorio padre.

• directory-separator s: el carácter barra diagonal / o el carácter alternativo proporcionado como path::preferred_separator . Si este carácter se repite, se trata como un único separador de directorio: / usr ///////lib es lo mismo que / usr / lib .

La ruta puede ser recorrida elemento por elemento mediante los iteradores devueltos por las funciones begin() y end() , que iteran sobre el nombre raíz, directorio raíz y los elementos subsiguientes de nombre de archivo (los separadores de directorio se omiten excepto el que identifica el directorio raíz). Si el último elemento en la ruta es un separador de directorio, el último iterador desreferenciará a un nombre de archivo dot .

Llamar a cualquier función miembro no constante de un path invalida todos los iteradores que hacen referencia a elementos de ese objeto.

Si el sistema operativo utiliza una sintaxis nativa que es diferente de la sintaxis genérica portátil descrita anteriormente, todas las funciones de la biblioteca aceptan nombres de ruta en ambos formatos.

Los paths son implícitamente convertibles hacia y desde std::basic_string s, lo que permite utilizarlos con otras APIs de archivos, por ejemplo como argumento para std::ifstream::open .

Contenidos 1 Tipos de miembros 2 Constantes de miembros 3 Funciones de miembros 3.1 Concatenación 3.2 Modificadores 3.3 Observadores de formato 3.4 Comparación 3.5 Descomposición 3.6 Consultas 3.7 Iteradores 4 Funciones no miembro

Tipos de miembros

Tipo	Definición
value_type	tipo de carácter utilizado por la codificación nativa del sistema de archivos: char en POSIX, wchar_t en Windows
string_type	std:: basic_string < value_type >
const_iterator	un LegacyBidirectionalIterator constante con un value_type de path
iterator	un alias para const_iterator

Constantes de miembro

constexpr value_type preferred_separator [static]

separador de directorio alternativo que puede usarse además del / portable. En Windows, este es el carácter de barra invertida \ . En POSIX, este es la misma barra diagonal / que el separador portable (constante de miembro público estático)

Funciones miembro

(constructor)	construye un path (función miembro pública)
(destructor)	destruye un objeto path (función miembro pública)
operator=	asigna otra ruta (función miembro pública)
assign	asigna contenidos (función miembro pública)
Concatenación
append operator/=	añade elementos a la ruta (función miembro pública)
concat operator+=	concatena dos rutas sin introducir un separador de directorio (función miembro pública)
Modificadores
clear	borra el contenido (función miembro pública)
make_preferred	convierte los separadores de directorio al separador de directorio preferido (función miembro pública)
remove_filename	elimina el componente de ruta del nombre de archivo (función miembro pública)
replace_filename	reemplaza el último componente de la ruta con otra ruta (función miembro pública)
replace_extension	reemplaza la extensión (función miembro pública)
swap	intercambia dos rutas (función miembro pública)
Observadores de formato
c_str native operator string_type	devuelve la versión nativa de la ruta (función miembro pública)
string wstring u8string u16string u32string	devuelve la ruta en formato de nombre de ruta nativo convertido a una cadena (función miembro pública)
generic_string generic_wstring generic_u8string generic_u16string generic_u32string	devuelve la ruta en formato genérico de nombre de ruta convertida a una cadena (función miembro pública)
Comparar
compare	compara las representaciones léxicas de dos rutas lexicográficamente (función miembro pública)
Descomposición
root_name	devuelve el nombre raíz de la ruta, si está presente (función miembro pública)
root_directory	devuelve el directorio raíz de la ruta, si está presente (función miembro pública)
root_path	devuelve la ruta raíz de la ruta, si está presente (función miembro pública)
relative_path	devuelve la ruta relativa a la ruta raíz (función miembro pública)
parent_path	devuelve la ruta del directorio padre (función miembro pública)
filename	devuelve el componente de ruta del nombre de archivo (función miembro pública)
stem	devuelve el componente de ruta stem (función miembro pública)
extension	devuelve el componente de extensión de archivo de la ruta (función miembro pública)
Consultas
empty	verifica si la ruta está vacía (función miembro pública)
has_root_path has_root_name has_root_directory has_relative_path has_parent_path has_filename has_stem has_extension	verifica si el elemento de ruta correspondiente no está vacío (función miembro pública)
is_absolute is_relative	verifica si root_path() identifica de manera única una ubicación en el sistema de archivos (función miembro pública)
Iteradores
begin end	acceso de iterador a la ruta como una secuencia de elementos (función miembro pública)

Funciones no miembro

swap (std::experimental::filesystem::path)	intercambia dos rutas (función)
operator== operator!= operator< operator<= operator> operator>=	compara lexicográficamente dos rutas (función)
operator/	concatena dos rutas con un separador de directorio (función)
operator<< operator>>	realiza entrada y salida de flujo en una ruta (función)
u8path	crea un path desde una fuente codificada en UTF-8 (función)