Classe basic_path

Artigo
06/09/2015

Define uma classe que armazena um objeto de tipo String do modelo que é adequado para uso como um nome de arquivo.

template<class String, class Traits>
class basic_path;

Comentários

A biblioteca define especializações desse modelo para dois tipos.

basic_path<string, path_traits>, com typedefpath, o usa std::string e a estrutura de path_traits .

basic_path<wstring, wpath_traits>, com typedefwpath, o usa std::wstring e a estrutura de wpath_traits .

Você pode usar um objeto do tipo path sempre que um argumento de tipo std::string é aceitável como um nome de arquivo.

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

Da mesma forma, você pode usar um objeto do tipo wpath sempre que um argumento de tipo std::wstring é aceitável como um nome de arquivo.

Um nome de arquivo armazenado consiste em um prefixo opcional, seguido por uma raiz opcional, seguido por um caminho relativo opcional.

Um prefixo consiste em todos os elementos que levam a e incluem o primeiro dois-pontos.
Uma raiz consiste em uma barra.
Um caminho relativo consiste em um ou mais elementos de caminho que são delimitados por sequências de barras.

Um iterador de nome de arquivo que é retornado por basic_path::begin designa o primeiro componente de nome de arquivo.

Um iterador X de nome de arquivo implica o seguinte.

X == end() indica o término da sequência de componentes de nome de arquivo.
*X retorna uma cadeia de caracteres que corresponde ao componente atual.
++X designa o próximo componente, se houver.
--X designa o componente anterior, se houver.

Membros

Typedefs Públicas

Nome	Descrição
basic_path::const_iterator	Um sinônimo de basic_path::iterator.
basic_path::external_string_type	Um sinônimo de Traits::external_string_type.
basic_path::iterator	Descreve um iterador de nome de arquivo que pode servir como um iterador bidirecional sobre os componentes de nome de arquivo armazenado.
basic_path::path_type	Um sinônimo de basic_path<String, Traits>.
basic_path::string_type	Um sinônimo para o parâmetro do modelo de String .
basic_path::traits_type	Um sinônimo para o parâmetro do modelo de Traits .
basic_path::value_type	Um sinônimo de String::value_type.

Construtores Públicos

Nome	Descrição
Construtor basic_path::basic_path	Constrói um objeto basic_path.

Métodos Públicos

Nome	Descrição
Método basic_path::append	Acrescenta elementos ao nome de arquivo armazenado.
Método basic_path::assign	Usa um conjunto especificado de elementos para substituir o nome do arquivo armazenado.
Método basic_path::basename	Retorna a subcadeia de caracteres de até folha mas não incluindo o ponto mais à direita.
Método basic_path::begin	Especifica o primeiro componente de nome de arquivo armazenado.
Método basic_path::branch_path	Recupera o caminho pai do objeto de basic_path .
Método basic_path::clear	Limpa a cadeia de caracteres armazenada de nome de arquivo.
Método basic_path::directory_string	Retorna o nome do arquivo armazenado.
Método basic_path::empty	Especifica se a cadeia de caracteres de nome de arquivo está vazio.
Método basic_path::end	Retorna um iterador de nome de arquivo pouco além do último componente no nome do arquivo armazenado.
Método basic_path::extension	Retorna a extensão de nome de arquivo armazenado, se existir.
Método basic_path::external_directory_string	Converte directory_string armazenado a external_string_type.
Método basic_path::external_file_string	Converte file_string armazenado a external_string_type.
Método basic_path::file_string	Retorna o nome do arquivo armazenado.
Método basic_path::filename	Recupera o nome do arquivo armazenado.
Método basic_path::has_branch_path	Especifica se o nome de arquivo armazenado contém um caminho de ramificação.
Método basic_path::has_filename	Especifica se a cadeia de caracteres armazenada contém um nome de arquivo.
Método basic_path::has_leaf	Especifica se o nome de arquivo armazenado contiver uma folha.
Método basic_path::has_parent_path	Especifica se o nome de arquivo armazenado contém um caminho pai.
Método basic_path::has_relative_path	Especifica se o nome de arquivo armazenado contém um caminho relativo.
Método basic_path::has_root_directory	Especifica se o nome de arquivo armazenado contiver um diretório raiz.
Método basic_path::has_root_name	Especifica se o nome de arquivo armazenado contém um nome raiz.
Método basic_path::has_root_path	Especifica se o nome de arquivo armazenado contém um caminho raiz.
Método basic_path::is_complete	Especifica se o nome de arquivo armazenado está cheio.
Método basic_path::leaf	Recupera o nome do arquivo armazenado.
Método basic_path::parent_path	Recupera o caminho pai do objeto de basic_path .
Método basic_path::relative_path	Recupera o caminho relativo do nome do arquivo armazenado.
Método basic_path::remove_filename	Remove o elemento o mais recente do caminho no caminho relativo, se existir.
Método basic_path::remove_leaf	Remove o elemento o mais recente do caminho no caminho relativo, se existir.
Método basic_path::replace_extension	Substitui a extensão de nome de arquivo do nome de arquivo armazenado.
Método basic_path::root_directory	Retorna a raiz, se ela existir.
Método basic_path::root_name	Retorna o prefixo, se ele existir.
Método basic_path::root_path	Recupera o caminho da raiz do nome de arquivo armazenado.
Método basic_path::stem	Retorna a subcadeia de caracteres de até folha mas não incluindo o ponto mais à direita.
Método basic_path::string	Retorna o nome do arquivo armazenado.
Método basic_path::swap	Alterna o nome de arquivo armazenado com o nome de um objeto especificado de basic_path .

Operadores Públicos

Nome	Descrição
Operador basic_path::operator string_type	Retorna o nome do arquivo armazenado.
Operador basic_path::operator/=	Acrescenta uma série de elementos ao nome do arquivo armazenado.
Operador basic_path::operator=	Aloca um novo valor para o nome de arquivo armazenado.

Requisitos

Cabeçalho: sistema de arquivos

Namespace: std::tr2::sys

Consulte também

Referência

Outros recursos

Arquivos de cabeçalho da Biblioteca Padrão C++

Partilhar via