utilstrencodings.cpp File Reference

#include "utilstrencodings.h"
#include "util/string.h"
#include "tinyformat.h"
#include <algorithm>
#include <cstdlib>
#include <cstring>
#include <errno.h>
#include <limits>
#include <regex>

Include dependency graph for utilstrencodings.cpp:

Go to the source code of this file.

Functions
std::string	SanitizeString (const std::string &str, int rule)
	Remove unsafe chars. More...
bool	validateURL (const std::string &strURL)
bool	validateURL (const std::string &strURL, std::string &strErr, unsigned int maxSize)
	Check URL format for conformance for validity to a defined pattern. More...
signed char	HexDigit (char c)
bool	IsHex (const std::string &str)
std::vector< unsigned char >	ParseHex (const char *psz)
std::vector< unsigned char >	ParseHex (const std::string &str)
std::string	EncodeBase64 (Span< const unsigned char > input)
std::string	EncodeBase64 (const std::string &str)
std::vector< unsigned char >	DecodeBase64 (const char *p, bool *pfInvalid)
std::string	DecodeBase64 (const std::string &str)
std::string	EncodeBase32 (Span< const unsigned char > input, bool pad)
	Base32 encode. More...
std::string	EncodeBase32 (const std::string &str, bool pad)
	Base32 encode. More...
std::vector< unsigned char >	DecodeBase32 (const char *p, bool *pfInvalid)
std::string	DecodeBase32 (const std::string &str)
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	ParseUInt32 (const std::string &str, uint32_t *out)
	Convert decimal string to unsigned 32-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	FormatParagraph (const std::string in, size_t width, size_t indent)
	Format a paragraph of text to a fixed width, adding spaces for indentation to any added line. More...
std::string	i64tostr (int64_t n)
std::string	itostr (int n)
int64_t	atoi64 (const char *psz)
int64_t	atoi64 (const std::string &str)
int	atoi (const std::string &str)
bool	ParseFixedPoint (const std::string &val, int decimals, int64_t *amount_out)
	Parse number as fixed point according to JSON number syntax. More...
void	Downcase (std::string &str)
	Converts the given string to its lowercase equivalent. More...
std::string	ToLower (const std::string &str)
	Returns the lowercase equivalent of the given string. 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...
std::string	HexStr (const Span< const uint8_t > s)
	Convert a span of bytes to a lower-case hexadecimal string. More...
bool	IsValidUTF8 (const std::string &str)
	Checks for valid 4-byte UTF-8 encoding in a string. More...

Variables
const signed char	p_util_hexdigit [256]

Function Documentation

atoi()

int atoi

(

const std::string &

str

)

Definition at line 412 of file utilstrencodings.cpp.

Here is the caller graph for this function:

atoi64() [1/2]

int64_t atoi64

(

const char *

psz

)

Definition at line 394 of file utilstrencodings.cpp.

Here is the caller graph for this function:

atoi64() [2/2]

int64_t atoi64

(

const std::string &

str

)

Definition at line 403 of file utilstrencodings.cpp.

Capitalize()

std::string Capitalize

(

std::string

str

)

Capitalizes the first character of the given string.

This function is locale independent. It only capitalizes the first character of the argument if it has an uppercase equivalent in the standard 7-bit ASCII range.

Parameters

[in]

str

the string to capitalize.

Returns

string with the first letter capitalized.

Definition at line 556 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

DecodeBase32() [1/2]

std::vector<unsigned char> DecodeBase32	(	const char *	p,
		bool *	pfInvalid
	)

Definition at line 214 of file utilstrencodings.cpp.

Here is the caller graph for this function:

DecodeBase32() [2/2]

std::string DecodeBase32

(

const std::string &

str

)

Definition at line 261 of file utilstrencodings.cpp.

Here is the call graph for this function:

DecodeBase64() [1/2]

std::vector<unsigned char> DecodeBase64	(	const char *	p,
		bool *	pfInvalid
	)

Definition at line 140 of file utilstrencodings.cpp.

Here is the caller graph for this function:

DecodeBase64() [2/2]

std::string DecodeBase64

(

const std::string &

str

)

Definition at line 187 of file utilstrencodings.cpp.

Here is the call graph for this function:

Downcase()

void Downcase

(

std::string &

str

)

Converts the given string to its lowercase equivalent.

This function is locale independent. It only converts uppercase characters in the standard 7-bit ASCII range.

Parameters

[in,out]

str

the string to convert to lowercase.

Definition at line 537 of file utilstrencodings.cpp.

Here is the caller 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 208 of file utilstrencodings.cpp.

Here is the call graph for this function:

EncodeBase32() [2/2]

std::string EncodeBase32	(	Span< const unsigned char >	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 193 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

EncodeBase64() [1/2]

std::string EncodeBase64

(

const std::string &

str

)

Definition at line 135 of file utilstrencodings.cpp.

Here is the call graph for this function:

EncodeBase64() [2/2]

std::string EncodeBase64

(

Span< const unsigned char >

input

)

Definition at line 124 of file utilstrencodings.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,
		size_t	indent
	)

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

Definition at line 352 of file utilstrencodings.cpp.

Here is the caller graph for this function:

HexDigit()

signed char HexDigit

(

char

c

)

Definition at line 85 of file utilstrencodings.cpp.

Here is the caller graph for this function:

HexStr()

std::string HexStr

(

const Span< const uint8_t >

s

)

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

Definition at line 563 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

i64tostr()

std::string i64tostr

(

int64_t

n

)

Definition at line 384 of file utilstrencodings.cpp.

IsHex()

bool IsHex

(

const std::string &

str

)

Definition at line 90 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

IsValidUTF8()

bool IsValidUTF8

(

const std::string &

str

)

Checks for valid 4-byte UTF-8 encoding in a string.

Parameters

[in]

str

the string to check.

Returns

boolean. true for valid UTF-8 encoding.

Definition at line 577 of file utilstrencodings.cpp.

Here is the caller graph for this function:

itostr()

std::string itostr

(

int

n

)

Definition at line 389 of file utilstrencodings.cpp.

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 338 of file utilstrencodings.cpp.

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 445 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

ParseHex() [1/2]

std::vector<unsigned char> ParseHex

(

const char *

psz

)

Definition at line 99 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

ParseHex() [2/2]

std::vector<unsigned char> ParseHex

(

const std::string &

str

)

Definition at line 119 of file utilstrencodings.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 278 of file utilstrencodings.cpp.

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 294 of file utilstrencodings.cpp.

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 321 of file utilstrencodings.cpp.

Here is the caller 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 309 of file utilstrencodings.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]	str	The string to sanitize
[in]	rule	The set of safe chars to choose (default: least restrictive)

Returns

A new string without unsafe chars

Definition at line 30 of file utilstrencodings.cpp.

Here is the caller graph for this function:

ToLower()

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]

str

the string to convert to lowercase.

Returns

lowercased equivalent of str

Definition at line 542 of file utilstrencodings.cpp.

Here is the caller graph for this function:

ToUpper()

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]

str

the string to convert to uppercase.

Returns

UPPERCASED EQUIVALENT OF str

Definition at line 549 of file utilstrencodings.cpp.

Here is the caller graph for this function:

validateURL() [1/2]

bool validateURL

(

const std::string &

strURL

)

Definition at line 41 of file utilstrencodings.cpp.

Here is the caller graph for this function:

validateURL() [2/2]

bool validateURL	(	const std::string &	strURL,
		std::string &	strErr,
		unsigned int	maxSize = 64
	)

Check URL format for conformance for validity to a defined pattern.

Parameters

[in]	strURL	The string to be processed for validity
[in]	strErr	A string that will be loaded with any validation error message
[in]	maxSize	An unsigned int, defaulted to 64, to restrict the length

Returns

A bool, true if valid, false if not (reason in strErr)

Definition at line 47 of file utilstrencodings.cpp.

Variable Documentation

p_util_hexdigit

const signed char p_util_hexdigit[256]

Initial value:

=
    {
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        0, 1, 2, 3, 4, 5, 6, 7, 8, 9, -1, -1, -1, -1, -1, -1,
        -1, 0xa, 0xb, 0xc, 0xd, 0xe, 0xf, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, 0xa, 0xb, 0xc, 0xd, 0xe, 0xf, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
        -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
}

Definition at line 65 of file utilstrencodings.cpp.