Some conversion functions. More...

#include "rtabmap/utilite/utilite_export.h"
#include <string>
#include <vector>
#include <stdarg.h>

Include dependency graph for UConversion.h:

Functions
unsigned char UTILITE_EXPORT	uAscii2Hex (const unsigned char &c)

std::string UTILITE_EXPORT	uBool2Str (bool boolean)

std::string UTILITE_EXPORT	uBytes2Hex (const char *bytes, unsigned int bytesLen)

std::string UTILITE_EXPORT	uBytes2Str (const std::vector< unsigned char > &bytes)

std::string UTILITE_EXPORT	uFormat (const char *fmt,...)

std::string UTILITE_EXPORT	uFormatv (const char *fmt, va_list ap)

unsigned char UTILITE_EXPORT	uHex2Ascii (const unsigned char &c, bool rightPart)

std::vector< char > UTILITE_EXPORT	uHex2Bytes (const char *hex, int hexLen)

std::vector< char > UTILITE_EXPORT	uHex2Bytes (const std::string &hex)

std::string UTILITE_EXPORT	uHex2Str (const std::string &hex)

std::string UTILITE_EXPORT	uNumber2Str (double number, int precision=6, bool fixed=false)

std::string UTILITE_EXPORT	uNumber2Str (float number, int precision=6, bool fixed=false)

std::string UTILITE_EXPORT	uNumber2Str (int number)

std::string UTILITE_EXPORT	uNumber2Str (unsigned int number)

std::string UTILITE_EXPORT	uReplaceChar (const std::string &str, char before, char after)

std::string UTILITE_EXPORT	uReplaceChar (const std::string &str, char before, const std::string &after)

bool UTILITE_EXPORT	uStr2Bool (const char *str)

bool UTILITE_EXPORT	uStr2Bool (const std::string &str)

std::vector< unsigned char > UTILITE_EXPORT	uStr2Bytes (const std::string &str)

double UTILITE_EXPORT	uStr2Double (const std::string &str)

float UTILITE_EXPORT	uStr2Float (const std::string &str)

int UTILITE_EXPORT	uStr2Int (const std::string &str)

std::string UTILITE_EXPORT	uToLowerCase (const std::string &str)

std::string UTILITE_EXPORT	uToUpperCase (const std::string &str)

Detailed Description

Some conversion functions.

This contains functions to do some convenient conversion like uNumber2str(), uBytes2Hex() or uHex2Bytes().

Definition in file UConversion.h.

Function Documentation

◆ uAscii2Hex()

unsigned char UTILITE_EXPORT uAscii2Hex ( const unsigned char & c )

Convert an ascii character to an hexadecimal value (right 4 bits). Characters can be in upper or lower case. Example :

unsigned char hex = uAscii2Hex('F');

// The results is hex = 0x0F;

See also: hex2ascii

Parameters

c	the ascii character

Returns: the hexadecimal value

Definition at line 288 of file UConversion.cpp.

◆ uBool2Str()

std::string UTILITE_EXPORT uBool2Str ( bool boolean )

Convert a bool to a string. The format used is "true" and "false".

Parameters

boolean the boolean to convert in a string

Returns: the string

Definition at line 156 of file UConversion.cpp.

◆ uBytes2Hex()

std::string UTILITE_EXPORT uBytes2Hex	(	const char *	bytes,
		unsigned int	bytesLen
	)

Convert a bytes array to an hexadecimal string. The resulting string is twice the size of the bytes array. The hexadecimal Characters are in upper case. Example :

char bytes[] = {0x3F};
std::string hex = uBytes2Hex(bytes, 1);
// The string constains "3F".

Parameters

bytes	the bytes array
bytesLen	the length of the bytes array

Returns: the hexadecimal string

Definition at line 203 of file UConversion.cpp.

◆ uBytes2Str()

std::string UTILITE_EXPORT uBytes2Str ( const std::vector< unsigned char > & bytes )

Convert an array of bytes to string, the array of bytes must end with the null character ('\0').

Parameters

bytes the array of bytes

Returns: the string

Definition at line 188 of file UConversion.cpp.

◆ uFormat()

std::string UTILITE_EXPORT uFormat	(	const char *	fmt,
			...
	)

Format a string like printf, and return it as a std::string

Definition at line 365 of file UConversion.cpp.

◆ uFormatv()

std::string UTILITE_EXPORT uFormatv	(	const char *	fmt,
		va_list	ap
	)

Format a string like printf, and return it as a std::string

Definition at line 322 of file UConversion.cpp.

◆ uHex2Ascii()

unsigned char UTILITE_EXPORT uHex2Ascii	(	const unsigned char &	c,
		bool	rightPart
	)

Convert hexadecimal (left or right part) value to an ascii character. Example :

unsigned char F = uHex2Ascii(0xFA, false);

unsigned char A = uHex2Ascii(0xFA, true);

See also: ascii2hex

Parameters

c	the hexadecimal value
rightPart	If we want the character corresponding to the right of left part (4 bits) of the byte value.

Returns: the ascii character (in upper case)

Definition at line 276 of file UConversion.cpp.

◆ uHex2Bytes() [1/2]

std::vector<char> UTILITE_EXPORT uHex2Bytes	(	const char *	hex,
		int	hexLen
	)

Convert an hexadecimal string to a bytes array. The string must be pair length. The hexadecimal Characters can be in upper or lower case. Example :

std::vector<char> bytes = uHex2Bytes("1f3B", 4);

// The array contains {0x1F, 0x3B}.

Parameters

hex	the hexadecimal string
bytesLen	the hexadecimal string length

Returns: the bytes array

Definition at line 228 of file UConversion.cpp.

◆ uHex2Bytes() [2/2]

std::vector<char> UTILITE_EXPORT uHex2Bytes ( const std::string & hex )

Convert an hexadecimal string to a bytes array. The string must be pair length. The hexadecimal Characters can be in upper or lower case. Example :

std::string hex = "1f3B";
std::vector<char> bytes = uHex2Bytes(hex);
// The array contains {0x1F, 0x3B}.

Parameters

hex	the hexadecimal string

Returns: the bytes array

Definition at line 223 of file UConversion.cpp.

◆ uHex2Str()

std::string UTILITE_EXPORT uHex2Str ( const std::string & hex )

Convert an hexadecimal string to an ascii string. A convenient way when using only strings. The hexadecimal str MUST not contains any null values 0x00 ("00"). Think to use of hex2bytes() to handle 0x00 values. Characters can be in upper or lower case. Example :

std::string str = uHex2Str("48656C6C4F21");

// The string contains "Hello!".

See also: hex2bytes

Parameters

hex	the hexadecimal string

Returns: the ascii string

Definition at line 250 of file UConversion.cpp.

◆ uNumber2Str() [1/4]

std::string UTILITE_EXPORT uNumber2Str	(	double	number,
		int	precision = `6`,
		bool	fixed = `false`
	)

Convert a number (double) to a string.

Parameters

number the number to convert in a string

Returns: the string

Definition at line 115 of file UConversion.cpp.

◆ uNumber2Str() [2/4]

std::string UTILITE_EXPORT uNumber2Str	(	float	number,
		int	precision = `6`,
		bool	fixed = `false`
	)

Convert a number (float) to a string.

Parameters

number the number to convert in a string

Returns: the string

Definition at line 105 of file UConversion.cpp.

◆ uNumber2Str() [3/4]

std::string UTILITE_EXPORT uNumber2Str ( int number )

Convert a number (int) to a string.

Parameters

number the number to convert in a string

Returns: the string

Definition at line 98 of file UConversion.cpp.

◆ uNumber2Str() [4/4]

std::string UTILITE_EXPORT uNumber2Str ( unsigned int number )

Convert a number (unsigned int) to a string.

Parameters

number the number to convert in a string

Returns: the string

Definition at line 91 of file UConversion.cpp.

◆ uReplaceChar() [1/2]

std::string UTILITE_EXPORT uReplaceChar	(	const std::string &	str,
		char	before,
		char	after
	)

Replace old characters in a string to new ones. Example :

std::string str = "Hello";
uReplaceChar(str, 'l', 'p');
// The results is str = "Heppo";

Parameters

str	the string
before	the character to be replaced by the new one
after	the new character replacing the old one

Returns: the modified string

Definition at line 33 of file UConversion.cpp.

◆ uReplaceChar() [2/2]

std::string UTILITE_EXPORT uReplaceChar	(	const std::string &	str,
		char	before,
		const std::string &	after
	)

Replace old characters in a string with the specified string. Example :

std::string str = "Hello";
uReplaceChar(str, 'o', "oween");
// The results is str = "Helloween";

Parameters

str	the string
before	the character to be replaced by the new one
after	the new string replacing the old character

Returns: the modified string

Definition at line 46 of file UConversion.cpp.

◆ uStr2Bool() [1/2]

bool UTILITE_EXPORT uStr2Bool ( const char * str )

Convert a string to a boolean. The format used is : "false", "FALSE" or "0" give false. All others give true.

Parameters

str	the string to convert in a boolean

Returns: the boolean

Definition at line 170 of file UConversion.cpp.

◆ uStr2Bool() [2/2]

bool UTILITE_EXPORT uStr2Bool ( const std::string & str )

Definition at line 175 of file UConversion.cpp.

◆ uStr2Bytes()

std::vector<unsigned char> UTILITE_EXPORT uStr2Bytes ( const std::string & str )

Convert a string to an array of bytes including the null character ('\0').

Parameters

str	the string

Returns: the array of bytes

Definition at line 180 of file UConversion.cpp.

◆ uStr2Double()

double UTILITE_EXPORT uStr2Double ( const std::string & str )

Convert a string to a double independent of the locale (comma/dot).

Parameters

the string

Returns: the number

Definition at line 147 of file UConversion.cpp.

◆ uStr2Float()

float UTILITE_EXPORT uStr2Float ( const std::string & str )

Convert a string to a float independent of the locale (comma/dot).

Parameters

the string

Returns: the number

Definition at line 138 of file UConversion.cpp.

◆ uStr2Int()

int UTILITE_EXPORT uStr2Int ( const std::string & str )

Convert a string to an integer.

Parameters

the string

Returns: the number

Definition at line 125 of file UConversion.cpp.

◆ uToLowerCase()

std::string UTILITE_EXPORT uToLowerCase ( const std::string & str )

Transform characters from a string to lower case. Example :

std::string str = "HELLO!";
str = uToLowerCase(str, false);
//str is now equal to "hello!"

Parameters

str	the string

Returns: the modified string

Definition at line 77 of file UConversion.cpp.

◆ uToUpperCase()

std::string UTILITE_EXPORT uToUpperCase ( const std::string & str )

Transform characters from a string to upper case. Example :

std::string str = "hello!";
str = uToUpperCase(str);
//str is now equal to "HELLO!"

Parameters

str	the string

Returns: the modified string

Definition at line 63 of file UConversion.cpp.

Functions

Detailed Description

Function Documentation

◆ uAscii2Hex()

◆ uBool2Str()

◆ uBytes2Hex()

◆ uBytes2Str()

◆ uFormat()

◆ uFormatv()

◆ uHex2Ascii()

◆ uHex2Bytes() [1/2]

◆ uHex2Bytes() [2/2]

◆ uHex2Str()

◆ uNumber2Str() [1/4]

◆ uNumber2Str() [2/4]

◆ uNumber2Str() [3/4]

◆ uNumber2Str() [4/4]

◆ uReplaceChar() [1/2]

◆ uReplaceChar() [2/2]

◆ uStr2Bool() [1/2]

◆ uStr2Bool() [2/2]

◆ uStr2Bytes()

◆ uStr2Double()

◆ uStr2Float()

◆ uStr2Int()

◆ uToLowerCase()

◆ uToUpperCase()