clase de basic_path

Define una clase que almacena un objeto de tipo String de plantilla que es adecuado para su uso como nombre de archivo.

template<class String, class Traits>
class basic_path;

Comentarios

La biblioteca define especializaciones de esta plantilla para dos tipos.

basic_path<string, path_traits>, con typedefpath, utiliza std::string y la estructura de path_traits.

basic_path<wstring, wpath_traits>, con typedefwpath, utiliza std::wstring y la estructura de wpath_traits.

Puede utilizar un objeto de path tipo siempre que un argumento de std::string tipo es aceptable como nombre de archivo.

std::tr2::sys::path myfile(“abc.txt”);
std::ofstream ofs(myfile);
ofs << “hello\n”;
ofs.close();

De igual forma, puede utilizar un objeto de wpath tipo siempre que un argumento de std::wstring tipo es aceptable como nombre de archivo.

Un nombre de archivo almacenado se compone de un prefijo opcional, seguido de una raíz opcional, seguida de una ruta de acceso relativa opcional.

• Un prefijo consta de todos los elementos que lleven a e incluye los primeros dos puntos.

• Una raíz consta de una barra diagonal.

• Una ruta de acceso relativa consta de uno o más elementos de ruta que están delimitados por secuencias de barras diagonales.

Un iterador de nombre de archivo devuelto por basic_path::begin señala al primer componente de nombre de archivo.

Un iterador X filename implica siguiente.

• X == end() indica el final de la secuencia de componentes de nombre de archivo.

• *X devuelve una cadena que coincida con el componente actual.

• ++X señala al componente siguiente, si existe.

• --X señala el componente anterior, si existe.

Members

Typedefs públicas

Nombre	Descripción
basic_path::const_iterator	Un sinónimo de basic_path::iterator.
basic_path::external_string_type	Un sinónimo de Traits::external_string_type.
basic_path::iterator	Describe un iterador de nombre de archivo que puede actuar como iterador bidireccional sobre los componentes del nombre de archivo almacenado.
basic_path::path_type	Un sinónimo de basic_path<String, Traits>.
basic_path::string_type	Un sinónimo para el parámetro de plantilla de String.
basic_path::traits_type	Un sinónimo para el parámetro de plantilla de Traits.
basic_path::value_type	Un sinónimo de String::value_type.

Constructores públicos

Nombre	Descripción
basic_path::basic_path Constructor	Crea un objeto basic_path.

Métodos públicos

Nombre	Descripción
método de basic_path::append	Anexa elementos al archivo almacenado.
método de basic_path::assign	Utiliza un conjunto especificado de elementos para reemplazar el nombre de archivo almacenado.
método de basic_path::basename	Devuelve la subcadena de hoja hasta pero sin incluir el punto derecho.
método de basic_path::begin	Especifica el primer componente de nombre de archivo almacenado.
método de basic_path::branch_path	Recupera la ruta principal del objeto de basic_path.
método basic_path::clear	Borra la cadena almacenada de nombre de archivo.
método basic_path::directory_string	Devuelve el nombre de archivo almacenado.
método basic_path::empty	Especifica si la cadena de nombre de archivo está vacía.
método de basic_path::end	Devuelve un iterador de nombre de archivo simplemente más allá del componente pasado en el nombre de archivo almacenado.
método de basic_path::extension	Devuelve la extensión de nombre de archivo almacenado, si existe.
método basic_path::external_directory_string	Convierte el directory_string almacenado a external_string_type.
método basic_path::external_file_string	Convierte el file_string almacenado a external_string_type.
método basic_path::file_string	Devuelve el nombre de archivo almacenado.
método de basic_path::filename	Recupera el nombre de archivo almacenado.
método de basic_path::has_branch_path	Especifica si el nombre de archivo almacenado contiene una ruta de acceso de la bifurcación.
método de basic_path::has_filename	Especifica si la cadena almacenada contiene un nombre de archivo.
método de basic_path::has_leaf	Especifica si el nombre de archivo almacenado contiene una hoja.
método de basic_path::has_parent_path	Especifica si el nombre de archivo almacenado contiene una ruta primaria.
método de basic_path::has_relative_path	Especifica si el nombre de archivo almacenado contiene una ruta de acceso relativa.
método basic_path::has_root_directory	Especifica si el nombre de archivo almacenado contiene un directorio raíz.
método de basic_path::has_root_name	Especifica si el nombre de archivo almacenado contiene un nombre de raíz.
método de basic_path::has_root_path	Especifica si el nombre de archivo almacenado contiene una ruta raíz.
método de basic_path::is_complete	Especifica si el nombre de archivo almacenado está completo.
método de basic_path::leaf	Recupera el nombre de archivo almacenado.
método de basic_path::parent_path	Recupera la ruta principal del objeto de basic_path.
método de basic_path::relative_path	Recupera la ruta de acceso relativa del nombre de archivo almacenado.
método de basic_path::remove_filename	Quita el último elemento de la ruta en la ruta de acceso relativa, si existe.
método de basic_path::remove_leaf	Quita el último elemento de la ruta en la ruta de acceso relativa, si existe.
método de basic_path::replace_extension	Reemplaza la extensión de nombre de archivo del nombre de archivo almacenado.
método basic_path::root_directory	Devuelve la raíz, si existe.
método de basic_path::root_name	Devuelve el prefijo, si existe.
método de basic_path::root_path	Recupera la ruta de acceso raíz de nombre de archivo almacenado.
método de basic_path::stem	Devuelve la subcadena de hoja hasta pero sin incluir el punto derecho.
método basic_path::string	Devuelve el nombre de archivo almacenado.
método de basic_path::swap	Cambia el nombre de archivo almacenado con el nombre de un objeto especificado de basic_path.

Operadores públicos

Nombre	Descripción
operador de string_type de basic_path::operator	Devuelve el nombre de archivo almacenado.
operador de basic_path::operator/=	Anexa una serie de elementos al archivo almacenado.
operador de basic_path::operator=	Asigna un nuevo valor al nombre de archivo almacenado.

Requisitos

El sistema de archivos Encabezado:

Espacio de nombres: std::tr2::sys

Vea también

Referencia

<filesystem>

Otros recursos

Archivos de encabezado