libvlc_error
[libvlc, libvlc_core]

Collaboration diagram for libvlc_error:

LibVLC error handling. More...

Functions
const char *	libvlc_errmsg (void)
	A human-readable error message for the last LibVLC error in the calling thread.
void	libvlc_clearerr (void)
	Clears the LibVLC error status for the current thread.
const char *	libvlc_vprinterr (const char *fmt, va_list ap)
	Sets the LibVLC error status and message for the current thread.
const char *	libvlc_printerr (const char *fmt,...)
	Sets the LibVLC error status and message for the current thread.

---

Detailed Description

LibVLC error handling.

---

Function Documentation

void libvlc_clearerr

(

void

)

Clears the LibVLC error status for the current thread.

This is optional. By default, the error status is automatically overriden when a new error occurs, and destroyed when the thread exits.

References context, free_error(), and vlc_threadvar_set().

Referenced by libvlc_exception_clear().

const char* libvlc_errmsg

(

void

)

A human-readable error message for the last LibVLC error in the calling thread.

The resulting string is valid until another error occurs (at least until the next LibVLC call).

Warning:

This will be NULL if there was no error.

A human-readable error message for the last LibVLC error in the calling thread.

The resulting string is valid until another error occurs (at least until the next LibVLC call).

Returns:

NULL if there was no error, a nul-terminated string otherwise.

References get_error().

Referenced by libvlc_exception_raise(), and mediacontrol_get_stream_information().

const char* libvlc_printerr	(	const char *	fmt,
			...
	)

Sets the LibVLC error status and message for the current thread.

Any previous error is overriden.

Returns:

a nul terminated string in any case

Any previous error is overriden.

Returns:

a nul terminated string (always)

References libvlc_vprinterr(), and msg.

Referenced by _libvlc_media_list_remove_index(), event_attach(), GetAOut(), GetVout(), hierarch_node_media_list_view_item_at_index(), libvlc_add_intf(), libvlc_audio_get_track(), libvlc_audio_output_list_get(), libvlc_audio_output_set_device_type(), libvlc_audio_set_channel(), libvlc_audio_set_track(), libvlc_audio_set_volume(), libvlc_event_manager_new(), libvlc_event_manager_register_event_type(), libvlc_get_track_description(), libvlc_media_discoverer_new_from_name(), libvlc_media_get_duration(), libvlc_media_library_load(), libvlc_media_library_save(), libvlc_media_list_add_file_content(), libvlc_media_list_item_at_index(), libvlc_media_list_player_play_item(), libvlc_media_new(), libvlc_media_new_as_node(), libvlc_media_new_from_input_item(), libvlc_media_player_new(), libvlc_media_player_next_frame(), libvlc_media_player_play(), libvlc_media_player_set_rate(), libvlc_video_get_marquee_option_as_int(), libvlc_video_get_marquee_option_as_string(), libvlc_video_get_spu(), libvlc_video_get_track(), libvlc_video_set_aspect_ratio(), libvlc_video_set_crop_geometry(), libvlc_video_set_deinterlace(), libvlc_video_set_marquee_option_as_int(), libvlc_video_set_marquee_option_as_string(), libvlc_video_set_spu(), libvlc_video_set_track(), libvlc_video_take_snapshot(), libvlc_vlm_add_broadcast(), libvlc_vlm_add_vod(), libvlc_vlm_del_media(), libvlc_vlm_get_media_instance(), libvlc_vlm_init(), libvlc_vlm_pause_media(), libvlc_vlm_play_media(), libvlc_vlm_seek_media(), libvlc_vlm_show_media(), libvlc_vlm_stop_media(), mlist_is_writable(), and set_relative_playlist_position_and_play().

const char* libvlc_vprinterr	(	const char *	fmt,
		va_list	ap
	)

Sets the LibVLC error status and message for the current thread.

Any previous error is overriden.

Returns:

a nul terminated string in any case

Any previous error is overriden.

Returns:

a nul terminated string (always)

References context, free_error(), msg, oom, vasprintf(), and vlc_threadvar_set().

Referenced by libvlc_printerr().