utilstrencodings.h File Reference

#include "allocators.h"
#include <stdint.h>
#include <string>
#include <vector>

Include dependency graph for utilstrencodings.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	BEGIN(a)   ((char*)&(a))
	Utilities for converting data from/to strings. More...
#define	END(a)   ((char*)&((&(a))[1]))
#define	UBEGIN(a)   ((unsigned char*)&(a))
#define	UEND(a)   ((unsigned char*)&((&(a))[1]))
#define	ARRAYLEN(array)   (sizeof(array) / sizeof((array)[0]))
#define	PAIRTYPE(t1, t2)   std::pair<t1, t2>
	This is needed because the foreach macro can't get over the comma in pair<t1, t2> More...

Enumerations
enum	SafeChars { SAFE_CHARS_DEFAULT, SAFE_CHARS_UA_COMMENT, SAFE_CHARS_FILENAME }
	Used by SanitizeString() More...

Functions
std::string	SanitizeString (const std::string &str, int rule=SAFE_CHARS_DEFAULT)
	Remove unsafe chars. More...
std::vector< unsigned char >	ParseHex (const char *psz)
std::vector< unsigned char >	ParseHex (const std::string &str)
signed char	HexDigit (char c)
bool	IsHex (const std::string &str)
std::vector< unsigned char >	DecodeBase64 (const char *p, bool *pfInvalid=NULL)
std::string	DecodeBase64 (const std::string &str)
std::string	EncodeBase64 (const unsigned char *pch, size_t len)
std::string	EncodeBase64 (const std::string &str)
SecureString	DecodeBase64Secure (const SecureString &input)
SecureString	EncodeBase64Secure (const SecureString &input)
std::vector< unsigned char >	DecodeBase32 (const char *p, bool *pfInvalid=NULL)
std::string	DecodeBase32 (const std::string &str)
std::string	EncodeBase32 (const unsigned char *pch, size_t len)
std::string	EncodeBase32 (const std::string &str)
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	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	ParseDouble (const std::string &str, double *out)
	Convert string to double with strict parse error feedback. More...
template<typename T >
std::string	HexStr (const T itbegin, const T itend, bool fSpaces=false)
template<typename T >
std::string	HexStr (const T &vch, bool fSpaces=false)
std::string	ReverseEndianString (std::string in)
	Reverse the endianess of a string. More...
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...

Macro Definition Documentation

ARRAYLEN

#define ARRAYLEN

(

array

)

(sizeof(array) / sizeof((array)[0]))

Definition at line 21 of file utilstrencodings.h.

BEGIN

#define BEGIN

(

a

)

((char*)&(a))

Utilities for converting data from/to strings.

Definition at line 17 of file utilstrencodings.h.

END

#define END

(

a

)

((char*)&((&(a))[1]))

Definition at line 18 of file utilstrencodings.h.

PAIRTYPE

#define PAIRTYPE	(		t1,
			t2
	)		std::pair<t1, t2>

This is needed because the foreach macro can't get over the comma in pair<t1, t2>

Definition at line 24 of file utilstrencodings.h.

UBEGIN

#define UBEGIN

(

a

)

((unsigned char*)&(a))

Definition at line 19 of file utilstrencodings.h.

UEND

#define UEND

(

a

)

((unsigned char*)&((&(a))[1]))

Definition at line 20 of file utilstrencodings.h.

Enumeration Type Documentation

SafeChars

enum SafeChars

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.

Definition at line 27 of file utilstrencodings.h.

Function Documentation

atoi()

int atoi

(

const std::string &

str

)

Definition at line 587 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

atoi64() [1/2]

int64_t atoi64

(

const char *

psz

)

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

DecodeBase32() [1/2]

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

Definition at line 352 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 465 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 = NULL
	)

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

Here is the call graph for this function:

DecodeBase64Secure()

SecureString DecodeBase64Secure

(

const SecureString &

input

)

Definition at line 236 of file utilstrencodings.cpp.

EncodeBase32() [1/2]

std::string EncodeBase32

(

const std::string &

str

)

Definition at line 347 of file utilstrencodings.cpp.

Here is the call graph for this function:

EncodeBase32() [2/2]

std::string EncodeBase32	(	const unsigned char *	pch,
		size_t	len
	)

Definition at line 291 of file utilstrencodings.cpp.

Here is the caller graph for this function:

EncodeBase64() [1/2]

std::string EncodeBase64

(

const std::string &

str

)

Definition at line 145 of file utilstrencodings.cpp.

Here is the call graph for this function:

EncodeBase64() [2/2]

std::string EncodeBase64	(	const unsigned char *	pch,
		size_t	len
	)

Definition at line 102 of file utilstrencodings.cpp.

Here is the caller graph for this function:

EncodeBase64Secure()

SecureString EncodeBase64Secure

(

const SecureString &

input

)

Definition at line 265 of file utilstrencodings.cpp.

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

Here is the caller graph for this function:

HexDigit()

signed char HexDigit

(

char

c

)

Definition at line 63 of file utilstrencodings.cpp.

Here is the caller graph for this function:

HexStr() [1/2]

template<typename T >

std::string HexStr ( const T &  vch, bool  fSpaces = false  )

inline

Definition at line 103 of file utilstrencodings.h.

Here is the call graph for this function:

HexStr() [2/2]

template<typename T >

std::string HexStr	(	const T	itbegin,
		const T	itend,
		bool	fSpaces = false
	)

Definition at line 85 of file utilstrencodings.h.

Here is the caller graph for this function:

i64tostr()

std::string i64tostr

(

int64_t

n

)

Definition at line 559 of file utilstrencodings.cpp.

IsHex()

bool IsHex

(

const std::string &

str

)

Definition at line 68 of file utilstrencodings.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

itostr()

std::string itostr

(

int

n

)

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

Here is the caller graph for this function:

ParseHex() [1/2]

std::vector<unsigned char> ParseHex

(

const char *

psz

)

Definition at line 77 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 97 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 482 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 498 of file utilstrencodings.cpp.

Here is the caller graph for this function:

ReverseEndianString()

std::string ReverseEndianString ( std::string  in )

inline

Reverse the endianess of a string.

Definition at line 109 of file utilstrencodings.h.

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

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 132 of file utilstrencodings.h.