создать сигнатуру функции, которая возвращает как истину, так и ложь, предоставляя детали при сбое

struct status {
    std::string msg;
    bool success;

    status(): success(true) {}
    status(std::string msg_): success(false), msg(msg_) {}

    explicit operator bool() const { return success; }

};

static status const success;

status func1() { return true; }
status func2() { return success; }
status func3() { return status("something went wrong); }

if (func1()) { std::cout << "success!" << std::endl; }
if (func1().success) { std::cout << "success!" << std::endl; }

auto rc = func3();
if (!rc) { std::cout << "error" << rc.msg << std::endl; }

То, что я сделал в одном случае, это вернуть функцию char const* с nullptr для успеха и сообщение об ошибке для отказа. Тем не менее, в этом случае функции были extern "C", поэтому у меня не было почти так много альтернатив. В C++ я бы, вероятно, определил класс и вернул его. Класс может иметь неявное преобразование в bool если вы хотите, но я не уверен, что это хорошая идея; У меня была бы succeeded функция, которая вернула bool: это намного яснее.

Обратите внимание, что даже в этом случае вам нужно сохранить возвращаемое значение в локальную переменную, чтобы дополнительная информация оставалась после обнаружения сбоя; вы не можете просто написать:

if ( remove( path ) ) {
    //  error
} else {
    //  success
}

но нужно написать:

Results results = remove( path );
if ( !results ) {
    //  error, do something with results.message()
} else {
    //  success
}

Также довольно болезненно, почти столько же, сколько попытка поймать.

Если у вас есть функция remove(), и целью этих целей является удаление вещей из файловой системы, мы должны ожидать, что она будет работать в обычном случае.

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

Я бы предложил:

void remove() {...}

И, называя это:

try
{
   remove("/home/olduser");
}
catch(std::runtime_error& e)
{
   std::cerr << "Failed to remove: " << e.what() << '\n';
}

Исключения являются частью языка по какой-либо причине, используют их.

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

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

Вы можете использовать что-то вроде

static bool remove( const string& path, tStatus& myStatus );

И определите tStatus как любой тип, который вы хотите возвращать как ошибки. Может быть так же просто, как typedef int tStatus;

Вы также можете позволить функции возвращать bool, а среди параметров вы передаете ссылку на структуру, которая может содержать причину. Как это:

bool remove(const string& path, FailReason* fr){
  //if the FailReason is a null pointer we don't fill it
  If(fr != 0);
}

Вы можете передать null в структуре fail

Вы можете использовать:

static bool remove(const string& path, std::nothrow_t);
static void remove(const string& path);