Classe basic_path

Artigo
03/27/2013

Define uma classe que armazena um objeto do 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, usa std::string e a estrutura de path_traits .

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

Você pode usar um objeto do tipo path em qualquer lugar 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 em qualquer lugar 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 das 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 indica o seguinte.

X == end() indica o fim da sequência de componentes de nome de arquivo.
*X retorna uma cadeia de caracteres correponde o componente atual.
++X designa o componente seguir, se presente.
--X designa o componente anterior, se presente.

Membros

Typedefs Públicas

Nome	Descrição
basic_path::const_iterator	Um sinónimo para basic_path::iterator.
basic_path::external_string_type	Um sinónimo para 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 para 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 para String::value_type.

Construtores Públicos

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

Métodos Públicos

Nome	Descrição
Método basic_path::append	Acrescenta elementos para o nome de arquivo armazenado.
Método basic_path::Assign	Usa um conjunto específico de elementos para substituir o nome de arquivo armazenado.
Método basic_path::basename	Retorna a subcadeia de caracteres de folha até 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	Retorna 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 de arquivo armazenado.
Método basic_path::Empty	Especifica se a cadeia de caracteres de nome de arquivo está vazia.
Método basic_path::end	Retorna um iterador de nome de arquivo apenas além de componente ao último no nome de 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 de arquivo armazenado.
Método basic_path::filename	Recupera o nome de arquivo armazenado.
Método basic_path::has_branch_path	Especifica se o nome de arquivo armazenado contém um caminho da 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 contém 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 contém um diretório raiz.
Método basic_path::has_root_name	Especifica se o nome de arquivo armazenado contém um nome de 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 é concluída.
Método basic_path::Leaf	Recupera o nome de arquivo armazenado.
Método basic_path::parent_path	Retorna o caminho pai do objeto de basic_path .
Método basic_path::RELATIVE_PATH	Retorna o caminho relativo de nome de arquivo armazenado.
Método basic_path::remove_filename	Remove o elemento mais recente do caminho no caminho relativo, se existir.
Método basic_path::remove_leaf	Remove o elemento mais recente do caminho no caminho relativo, se existir.
Método basic_path::replace_extension	Substitui a extensão do nome de arquivo armazenado.
Método basic_path::root_directory	Retorna a raiz, se existir.
Método basic_path::root_name	Retorna o prefixo, se existir.
Método basic_path::root_path	Retorna o caminho raiz de nome de arquivo armazenado.
Método basic_path::Stem	Retorna a subcadeia de caracteres de folha até mas não incluindo o ponto mais à direita.
Método basic_path::String	Retorna o nome de arquivo armazenado.
Método basic_path::swap	Alterna o nome de arquivo armazenado com o nome de arquivo de um objeto especificado de basic_path .

Operadores Públicos

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

Requisitos

o sistema de arquivos deCabeçalho:

Namespace: std::tr2::sys

Consulte também

Referência

Outros recursos

Arquivos de cabeçalho

Compartilhar via