File: error.adoc

package info (click to toggle)
boost1.90 1.90.0-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 593,120 kB
  • sloc: cpp: 4,190,908; xml: 196,648; python: 34,618; ansic: 23,145; asm: 5,468; sh: 3,774; makefile: 1,161; perl: 1,020; sql: 728; ruby: 676; yacc: 478; java: 77; lisp: 24; csh: 6
file content (36 lines) | stat: -rw-r--r-- 804 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
== `error.hpp`
[#error]

The error header provides two error categories:

[source,cpp]
----
// Errors used for utf8 <-> UCS-2 conversions.
enum utf8_conv_error
{
    insufficient_buffer = 1,
    invalid_character,
};

extern const error_category& get_utf8_category();
static const error_category& utf8_category = get_utf8_category();

extern const error_category& get_exit_code_category();

/// An error category that can be used to interpret exit codes of subprocesses.
static const error_category& exit_code_category = get_exit_code_category();

}
----

The `get_exit_code_category` can be used as follows:

[source,cpp]
----
void run_my_process(filesystem::path pt, error_code & ec)
{
  process proc(pt, {});
  proc.wait();
  ec.assign(proc.native_exit_code(), error::get_exit_code_category());
}
----