dpp::utility Namespace Reference

Utility helper functions, generally for logging. More...

Classes
struct	iconhash
	Store a 128 bit icon hash (profile picture, server icon etc) as a 128 bit binary value made of two uint64_t. Has a constructor to build one from a string, and a method to fetch the value back in string form. More...
struct	uptime
	A class used to represent an uptime in hours, minutes, seconds and days, with helper functions to convert from time_t and display as a string. More...

Typedefs
typedef std::function< void(const std::string &output)>	cmd_result_t

Functions
void	exec (const std::string &cmd, std::vector< std::string > parameters={}, cmd_result_t callback={})
	Run a commandline program asyncronously. The command line program is spawned in a separate std::thread, and when complete, its output from stdout is passed to the callback function in its string prameter. For eample. More...
std::string	current_date_time ()
	Returns urrent date and time. More...
std::string	loglevel (dpp::loglevel in)
	Convert a dpp::loglevel enum value to a string. More...
double	time_f ()
	Return the current time with fractions of seconds. This is a unix epoch time with the fractional seconds part after the decimal place. More...
bool	has_voice ()
	Returns true if D++ was built with voice support. More...
std::string	bytes (uint64_t c)
	Convert a byte count to display value. More...
void	debug_dump (uint8_t *data, size_t length)
	Output hex values of a section of memory for debugging. More...
size_t	utf8len (const std::string &str)
	Returns the length of a UTF-8 string in codepoints. More...
std::string	utf8substr (const std::string &str, std::string::size_type start, std::string::size_type length)
	Return substring of a UTF-8 encoded string in codepoints. More...

Detailed Description

Utility helper functions, generally for logging.

Typedef Documentation

cmd_result_t

typedef std::function<void(const std::string& output)> dpp::utility::cmd_result_t

Function Documentation

bytes()

std::string dpp::utility::bytes

(

uint64_t

c

)

Convert a byte count to display value.

Parameters

c	number of bytes

Returns

std::string display value suffixed with M, G, T where neccessary

current_date_time()

std::string dpp::utility::current_date_time

(

)

Returns urrent date and time.

Returns

std::string Current date and time

debug_dump()

void dpp::utility::debug_dump	(	uint8_t *	data,
		size_t	length
	)

Output hex values of a section of memory for debugging.

Parameters

data	The start of the data to display
length	The length of data to display

exec()

void dpp::utility::exec	(	const std::string &	cmd,
		std::vector< std::string >	parameters = {},
		cmd_result_t	callback = {}
	)

Run a commandline program asyncronously. The command line program is spawned in a separate std::thread, and when complete, its output from stdout is passed to the callback function in its string prameter. For eample.

dpp::utility::exec("ls", [](const std::string& output) {
    std::cout << "Output of 'ls': " << output << "\n";
});

Parameters

cmd	The command to run.
parameters	Command line parameters. Each will be escaped using std::quoted.
callback	The callback to call on completion.

has_voice()

bool dpp::utility::has_voice

(

)

Returns true if D++ was built with voice support.

Returns

bool True if voice support is compiled in (libsodium/libopus)

loglevel()

std::string dpp::utility::loglevel

(

dpp::loglevel

in

)

Convert a dpp::loglevel enum value to a string.

Parameters

in	log level to convert

Returns

std::string string form of log level

time_f()

double dpp::utility::time_f

(

)

Return the current time with fractions of seconds. This is a unix epoch time with the fractional seconds part after the decimal place.

Returns

double time with fractional seconds

utf8len()

size_t dpp::utility::utf8len

(

const std::string &

str

)

Returns the length of a UTF-8 string in codepoints.

Parameters

str	string to count length of

Returns

size_t length of string (0 for invalid utf8)

utf8substr()

std::string dpp::utility::utf8substr	(	const std::string &	str,
		std::string::size_type	start,
		std::string::size_type	length
	)

Return substring of a UTF-8 encoded string in codepoints.

Parameters

str	string to return substring from
start	start codepoint offset
length	length in codepoints

Returns

std::string Substring in UTF-8 or emtpy string if invalid UTF-8 passed in