Здравствуйте.

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

Вот, что я имею ввиду.

Что Вы подумаете, когда увидите следующее объявление функции?

bool delete_file(const std::string& filename);

У меня, например, сразу же возникают вопросы на тему того, что же такое на самом деле filename. Например, должен ли это быть абсолютный или относительный путь? Или может быть указан и тот, и другой?

Или вот ещё:

std::string get_file_path();

Что вернёт эта функция? Путь до файла без имени самого файла? Или с именем, но без расширения? Или расширение тоже будет указано?

В общем, хотелось бы корректно различать и использовать в своём коде следующие ситуации:

— Путь до файла без имени самого файла
— Путь до файла с именем самого файла, но без расширения
— Путь до файла с именем самого файла и его расширением
— Абсолютный путь до файла с именем файла (я так понимаю, absolute_file_path)
— Относительный путь до файла с именем файла (я так понимаю, relative_file_path)
— Абсолютный или относительный путь до файла с именем файла
— etc

Подскажите, пожалуйста, кто как поступает в подобных ситуациях.

Может, есть какая-то наиболее корректная терминология по этому поводу?

Заранее благодарю за возможные ответы.