summaryrefslogtreecommitdiff
path: root/chromium/net/base/hex_utils.h
blob: 295091e0d2cda2923d81ef8cabf1515698ba3d45 (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
25
26
27
28
29
30
31
32
33
34
// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef NET_BASE_HEX_UTILS_H_
#define NET_BASE_HEX_UTILS_H_

#include <string>

#include "base/strings/string_piece.h"
#include "net/base/net_export.h"

namespace net {

// Use base::HexEncode() for encoding to hex representation.

// Decode a hex representation like "666f6f" to a string like "foo".  Crashes on
// invalid input in debug builds, therefore it must only be used on sanitized
// input (like a constant literal).  If validity of input needs to be checked or
// partial decoding is desired, use base::HexStringToString() instead.
NET_EXPORT_PRIVATE std::string HexDecode(base::StringPiece hex);

// Return a std::string containing hex and ASCII representations of the binary
// buffer |input|, with offsets at the beginning of each line, in the style of
// hexdump.  Non-printable characters will be shown as '.' in the ASCII output.
// Example output:
// "0x0000:  0090 69bd 5400 000d 610f 0189 0800 4500  ..i.T...a.....E.\n"
// "0x0010:  001c fb98 4000 4001 7e18 d8ef 2301 455d  ....@.@.~...#.E]\n"
// "0x0020:  7fe2 0800 6bcb 0bc6 806e                 ....k....n\n"
NET_EXPORT_PRIVATE std::string HexDump(base::StringPiece input);

}  // namespace net

#endif  // NET_BASE_HEX_UTILS_H_