Класс basic_path

Статья
06/09/2015

Определяет класс, который содержит объект типа String шаблона, подходит для использования в качестве имени файла.

template<class String, class Traits>
class basic_path;

Заметки

Библиотека определяет специализации этого шаблона для 2 типов.

basic_path<string, path_traits>, с typedefpath, используется std::string и структуры path_traits.

basic_path<wstring, wpath_traits>, с typedefwpath, используется std::wstring и структуры wpath_traits.

Можно использовать объект типа path везде, где аргумент типа std::string допустим в качестве имени файла.

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

Аналогично можно использовать объект типа wpath везде, где аргумент типа std::wstring допустим в качестве имени файла.

Сохраненный имя файла состоит из необязательного префикса, затем необязательным корень, одну необязательным именем относительного пути.

Префикс состоит из всех элементов, которые поддерживают до и включают первое двоеточие.
Корень состоит из одной косой черты.
Относительный путь состоит из одного или нескольких элементов пути, разделенных косой черты последовательностями.

Итератор имени файла, возвращаемый basic_path::begin указывает первый компонент имени файла.

Итератор X имени файла означает следующее.

X == end() указывает конец последовательности компонентов имени файла.
*X возвращает строку, которая соответствует текущему компоненту.
++X обозначает следующий компонент, если в настоящий момент.
--X обозначает предшествующий компонент, если в настоящий момент.

Члены

Общедоступные Typedefs

Name	Описание
basic_path::const_iterator	Синоним для basic_path::iterator.
basic_path::external_string_type	Синоним для Traits::external_string_type.
basic_path::iterator	Описывает итератор имени файла, который можно использовать как двунаправленный итератор с компонентами, хранящихся имени файла.
basic_path::path_type	Синоним для basic_path<String, Traits>.
basic_path::string_type	Синоним для параметра шаблона String.
basic_path::traits_type	Синоним для параметра шаблона Traits.
basic_path::value_type	Синоним для String::value_type.

Открытые конструкторы

Name	Описание
Конструктор basic_path::basic_path	Создает объект basic_path.

Открытые методы

Name	Описание
Метод basic_path::append	Добавляет элементы на хранимый имени файла.
Метод basic_path::assign	Использует указанный набор элементов, чтобы заменить, хранящихся имя файла.
Метод basic_path::basename	Возвращает подстроку является листом до, но не включая крайней правой точки.
Метод basic_path::begin	Определяет первый компонент, хранящихся имени файла.
Метод basic_path::branch_path	Возвращает родительский путь объекта basic_path.
Метод basic_path::clear	Удаляет, сохраненную строку имени файла.
Метод basic_path::directory_string	Возвращает имя сохраненного файла.
Метод basic_path::empty	Определяет, является ли строка имени файла пустой.
Метод basic_path::end	Возвращает итератор имени файла только за последним компонентом, хранящиеся в имени файла.
Метод basic_path::extension	Возвращает сохраненный расширение имени файла, если он существует.
Метод basic_path::external_directory_string	Преобразование, хранящиеся в directory_stringexternal_string_type.
Метод basic_path::external_file_string	Преобразование, хранящиеся в file_stringexternal_string_type.
Метод basic_path::file_string	Возвращает имя сохраненного файла.
Метод basic_path::filename	Извлекает сохраненный имя файла.
Метод basic_path::has_branch_path	Определяет, содержит ли сохраненный имя файла путь ветви.
Метод basic_path::has_filename	Определяет, содержит ли сохраненную строку имя файла.
Метод basic_path::has_leaf	Определяет, содержит ли сохраненный имя файла является конечным.
Метод basic_path::has_parent_path	Определяет, содержит ли сохраненный имя файла родительский путь.
Метод basic_path::has_relative_path	Определяет, содержит ли сохраненный имя файла относительный путь.
Метод basic_path::has_root_directory	Определяет, содержит ли сохраненный имя файла корневого каталога.
Метод basic_path::has_root_name	Определяет, содержит ли сохраненный имя файла корневое имя.
Метод basic_path::has_root_path	Определяет, содержит ли сохраненный имя файла корневой путь.
Метод basic_path::is_complete	Определяет, является ли сохраняют имя файла завершено.
Метод basic_path::leaf	Извлекает сохраненный имя файла.
Метод basic_path::parent_path	Возвращает родительский путь объекта basic_path.
Метод basic_path::relative_path	Извлекает относительный путь сохраненного имени файла.
Метод basic_path::remove_filename	Удаляет последний элемент пути в относительном пути, если он существует.
Метод basic_path::remove_leaf	Удаляет последний элемент пути в относительном пути, если он существует.
Метод basic_path::replace_extension	Заменяет расширение имени файла, хранящихся имени файла.
Метод basic_path::root_directory	Возвращает корневой каталог, если он существует.
Метод basic_path::root_name	Возвращает префикс, если он существует.
Метод basic_path::root_path	Извлекает укорените путь сохраненного имени файла.
Метод basic_path::stem	Возвращает подстроку является листом до, но не включая крайней правой точки.
Метод basic_path::string	Возвращает имя сохраненного файла.
Метод basic_path::swap	Замена, хранящихся имя файла с именем файла из указанного объекта basic_path.

Открытые операторы

Name	Описание
Оператор basic_path::operator string_type	Возвращает имя сохраненного файла.
Оператор basic_path::operator/=	Добавляет набор элементов, хранящихся в имени файла.
Оператор basic_path::operator=	Присвоить новое значение на хранимый имени файла.

Требования

Заголовок: filesystem

Пространство имен: std::tr2::sys

См. также

Ссылки

Другие ресурсы

Файлы заголовков стандартных библиотек C++

Поделиться через