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
std::string	bytes (uint64_t c)
	Convert a byte count to display value. More...
std::string	current_date_time ()
	Returns urrent date and time. More...
void	debug_dump (uint8_t *data, size_t length)
	Output hex values of a section of memory for debugging. More...
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...
bool	has_voice ()
	Returns true if D++ was built with voice support. More...
std::string	loglevel (dpp::loglevel in)
	Convert a dpp::loglevel enum value to a string. 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