aboutsummaryrefslogtreecommitdiff
path: root/src/libutil/escape-char.hh
blob: e4b9da8ed6e2b0b85bb6c3b48d26c7b96c5c2d04 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
#pragma once
///@file

#include <ostream>

namespace nix {

/**
 * A struct that prints a debug representation of a character, like `\x1f` for
 * non-printable characters, or the character itself for other characters.
 *
 * Note that these are suitable for human readable output, but further care is
 * necessary to include them in C++ strings to avoid running into adjacent
 * hex-like characters. (`"puppy\x1bdoggy"` parses as `"puppy" "\x1bd" "oggy"`
 * and errors because 0x1bd is too big for a `char`.)
 */
struct MaybeHexEscapedChar
{
    char c;
};

std::ostream & operator<<(std::ostream & s, MaybeHexEscapedChar c);

} // namespace nix