libvlc_log
[libvlc, libvlc_core]

Collaboration diagram for libvlc_log:

LibVLC Message Logging. More...

Data Structures
struct	libvlc_log_message_t
Typedefs
typedef libvlc_log_t	libvlc_log_t
	This structure is opaque.
typedef libvlc_log_iterator_t	libvlc_log_iterator_t
	This structure is opaque.
Functions
unsigned	libvlc_get_log_verbosity (const libvlc_instance_t *p_instance, libvlc_exception_t *p_e)
	Return the VLC messaging verbosity level.
void	libvlc_set_log_verbosity (libvlc_instance_t *p_instance, unsigned level, libvlc_exception_t *p_e)
	Set the VLC messaging verbosity level.
libvlc_log_t *	libvlc_log_open (libvlc_instance_t *, libvlc_exception_t *)
	Open a VLC message log instance.
void	libvlc_log_close (libvlc_log_t *, libvlc_exception_t *)
	Close a VLC message log instance.
unsigned	libvlc_log_count (const libvlc_log_t *, libvlc_exception_t *)
	Returns the number of messages in a log instance.
void	libvlc_log_clear (libvlc_log_t *, libvlc_exception_t *)
	Clear a log instance.
libvlc_log_iterator_t *	libvlc_log_get_iterator (const libvlc_log_t *, libvlc_exception_t *)
	Allocate and returns a new iterator to messages in log.
void	libvlc_log_iterator_free (libvlc_log_iterator_t *p_iter, libvlc_exception_t *p_e)
	Release a previoulsy allocated iterator.
int	libvlc_log_iterator_has_next (const libvlc_log_iterator_t *p_iter, libvlc_exception_t *p_e)
	Return whether log iterator has more messages.
libvlc_log_message_t *	libvlc_log_iterator_next (libvlc_log_iterator_t *p_iter, libvlc_log_message_t *p_buffer, libvlc_exception_t *p_e)
	Return the next log message.

---

Detailed Description

LibVLC Message Logging.

---

Typedef Documentation

typedef struct libvlc_log_iterator_t libvlc_log_iterator_t

This structure is opaque.

It represents a libvlc log iterator

typedef struct libvlc_log_t libvlc_log_t

This structure is opaque.

It represents a libvlc log instance

---

Function Documentation

unsigned libvlc_get_log_verbosity	(	const libvlc_instance_t *	p_instance,
		libvlc_exception_t *	p_e
	)

Return the VLC messaging verbosity level.

Parameters:

	p_instance	libvlc instance
	p_e	an initialized exception pointer

Returns:

verbosity level for messages

void libvlc_log_clear	(	libvlc_log_t *	,
		libvlc_exception_t *
	)

Clear a log instance.

All messages in the log are removed. The log should be cleared on a regular basis to avoid clogging.

Parameters:

	p_log	libvlc log instance
	p_e	an initialized exception pointer

void libvlc_log_close	(	libvlc_log_t *	,
		libvlc_exception_t *
	)

Close a VLC message log instance.

Parameters:

	p_log	libvlc log instance
	p_e	an initialized exception pointer

unsigned libvlc_log_count	(	const libvlc_log_t *	,
		libvlc_exception_t *
	)

Returns the number of messages in a log instance.

Parameters:

	p_log	libvlc log instance
	p_e	an initialized exception pointer

Returns:

number of log messages

libvlc_log_iterator_t* libvlc_log_get_iterator	(	const libvlc_log_t *	,
		libvlc_exception_t *
	)

Allocate and returns a new iterator to messages in log.

Parameters:

	p_log	libvlc log instance
	p_e	an initialized exception pointer

Returns:

log iterator object

void libvlc_log_iterator_free	(	libvlc_log_iterator_t *	p_iter,
		libvlc_exception_t *	p_e
	)

Release a previoulsy allocated iterator.

Parameters:

	p_iter	libvlc log iterator
	p_e	an initialized exception pointer

int libvlc_log_iterator_has_next	(	const libvlc_log_iterator_t *	p_iter,
		libvlc_exception_t *	p_e
	)

Return whether log iterator has more messages.

Parameters:

	p_iter	libvlc log iterator
	p_e	an initialized exception pointer

Returns:

true if iterator has more message objects, else false

libvlc_log_message_t* libvlc_log_iterator_next	(	libvlc_log_iterator_t *	p_iter,
		libvlc_log_message_t *	p_buffer,
		libvlc_exception_t *	p_e
	)

Return the next log message.

The message contents must not be freed

Parameters:

	p_iter	libvlc log iterator
	p_buffer	log buffer
	p_e	an initialized exception pointer

Returns:

log message object

libvlc_log_t* libvlc_log_open	(	libvlc_instance_t *	,
		libvlc_exception_t *
	)

Open a VLC message log instance.

Parameters:

	p_instance	libvlc instance
	p_e	an initialized exception pointer

Returns:

log message instance

void libvlc_set_log_verbosity	(	libvlc_instance_t *	p_instance,
		unsigned	level,
		libvlc_exception_t *	p_e
	)

Set the VLC messaging verbosity level.

Parameters:

	p_instance	libvlc log instance
	level	log level
	p_e	an initialized exception pointer

---