std::errc
Материал из cppreference.com
<tbody>
</tbody>
| Определено в заголовочном файле <system_error>
|
||
enum class errc; |
(начиная с C++11) | |
Перечисление с областью видимости std::errc определяет значения переносимых ошибок, которые соответствуют кодам ошибок POSIX.
Константы-элементы
| Константа | Эквивалентная Ошибка POSIX |
address_family_not_supported
|
EAFNOSUPPORT
|
address_in_use
|
EADDRINUSE
|
address_not_available
|
EADDRNOTAVAIL
|
already_connected
|
EISCONN
|
argument_list_too_long
|
E2BIG
|
argument_out_of_domain
|
EDOM
|
bad_address
|
EFAULT
|
bad_file_descriptor
|
EBADF
|
bad_message
|
EBADMSG
|
broken_pipe
|
EPIPE
|
connection_aborted
|
ECONNABORTED
|
connection_already_in_progress
|
EALREADY
|
connection_refused
|
ECONNREFUSED
|
connection_reset
|
ECONNRESET
|
cross_device_link
|
EXDEV
|
destination_address_required
|
EDESTADDRREQ
|
device_or_resource_busy
|
EBUSY
|
directory_not_empty
|
ENOTEMPTY
|
executable_format_error
|
ENOEXEC
|
file_exists
|
EEXIST
|
file_too_large
|
EFBIG
|
filename_too_long
|
ENAMETOOLONG
|
function_not_supported
|
ENOSYS
|
host_unreachable
|
EHOSTUNREACH
|
identifier_removed
|
EIDRM
|
illegal_byte_sequence
|
EILSEQ
|
inappropriate_io_control_operation
|
ENOTTY
|
interrupted
|
EINTR
|
invalid_argument
|
EINVAL
|
invalid_seek
|
ESPIPE
|
io_error
|
EIO
|
is_a_directory
|
EISDIR
|
message_size
|
EMSGSIZE
|
network_down
|
ENETDOWN
|
network_reset
|
ENETRESET
|
network_unreachable
|
ENETUNREACH
|
no_buffer_space
|
ENOBUFS
|
no_child_process
|
ECHILD
|
no_link
|
ENOLINK
|
no_lock_available
|
ENOLCK
|
no_message_available (устарело)
|
ENODATA
|
no_message
|
ENOMSG
|
no_protocol_option
|
ENOPROTOOPT
|
no_space_on_device
|
ENOSPC
|
no_stream_resources (устарело)
|
ENOSR
|
no_such_device_or_address
|
ENXIO
|
no_such_device
|
ENODEV
|
no_such_file_or_directory
|
ENOENT
|
no_such_process
|
ESRCH
|
not_a_directory
|
ENOTDIR
|
not_a_socket
|
ENOTSOCK
|
not_a_stream (устарело)
|
ENOSTR
|
not_connected
|
ENOTCONN
|
not_enough_memory
|
ENOMEM
|
not_supported
|
ENOTSUP
|
operation_canceled
|
ECANCELED
|
operation_in_progress
|
EINPROGRESS
|
operation_not_permitted
|
EPERM
|
operation_not_supported
|
EOPNOTSUPP
|
operation_would_block
|
EWOULDBLOCK
|
owner_dead
|
EOWNERDEAD
|
permission_denied
|
EACCES
|
protocol_error
|
EPROTO
|
protocol_not_supported
|
EPROTONOSUPPORT
|
read_only_file_system
|
EROFS
|
resource_deadlock_would_occur
|
EDEADLK
|
resource_unavailable_try_again
|
EAGAIN
|
result_out_of_range
|
ERANGE
|
state_not_recoverable
|
ENOTRECOVERABLE
|
stream_timeout (устарело)
|
ETIME
|
text_file_busy
|
ETXTBSY
|
timed_out
|
ETIMEDOUT
|
too_many_files_open_in_system
|
ENFILE
|
too_many_files_open
|
EMFILE
|
too_many_links
|
EMLINK
|
too_many_symbolic_link_levels
|
ELOOP
|
value_too_large
|
EOVERFLOW
|
wrong_protocol_type
|
EPROTOTYPE
|
Функции, не являющиеся элементами
(C++11) |
создаёт код ошибки std::errc (функция) |
создаёт условие ошибки для errc значения e (функция) |
Вспомогательные классы
| расширяет свойство типа std::is_error_condition_enum для идентификации значений std::errc как условий ошибок (шаблон функции) |
Пример
Запустить этот код
#include <iostream>
#include <system_error>
#include <string>
#include <thread>
#include <fstream>
#include <filesystem>
void print_error(const std::string& details, std::error_code error_code)
{
std::string value_name;
if (error_code == std::errc::invalid_argument)
value_name = "std::errc::invalid_argument";
if (error_code == std::errc::no_such_file_or_directory)
value_name = "std::errc::no_such_file_or_directory";
if (error_code == std::errc::is_a_directory)
value_name = "std::errc::is_a_directory";
if (error_code == std::errc::permission_denied)
value_name = "std::errc::permission_denied";
std::cout << details << ": \"" << error_code.message() << "\" ("
<< value_name << ") \n";
}
void print_errno(const std::string& details, int errno_value = errno)
{
print_error(details, std::make_error_code(std::errc(errno_value)));
}
int main()
{
// Отсоединение потока
try
{
std::thread().detach();
}
catch (const std::system_error& e)
{
print_error("Ошибка отсоединения пустого потока", e.code());
}
// Открытие несуществующего файла
{
std::ifstream nofile("несуществующий файл");
if (!nofile.is_open())
{
print_errno("Ошибка открытия несуществующего файла для чтения");
}
}
// Чтение из каталога как файла
{
std::filesystem::create_directory("dir");
std::ifstream dir_stream("dir");
[[maybe_unused]] char c = dir_stream.get();
if (!dir_stream.good())
{
print_errno("Ошибка чтения данных из каталога");
}
}
// Открыть файл только для чтения для записи
{
{
std::fstream new_file("readonly-file", std::ios::out);
}
std::filesystem::permissions("readonly-file", std::filesystem::perms::owner_read);
std::fstream write_readonly("readonly-file", std::ios::out);
if (!write_readonly.is_open())
{
print_errno("Ошибка открытия файла только для чтения для записи");
}
}
}
Возможный вывод:
Ошибка отсоединения пустого потока: "Invalid argument" (std::errc::invalid_argument)
Ошибка открытия несуществующего файла для чтения: "No such file or directory" (std::errc::no_such_file_or_directory)
Ошибка чтения данных из каталога: "Is a directory" (std::errc::is_a_directory)
Ошибка открытия файла только для чтения для записи: "Permission denied" (std::errc::permission_denied)
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
| Номер | Применён | Поведение в стандарте | Корректное поведение |
|---|---|---|---|
| LWG 3869 | C++11 | константы-элементы no_message_available, no_stream_resources,not_a_stream и stream_timeout относятся к устаревшему API POSIX ПОТОКОВ[1]
|
объявлены устаревшими |
- ↑ Хотя соответствующие номера ошибок POSIX ENODATA, ENOSR, ENOSTR и ETIME были помечены как "устаревшие" в POSIX 2017, API ПОТОКОВ был необязательным и не требовался для соответствия предыдущему стандарту POSIX (поскольку популярные unix-подобные системы отказывались его реализовывать).
Смотрите также
(C++11) |
содержит код ошибки, зависящий от платформы (класс) |
(C++11) |
содержит переносимый код ошибки (класс) |
