Bitcoin ABC  0.26.3
P2P Digital Currency
Enumerations | Functions
strencodings.h File Reference
#include <span.h>
#include <cstdint>
#include <iterator>
#include <string>
#include <vector>
Include dependency graph for strencodings.h:

Go to the source code of this file.

Enumerations

enum  SafeChars { SAFE_CHARS_DEFAULT , SAFE_CHARS_UA_COMMENT , SAFE_CHARS_FILENAME , SAFE_CHARS_URI }
 Utilities for converting data from/to strings. More...
 

Functions

std::string SanitizeString (const std::string &str, int rule=SAFE_CHARS_DEFAULT)
 Remove unsafe chars. More...
 
std::vector< uint8_t > ParseHex (const char *psz)
 
std::vector< uint8_t > ParseHex (const std::string &str)
 
signed char HexDigit (char c)
 
bool IsHex (const std::string &str)
 Returns true if each character in str is a hex character, and has an even number of hex digits. More...
 
bool IsHexNumber (const std::string &str)
 Return true if the string is a hex number, optionally prefixed with "0x". More...
 
std::vector< uint8_t > DecodeBase64 (const char *p, bool *pf_invalid=nullptr)
 
std::string DecodeBase64 (const std::string &str, bool *pf_invalid=nullptr)
 
std::string EncodeBase64 (Span< const uint8_t > input)
 
std::string EncodeBase64 (Span< const std::byte > input)
 
std::string EncodeBase64 (const std::string &str)
 
std::vector< uint8_t > DecodeBase32 (const char *p, bool *pf_invalid=nullptr)
 
std::string DecodeBase32 (const std::string &str, bool *pf_invalid=nullptr)
 
std::string EncodeBase32 (Span< const uint8_t > input, bool pad=true)
 Base32 encode. More...
 
std::string EncodeBase32 (const std::string &str, bool pad=true)
 Base32 encode. More...
 
void SplitHostPort (std::string in, uint16_t &portOut, std::string &hostOut)
 
int64_t atoi64 (const std::string &str)
 
int atoi (const std::string &str)
 
constexpr bool IsDigit (char c)
 Tests if the given character is a decimal digit. More...
 
constexpr bool IsSpace (char c) noexcept
 Tests if the given character is a whitespace character. More...
 
bool ParseInt32 (const std::string &str, int32_t *out)
 Convert string to signed 32-bit integer with strict parse error feedback. More...
 
bool ParseInt64 (const std::string &str, int64_t *out)
 Convert string to signed 64-bit integer with strict parse error feedback. More...
 
bool ParseUInt8 (const std::string &str, uint8_t *out)
 Convert decimal string to unsigned 8-bit integer with strict parse error feedback. More...
 
bool ParseUInt16 (const std::string &str, uint16_t *out)
 Convert decimal string to unsigned 16-bit integer with strict parse error feedback. More...
 
bool ParseUInt32 (const std::string &str, uint32_t *out)
 Convert decimal string to unsigned 32-bit integer with strict parse error feedback. More...
 
bool ParseUInt64 (const std::string &str, uint64_t *out)
 Convert decimal string to unsigned 64-bit integer with strict parse error feedback. More...
 
bool ParseDouble (const std::string &str, double *out)
 Convert string to double with strict parse error feedback. More...
 
std::string HexStr (const Span< const uint8_t > s)
 Convert a span of bytes to a lower-case hexadecimal string. More...
 
std::string HexStr (const Span< const char > s)
 
std::string HexStr (const Span< const std::byte > s)
 
std::string FormatParagraph (const std::string &in, size_t width=79, size_t indent=0)
 Format a paragraph of text to a fixed width, adding spaces for indentation to any added line. More...
 
template<typename T >
bool TimingResistantEqual (const T &a, const T &b)
 Timing-attack-resistant comparison. More...
 
bool ParseFixedPoint (const std::string &val, int decimals, int64_t *amount_out)
 Parse number as fixed point according to JSON number syntax. More...
 
template<int frombits, int tobits, bool pad, typename O , typename I >
bool ConvertBits (const O &outfn, I it, I end)
 Convert from one power-of-2 number base to another. More...
 
constexpr char ToLower (char c)
 Converts the given character to its lowercase equivalent. More...
 
std::string ToLower (const std::string &str)
 Returns the lowercase equivalent of the given string. More...
 
constexpr char ToUpper (char c)
 Converts the given character to its uppercase equivalent. More...
 
std::string ToUpper (const std::string &str)
 Returns the uppercase equivalent of the given string. More...
 
std::string Capitalize (std::string str)
 Capitalizes the first character of the given string. More...
 

Enumeration Type Documentation

◆ SafeChars

enum SafeChars

Utilities for converting data from/to strings.

Used by SanitizeString()

Enumerator
SAFE_CHARS_DEFAULT 

The full set of allowed chars.

SAFE_CHARS_UA_COMMENT 

BIP-0014 subset.

SAFE_CHARS_FILENAME 

Chars allowed in filenames.

SAFE_CHARS_URI 

Chars allowed in URIs (RFC 3986)

Definition at line 20 of file strencodings.h.

Function Documentation

◆ atoi()

int atoi ( const std::string &  str)

Definition at line 483 of file strencodings.cpp.

Here is the caller graph for this function:

◆ atoi64()

int64_t atoi64 ( const std::string &  str)

Definition at line 475 of file strencodings.cpp.

Here is the caller graph for this function:

◆ Capitalize()

std::string Capitalize ( std::string  str)

Capitalizes the first character of the given string.

This function is locale independent. It only converts lowercase characters in the standard 7-bit ASCII range. This is a feature, not a limitation.

Parameters
[in]strthe string to capitalize.
Returns
string with the first letter capitalized.

Definition at line 654 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConvertBits()

template<int frombits, int tobits, bool pad, typename O , typename I >
bool ConvertBits ( const O &  outfn,
it,
end 
)

Convert from one power-of-2 number base to another.

If padding is enabled, this always return true. If not, then it returns true of all the bits of the input are encoded in the output.

Definition at line 214 of file strencodings.h.

◆ DecodeBase32() [1/2]

std::vector<uint8_t> DecodeBase32 ( const char *  p,
bool *  pf_invalid = nullptr 
)

Definition at line 231 of file strencodings.cpp.

Here is the caller graph for this function:

◆ DecodeBase32() [2/2]

std::string DecodeBase32 ( const std::string &  str,
bool *  pf_invalid = nullptr 
)

Definition at line 282 of file strencodings.cpp.

Here is the call graph for this function:

◆ DecodeBase64() [1/2]

std::vector<uint8_t> DecodeBase64 ( const char *  p,
bool *  pf_invalid = nullptr 
)

Definition at line 150 of file strencodings.cpp.

Here is the caller graph for this function:

◆ DecodeBase64() [2/2]

std::string DecodeBase64 ( const std::string &  str,
bool *  pf_invalid = nullptr 
)

Definition at line 201 of file strencodings.cpp.

Here is the call graph for this function:

◆ EncodeBase32() [1/2]

std::string EncodeBase32 ( const std::string &  str,
bool  pad = true 
)

Base32 encode.

If pad is true, then the output will be padded with '=' so that its length is a multiple of 8.

Definition at line 227 of file strencodings.cpp.

Here is the call graph for this function:

◆ EncodeBase32() [2/2]

std::string EncodeBase32 ( Span< const uint8_t >  input,
bool  pad = true 
)

Base32 encode.

If pad is true, then the output will be padded with '=' so that its length is a multiple of 8.

Definition at line 212 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ EncodeBase64() [1/3]

std::string EncodeBase64 ( const std::string &  str)
inline

Definition at line 59 of file strencodings.h.

Here is the call graph for this function:

◆ EncodeBase64() [2/3]

std::string EncodeBase64 ( Span< const std::byte >  input)
inline

Definition at line 56 of file strencodings.h.

Here is the call graph for this function:

◆ EncodeBase64() [3/3]

std::string EncodeBase64 ( Span< const uint8_t >  input)

Definition at line 136 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ FormatParagraph()

std::string FormatParagraph ( const std::string &  in,
size_t  width = 79,
size_t  indent = 0 
)

Format a paragraph of text to a fixed width, adding spaces for indentation to any added line.

Definition at line 435 of file strencodings.cpp.

Here is the caller graph for this function:

◆ HexDigit()

signed char HexDigit ( char  c)

Definition at line 59 of file strencodings.cpp.

Here is the caller graph for this function:

◆ HexStr() [1/3]

std::string HexStr ( const Span< const char >  s)
inline

Definition at line 168 of file strencodings.h.

Here is the call graph for this function:

◆ HexStr() [2/3]

std::string HexStr ( const Span< const std::byte >  s)
inline

Definition at line 171 of file strencodings.h.

Here is the call graph for this function:

◆ HexStr() [3/3]

std::string HexStr ( const Span< const uint8_t >  s)

Convert a span of bytes to a lower-case hexadecimal string.

Definition at line 662 of file strencodings.cpp.

Here is the call graph for this function:

◆ IsDigit()

constexpr bool IsDigit ( char  c)
constexpr

Tests if the given character is a decimal digit.

Parameters
[in]ccharacter to test
Returns
true if the argument is a decimal digit; otherwise false.

Definition at line 88 of file strencodings.h.

Here is the caller graph for this function:

◆ IsHex()

bool IsHex ( const std::string &  str)

Returns true if each character in str is a hex character, and has an even number of hex digits.

Definition at line 63 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ IsHexNumber()

bool IsHexNumber ( const std::string &  str)

Return true if the string is a hex number, optionally prefixed with "0x".

Definition at line 72 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ IsSpace()

constexpr bool IsSpace ( char  c)
inlineconstexprnoexcept

Tests if the given character is a whitespace character.

The whitespace characters are: space, form-feed ('\f'), newline ('
'), carriage return ('\r'), horizontal tab ('\t'), and vertical tab ('\v').

This function is locale independent. Under the C locale this function gives the same result as std::isspace.

Parameters
[in]ccharacter to test
Returns
true if the argument is a whitespace character; otherwise false

Definition at line 104 of file strencodings.h.

Here is the caller graph for this function:

◆ ParseDouble()

bool ParseDouble ( const std::string &  str,
double *  out 
)

Convert string to double with strict parse error feedback.

Returns
true if the entire string could be parsed as valid double, false if not the entire string could be parsed or when overflow or underflow occurred.

Definition at line 417 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseFixedPoint()

bool ParseFixedPoint ( const std::string &  val,
int  decimals,
int64_t *  amount_out 
)

Parse number as fixed point according to JSON number syntax.

See http://json.org/number.gif

Returns
true on success, false on error.
Note
The result must be in the range (-10^18,10^18), otherwise an overflow error will trigger.

Definition at line 517 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseHex() [1/2]

std::vector<uint8_t> ParseHex ( const char *  psz)

Definition at line 86 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseHex() [2/2]

std::vector<uint8_t> ParseHex ( const std::string &  str)

Definition at line 108 of file strencodings.cpp.

Here is the call graph for this function:

◆ ParseInt32()

bool ParseInt32 ( const std::string &  str,
int32_t *  out 
)

Convert string to signed 32-bit integer with strict parse error feedback.

Returns
true if the entire string could be parsed as valid integer, false if not the entire string could be parsed or when overflow or underflow occurred.

Definition at line 309 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseInt64()

bool ParseInt64 ( const std::string &  str,
int64_t *  out 
)

Convert string to signed 64-bit integer with strict parse error feedback.

Returns
true if the entire string could be parsed as valid integer, false if not the entire string could be parsed or when overflow or underflow occurred.

Definition at line 329 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseUInt16()

bool ParseUInt16 ( const std::string &  str,
uint16_t *  out 
)

Convert decimal string to unsigned 16-bit integer with strict parse error feedback.

Returns
true if the entire string could be parsed as valid integer, false if the entire string could not be parsed or if overflow or underflow occurred.

Definition at line 359 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseUInt32()

bool ParseUInt32 ( const std::string &  str,
uint32_t *  out 
)

Convert decimal string to unsigned 32-bit integer with strict parse error feedback.

Returns
true if the entire string could be parsed as valid integer, false if not the entire string could be parsed or when overflow or underflow occurred.

Definition at line 370 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ParseUInt64()

bool ParseUInt64 ( const std::string &  str,
uint64_t *  out 
)

Convert decimal string to unsigned 64-bit integer with strict parse error feedback.

Returns
true if the entire string could be parsed as valid integer, false if not the entire string could be parsed or when overflow or underflow occurred.

Definition at line 394 of file strencodings.cpp.

Here is the call graph for this function:

◆ ParseUInt8()

bool ParseUInt8 ( const std::string &  str,
uint8_t *  out 
)

Convert decimal string to unsigned 8-bit integer with strict parse error feedback.

Returns
true if the entire string could be parsed as valid integer, false if not the entire string could be parsed or when overflow or underflow occurred.

Definition at line 348 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ SanitizeString()

std::string SanitizeString ( const std::string &  str,
int  rule = SAFE_CHARS_DEFAULT 
)

Remove unsafe chars.

Safe chars chosen to allow simple messages/URLs/email addresses, but avoid anything even possibly remotely dangerous like & or >

Parameters
[in]strThe string to sanitize
[in]ruleThe set of safe chars to choose (default: least restrictive)
Returns
A new string without unsafe chars

Definition at line 30 of file strencodings.cpp.

Here is the caller graph for this function:

◆ SplitHostPort()

void SplitHostPort ( std::string  in,
uint16_t &  portOut,
std::string &  hostOut 
)

Definition at line 112 of file strencodings.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ TimingResistantEqual()

template<typename T >
bool TimingResistantEqual ( const T &  a,
const T &  b 
)

Timing-attack-resistant comparison.

Takes time proportional to length of first argument.

Definition at line 186 of file strencodings.h.

Here is the caller graph for this function:

◆ ToLower() [1/2]

constexpr char ToLower ( char  c)
constexpr

Converts the given character to its lowercase equivalent.

This function is locale independent. It only converts uppercase characters in the standard 7-bit ASCII range. This is a feature, not a limitation.

Parameters
[in]cthe character to convert to lowercase.
Returns
the lowercase equivalent of c; or the argument if no conversion is possible.

Definition at line 250 of file strencodings.h.

◆ ToLower() [2/2]

std::string ToLower ( const std::string &  str)

Returns the lowercase equivalent of the given string.

This function is locale independent. It only converts uppercase characters in the standard 7-bit ASCII range. This is a feature, not a limitation.

Parameters
[in]strthe string to convert to lowercase.
Returns
lowercased equivalent of str

Definition at line 638 of file strencodings.cpp.

Here is the caller graph for this function:

◆ ToUpper() [1/2]

constexpr char ToUpper ( char  c)
constexpr

Converts the given character to its uppercase equivalent.

This function is locale independent. It only converts lowercase characters in the standard 7-bit ASCII range. This is a feature, not a limitation.

Parameters
[in]cthe character to convert to uppercase.
Returns
the uppercase equivalent of c; or the argument if no conversion is possible.

Definition at line 275 of file strencodings.h.

◆ ToUpper() [2/2]

std::string ToUpper ( const std::string &  str)

Returns the uppercase equivalent of the given string.

This function is locale independent. It only converts lowercase characters in the standard 7-bit ASCII range. This is a feature, not a limitation.

Parameters
[in]strthe string to convert to uppercase.
Returns
UPPERCASED EQUIVALENT OF str

Definition at line 646 of file strencodings.cpp.

Here is the caller graph for this function: