Класс FarFileName

Класс FarFileName представляет собой производный класс от FarString и реализует функции, которые часто бывают полезными при работе с именами файлов: разбиение путей на компоненты, составление путей из компонентов, преобразование между длинными и короткими именами файлов и т.д.

Методы

FarFileName()

FarFileName (const char *text)

FarFileName (const char *text, int length)

FarFileName (const FarString &str)

Конструкторы. Дублируют соответствующие конструкторы класса FarString.

void AddEndSlash()

Если строка имени файла не завершается обратной косой чертой, добавляет ее в конец строки.

void QuoteSpaceOnly()

Если строка имени файла содержит пробелы, заключает ее в кавычки.

FarFileName GetPath() const

Извлекает из строки полного имени файла путь и возвращает его. Если исходная строка заканчивается на обратную косую черту, возвращает ее копию.

FarFileName GetNameExt() const

Извлекает из строки полного имени файла имя и расширение и возвращает их. Если исходная строка заканчивается на обратную косую черту, возвращает пустую строку.

FarFileName GetExt() const

Извлекает из строки полного имени файла расширение и возвращает его. Расширением считается часть имени после последней точки. Если имя файла не содержит точек, возвращает строку из одного символа ".".

void SetPath (const char * path)

Заменяет путь в строке имени файла на указанный путь. Если путь содержит имя файла, это имя отбрасывается. В противном случае, путь должен обязательно заканчиваться на обратную косую черту.

void SetNameExt (const char * name)

Заменяет имя файла с расширением в строке имени файла на указанное имя с расширением. Если параметр name содержит путь, этот путь отбрасывается.

void SetExt (const char * ext)

Заменяет расширение в строке имени файла на расширение имени файла, переданного в параметре ext. (Параметр может содержать либо только расширение, начинающееся с точки, либо имя файла с расширением. В последнем случае имя отбрасывается и используется только расширение.)

FarFileName GetFullName() const

Возвращает полное имя файла (имя, содержащее путь от корня диска), соответствующее исходной строке.

FarFileName GetShortName() const

Возвращает краткое имя файла (имя в формате 8.3), соответствующее исходной строке.

static FarFileName MakeName (const FarString &path, const FarString &name)

Функция, предназначенная для конструирования полного имени файла из строки пути и строки имени файла с расширением. При необходимости между этими строками вставляется обратная косая черта.