full implemented class for user_interaction based on callback functions. More...

#include <user_interaction_callback.hpp>

Inheritance diagram for libdar::user_interaction_callback:

Collaboration diagram for libdar::user_interaction_callback:

Public Types
using	message_callback = void()(const std::string &x, void context)

using	pause_callback = bool()(const std::string &x, void context)

using	get_string_callback = std::string()(const std::string &x, bool echo, void context)

using	get_secu_string_callback = secu_string()(const std::string &x, bool echo, void context)

Public Member Functions
	user_interaction_callback (message_callback x_message_callback, pause_callback x_answer_callback, get_string_callback x_string_callback, get_secu_string_callback x_secu_string_callback, void *context_value)
	constructor which receive the callback functions. More...

	user_interaction_callback (const user_interaction_callback &ref)=default

	user_interaction_callback (user_interaction_callback &&ref) noexcept=default

user_interaction_callback &	operator= (const user_interaction_callback &ref)=default

user_interaction_callback &	operator= (user_interaction_callback &&ref) noexcept=default

Public Member Functions inherited from libdar::user_interaction
	user_interaction (const user_interaction &ref)=default

	user_interaction (user_interaction &&ref) noexcept=default

user_interaction &	operator= (const user_interaction &ref)=default

user_interaction &	operator= (user_interaction &&ref) noexcept=default

void	message (const std::string &message)

void	pause (const std::string &message)

std::string	get_string (const std::string &message, bool echo)

secu_string	get_secu_string (const std::string &message, bool echo)

virtual void	printf (const char *format,...)
	libdar uses this call to format output before send to message() method. More...

Protected Member Functions
virtual void	inherited_message (const std::string &message) override
	listing callback can be now passed directly to archive::get_children_of() More...

virtual bool	inherited_pause (const std::string &message) override
	overwritting method from parent class. More...

virtual std::string	inherited_get_string (const std::string &message, bool echo) override
	overwritting method from parent class. More...

virtual secu_string	inherited_get_secu_string (const std::string &message, bool echo) override
	overwritting method from parent class. More...

void	change_context_value (void *new_value)
	change the context value of the object that will be given to callback functions More...

virtual void	inherited_message (const std::string &message)=0

virtual bool	inherited_pause (const std::string &message)=0
	method used to ask a boolean question to the user. More...

virtual std::string	inherited_get_string (const std::string &message, bool echo)=0
	method used to ask a question that needs an arbitrary answer. More...

virtual secu_string	inherited_get_secu_string (const std::string &message, bool echo)=0
	same a get_string() but uses libdar::secu_string instead of std::string More...

Private Attributes
message_callback	message_cb

pause_callback	pause_cb

get_string_callback	get_string_cb

get_secu_string_callback	get_secu_string_cb

void *	context_val

Detailed Description

full implemented class for user_interaction based on callback functions.

this class is an inherited class of user_interaction it is used by dar command line programs, but you can use it if you wish.

Definition at line 57 of file user_interaction_callback.hpp.

Member Typedef Documentation

◆ get_secu_string_callback

using libdar::user_interaction_callback::get_secu_string_callback = secu_string (*)(const std::string &x, bool echo, void *context)

Definition at line 64 of file user_interaction_callback.hpp.

◆ get_string_callback

using libdar::user_interaction_callback::get_string_callback = std::string (*)(const std::string &x, bool echo, void *context)

Definition at line 63 of file user_interaction_callback.hpp.

◆ message_callback

using libdar::user_interaction_callback::message_callback = void (*)(const std::string &x, void *context)

Definition at line 61 of file user_interaction_callback.hpp.

◆ pause_callback

using libdar::user_interaction_callback::pause_callback = bool (*)(const std::string &x, void *context)

Definition at line 62 of file user_interaction_callback.hpp.

Constructor & Destructor Documentation

◆ user_interaction_callback()

libdar::user_interaction_callback::user_interaction_callback	(	message_callback	x_message_callback,
		pause_callback	x_answer_callback,
		get_string_callback	x_string_callback,
		get_secu_string_callback	x_secu_string_callback,
		void *	context_value
	)

constructor which receive the callback functions.

Parameters

[in]	x_message_callback	is used by message() method
[in]	x_answer_callback	is used by the pause() method
[in]	x_string_callback	is used by get_string() method
[in]	x_secu_string_callback	is used by get_secu_string() method
[in]	context_value	will be passed as last argument of callbacks when called from this object.

Note: The context argument of each callback is set with the context_value given in the user_interaction_callback object constructor. The value can can be any arbitrary value (nullptr is valid), and can be used as you wish. Note that the listing callback is not defined here, but thanks to a specific method

Member Function Documentation

◆ change_context_value()

void libdar::user_interaction_callback::change_context_value ( void * new_value )

inlineprotected

change the context value of the object that will be given to callback functions

Definition at line 114 of file user_interaction_callback.hpp.

◆ inherited_get_secu_string()

virtual secu_string libdar::user_interaction_callback::inherited_get_secu_string	(	const std::string &	message,
		bool	echo
	)

overrideprotectedvirtual

overwritting method from parent class.

Implements libdar::user_interaction.

◆ inherited_get_string()

virtual std::string libdar::user_interaction_callback::inherited_get_string	(	const std::string &	message,
		bool	echo
	)

overrideprotectedvirtual

overwritting method from parent class.

Implements libdar::user_interaction.

◆ inherited_message()

virtual void libdar::user_interaction_callback::inherited_message ( const std::string & message )

overrideprotectedvirtual

listing callback can be now passed directly to archive::get_children_of()

dar_manager_show_files callback can now be passed directly to database::get_files() dar_manager_contents callback is not necessary, use database::get_contents() method dar_manager_statistics callback can now be passed directly to database::show_most_recent_stats() dar_manager_get_show_version callback can now be passed directly to database::get_version() overwritting method from parent class.

Implements libdar::user_interaction.