1 /*****************************************************************************
2 * common.h: common definitions
3 * Collection of useful common types and macros definitions
4 *****************************************************************************
5 * Copyright (C) 1998-2011 the VideoLAN team
7 * Authors: Samuel Hocevar <sam@via.ecp.fr>
8 * Vincent Seguin <seguin@via.ecp.fr>
9 * Gildas Bazin <gbazin@videolan.org>
10 * RĂ©mi Denis-Courmont
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25 *****************************************************************************/
29 * This file is a collection of common definitions and types
33 # define VLC_COMMON_H 1
35 /*****************************************************************************
36 * Required vlc headers
37 *****************************************************************************/
38 #if defined( _MSC_VER )
39 # pragma warning( disable : 4244 )
42 #include "vlc_config.h"
44 /*****************************************************************************
45 * Required system headers
46 *****************************************************************************/
59 /* Try to fix format strings for all versions of mingw and mingw64 */
60 #if defined( _WIN32 ) && defined( __USE_MINGW_ANSI_STDIO )
71 #define snprintf __mingw_snprintf
72 #define vsnprintf __mingw_vsnprintf
75 /* Format string sanity checks */
77 # if defined( _WIN32 ) && (__GNUC__ > 4 || ( __GNUC__ == 4 && __GNUC_MINOR__ >= 4 ) )
78 # define VLC_FORMAT(x,y) __attribute__ ((format(gnu_printf,x,y)))
80 # define VLC_FORMAT(x,y) __attribute__ ((format(printf,x,y)))
82 # define VLC_FORMAT_ARG(x) __attribute__ ((format_arg(x)))
83 # if __GNUC__ > 3 || (__GNUC__ == 3 && (__GNUC_MINOR__ >= 4))
84 # define VLC_USED __attribute__ ((warn_unused_result))
88 # define VLC_MALLOC __attribute__ ((malloc))
90 # define VLC_FORMAT(x,y)
91 # define VLC_FORMAT_ARG(x)
96 /* Branch prediction */
98 # define likely(p) __builtin_expect(!!(p), 1)
99 # define unlikely(p) __builtin_expect(!!(p), 0)
101 # define likely(p) (!!(p))
102 # define unlikely(p) (!!(p))
105 #if defined(__GNUC__) && !defined __cplusplus
106 # define VLC_DEPRECATED __attribute__((deprecated))
108 # define VLC_DEPRECATED
113 # define VLC_EXTERN extern "C"
118 #if defined (WIN32) && defined (DLL_EXPORT)
119 # define VLC_EXPORT __declspec(dllexport)
120 #elif defined (__GNUC__) && (__GNUC__ >= 4)
121 # define VLC_EXPORT __attribute__((visibility("default")))
126 #define VLC_API VLC_EXTERN VLC_EXPORT
129 /*****************************************************************************
130 * Basic types definitions
131 *****************************************************************************/
132 #if defined( WIN32 ) || defined( UNDER_CE )
135 # define PATH_MAX MAX_PATH
140 #include <sys/syslimits.h>
143 /* Counter for statistics and profiling */
144 typedef unsigned long count_t;
147 typedef uint16_t audio_volume_t;
150 * High precision date or time interval
152 * Store a high precision date or time interval. The maximum precision is the
153 * microsecond, and a 64 bits integer is used to avoid overflows (maximum
154 * time interval is then 292271 years, which should be long enough for any
155 * video). Dates are stored as microseconds since a common date (usually the
156 * epoch). Note that date and time intervals can be manipulated using regular
157 * arithmetic operators, and that no special functions are required.
159 typedef int64_t mtime_t;
162 * The vlc_fourcc_t type.
164 * See http://www.webartz.com/fourcc/ for a very detailed list.
166 typedef uint32_t vlc_fourcc_t;
168 #ifdef WORDS_BIGENDIAN
169 # define VLC_FOURCC( a, b, c, d ) \
170 ( ((uint32_t)d) | ( ((uint32_t)c) << 8 ) \
171 | ( ((uint32_t)b) << 16 ) | ( ((uint32_t)a) << 24 ) )
172 # define VLC_TWOCC( a, b ) \
173 ( (uint16_t)(b) | ( (uint16_t)(a) << 8 ) )
176 # define VLC_FOURCC( a, b, c, d ) \
177 ( ((uint32_t)a) | ( ((uint32_t)b) << 8 ) \
178 | ( ((uint32_t)c) << 16 ) | ( ((uint32_t)d) << 24 ) )
179 # define VLC_TWOCC( a, b ) \
180 ( (uint16_t)(a) | ( (uint16_t)(b) << 8 ) )
185 * Translate a vlc_fourcc into its string representation. This function
186 * assumes there is enough room in psz_fourcc to store 4 characters in.
188 * \param fcc a vlc_fourcc_t
189 * \param psz_fourcc string to store string representation of vlc_fourcc in
191 static inline void vlc_fourcc_to_char( vlc_fourcc_t fcc, char *psz_fourcc )
193 memcpy( psz_fourcc, &fcc, 4 );
196 #define vlc_fourcc_to_char( a, b ) \
197 vlc_fourcc_to_char( (vlc_fourcc_t)(a), (char *)(b) )
199 /*****************************************************************************
200 * Classes declaration
201 *****************************************************************************/
204 typedef struct vlc_list_t vlc_list_t;
205 typedef struct vlc_object_t vlc_object_t;
206 typedef struct libvlc_int_t libvlc_int_t;
207 typedef struct date_t date_t;
216 PLAYLIST_PLAY, /**< No arg. res=can fail*/
217 PLAYLIST_VIEWPLAY, /**< arg1= playlist_item_t*,*/
218 /** arg2 = playlist_item_t* , res=can fail */
219 PLAYLIST_PAUSE, /**< No arg res=can fail*/
220 PLAYLIST_STOP, /**< No arg res=can fail*/
221 PLAYLIST_SKIP, /**< arg1=int, res=can fail*/
222 } playlist_command_t;
225 typedef struct playlist_t playlist_t;
226 typedef struct playlist_item_t playlist_item_t;
227 typedef struct playlist_view_t playlist_view_t;
228 typedef struct services_discovery_t services_discovery_t;
229 typedef struct services_discovery_sys_t services_discovery_sys_t;
230 typedef struct playlist_add_t playlist_add_t;
233 typedef struct module_t module_t;
234 typedef struct module_config_t module_config_t;
236 typedef struct config_category_t config_category_t;
239 typedef struct input_thread_t input_thread_t;
240 typedef struct input_item_t input_item_t;
241 typedef struct input_item_node_t input_item_node_t;
242 typedef struct access_t access_t;
243 typedef struct access_sys_t access_sys_t;
244 typedef struct stream_t stream_t;
245 typedef struct stream_sys_t stream_sys_t;
246 typedef struct demux_t demux_t;
247 typedef struct demux_sys_t demux_sys_t;
248 typedef struct es_out_t es_out_t;
249 typedef struct es_out_id_t es_out_id_t;
250 typedef struct es_out_sys_t es_out_sys_t;
251 typedef struct seekpoint_t seekpoint_t;
252 typedef struct info_t info_t;
253 typedef struct info_category_t info_category_t;
254 typedef struct input_attachment_t input_attachment_t;
257 typedef struct audio_format_t audio_format_t;
258 typedef struct video_format_t video_format_t;
259 typedef struct subs_format_t subs_format_t;
260 typedef struct es_format_t es_format_t;
261 typedef struct video_palette_t video_palette_t;
264 typedef struct audio_output audio_output_t;
265 typedef struct aout_sys_t aout_sys_t;
266 typedef struct aout_fifo_t aout_fifo_t;
267 typedef struct aout_input_t aout_input_t;
268 typedef struct block_t aout_buffer_t;
269 typedef audio_format_t audio_sample_format_t;
272 typedef struct vout_thread_t vout_thread_t;
274 typedef video_format_t video_frame_format_t;
275 typedef struct picture_t picture_t;
276 typedef struct picture_sys_t picture_sys_t;
279 typedef struct spu_t spu_t;
280 typedef struct subpicture_t subpicture_t;
281 typedef struct subpicture_sys_t subpicture_sys_t;
282 typedef struct subpicture_region_t subpicture_region_t;
284 typedef struct image_handler_t image_handler_t;
287 typedef struct sout_instance_t sout_instance_t;
288 typedef struct sout_instance_sys_t sout_instance_sys_t;
290 typedef struct sout_input_t sout_input_t;
291 typedef struct sout_packetizer_input_t sout_packetizer_input_t;
293 typedef struct sout_access_out_t sout_access_out_t;
294 typedef struct sout_access_out_sys_t sout_access_out_sys_t;
296 typedef struct sout_mux_t sout_mux_t;
297 typedef struct sout_mux_sys_t sout_mux_sys_t;
299 typedef struct sout_stream_t sout_stream_t;
300 typedef struct sout_stream_sys_t sout_stream_sys_t;
302 typedef struct config_chain_t config_chain_t;
303 typedef struct session_descriptor_t session_descriptor_t;
306 typedef struct decoder_t decoder_t;
307 typedef struct decoder_sys_t decoder_sys_t;
308 typedef struct decoder_synchro_t decoder_synchro_t;
311 typedef struct encoder_t encoder_t;
312 typedef struct encoder_sys_t encoder_sys_t;
315 typedef struct filter_t filter_t;
316 typedef struct filter_sys_t filter_sys_t;
319 typedef struct virtual_socket_t v_socket_t;
320 typedef struct vlc_acl_t vlc_acl_t;
321 typedef struct vlc_url_t vlc_url_t;
324 typedef struct iso639_lang_t iso639_lang_t;
327 typedef struct block_t block_t;
328 typedef struct block_fifo_t block_fifo_t;
331 typedef struct httpd_t httpd_t;
332 typedef struct httpd_host_t httpd_host_t;
333 typedef struct httpd_url_t httpd_url_t;
334 typedef struct httpd_client_t httpd_client_t;
335 typedef struct httpd_callback_sys_t httpd_callback_sys_t;
336 typedef struct httpd_message_t httpd_message_t;
337 typedef int (*httpd_callback_t)( httpd_callback_sys_t *, httpd_client_t *, httpd_message_t *answer, const httpd_message_t *query );
338 typedef struct httpd_file_t httpd_file_t;
339 typedef struct httpd_file_sys_t httpd_file_sys_t;
340 typedef int (*httpd_file_callback_t)( httpd_file_sys_t *, httpd_file_t *, uint8_t *psz_request, uint8_t **pp_data, int *pi_data );
341 typedef struct httpd_handler_t httpd_handler_t;
342 typedef struct httpd_handler_sys_t httpd_handler_sys_t;
343 typedef int (*httpd_handler_callback_t)( httpd_handler_sys_t *, httpd_handler_t *, char *psz_url, uint8_t *psz_request, int i_type, uint8_t *p_in, int i_in, char *psz_remote_addr, char *psz_remote_host, uint8_t **pp_data, int *pi_data );
344 typedef struct httpd_redirect_t httpd_redirect_t;
345 typedef struct httpd_stream_t httpd_stream_t;
348 typedef struct md5_s md5_t;
351 typedef struct xml_t xml_t;
352 typedef struct xml_sys_t xml_sys_t;
353 typedef struct xml_reader_t xml_reader_t;
354 typedef struct xml_reader_sys_t xml_reader_sys_t;
357 typedef struct vod_t vod_t;
358 typedef struct vod_sys_t vod_sys_t;
359 typedef struct vod_media_t vod_media_t;
362 typedef struct osd_menu_t osd_menu_t;
363 typedef struct osd_state_t osd_state_t;
364 typedef struct osd_event_t osd_event_t;
365 typedef struct osd_button_t osd_button_t;
366 typedef struct osd_menu_state_t osd_menu_state_t;
369 typedef struct vlm_t vlm_t;
370 typedef struct vlm_message_t vlm_message_t;
373 typedef struct vlc_meta_t vlc_meta_t;
376 typedef struct counter_t counter_t;
377 typedef struct counter_sample_t counter_sample_t;
378 typedef struct stats_handler_t stats_handler_t;
379 typedef struct input_stats_t input_stats_t;
382 typedef struct update_t update_t;
383 typedef struct update_iterator_t update_iterator_t;
386 typedef struct meta_engine_t meta_engine_t;
388 /* stat/lstat/fstat */
390 #include <sys/stat.h>
394 #define stat _stati64
395 #define fstat _fstati64
398 /* You should otherwise use vlc_stat and vlc_lstat. */
404 * VLC value structure
413 vlc_object_t * p_object;
416 struct { int32_t x; int32_t y; } coords;
426 vlc_value_t * p_values;
431 /*****************************************************************************
432 * Error values (shouldn't be exposed)
433 *****************************************************************************/
434 #define VLC_SUCCESS -0 /* No error */
435 #define VLC_ENOMEM -1 /* Not enough memory */
436 #define VLC_ETIMEOUT -3 /* Timeout */
438 #define VLC_ENOMOD -10 /* Module not found */
440 #define VLC_ENOOBJ -20 /* Object not found */
442 #define VLC_ENOVAR -30 /* Variable not found */
443 #define VLC_EBADVAR -31 /* Bad variable value */
445 #define VLC_ENOITEM -40 /**< Item not found */
447 #define VLC_EEXIT -255 /* Program exited */
448 #define VLC_EEXITSUCCESS -999 /* Program exited successfully */
449 #define VLC_EGENERIC -666 /* Generic error */
451 /*****************************************************************************
453 *****************************************************************************/
454 typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */
455 char const *, /* variable name */
456 vlc_value_t, /* old value */
457 vlc_value_t, /* new value */
458 void * ); /* callback data */
460 /*****************************************************************************
461 * OS-specific headers and thread types
462 *****************************************************************************/
463 #if defined( WIN32 ) || defined( UNDER_CE )
464 # define WIN32_LEAN_AND_MEAN
465 # include <windows.h>
468 #include "vlc_mtime.h"
469 #include "vlc_threads.h"
472 * Memory storage space for an atom. Never access it directly.
476 volatile uintptr_t u;
480 /*****************************************************************************
481 * Common structure members
482 *****************************************************************************/
484 /* VLC_COMMON_MEMBERS : members common to all basic vlc objects */
485 #define VLC_COMMON_MEMBERS \
486 /** \name VLC_COMMON_MEMBERS \
487 * these members are common for all vlc objects \
490 const char *psz_object_type; \
492 /* Messages header */ \
496 /* Object properties */ \
497 volatile bool b_die; /**< set by the outside */ \
498 bool b_force; /**< set by the outside (eg. module_need()) */ \
500 /* Stuff related to the libvlc structure */ \
501 libvlc_int_t *p_libvlc; /**< (root of all evil) - 1 */ \
503 vlc_object_t * p_parent; /**< our parent */ \
507 /* VLC_OBJECT: attempt at doing a clever cast */
508 #if defined( __GNUC__ ) && __GNUC__ > 3
510 # define VLC_OBJECT( x ) \
511 __builtin_choose_expr( \
512 __builtin_offsetof(__typeof__(*(x)), psz_object_type), \
513 (void)0 /* screw you */, \
516 # define VLC_OBJECT( x ) \
517 ((vlc_object_t *)(x) \
518 + 0 * __builtin_offsetof(__typeof__(*(x)), psz_object_type))
521 # define VLC_OBJECT( x ) ((vlc_object_t *)(x))
524 typedef struct gc_object_t
527 void (*pf_destructor) (struct gc_object_t *);
531 * These members are common to all objects that wish to be garbage-collected.
533 #define VLC_GC_MEMBERS gc_object_t vlc_gc_data;
535 VLC_API void * vlc_gc_init(gc_object_t *, void (*)(gc_object_t *));
536 VLC_API void * vlc_hold(gc_object_t *);
537 VLC_API void vlc_release(gc_object_t *);
539 #define vlc_gc_init( a,b ) vlc_gc_init( &(a)->vlc_gc_data, (b) )
540 #define vlc_gc_incref( a ) vlc_hold( &(a)->vlc_gc_data )
541 #define vlc_gc_decref( a ) vlc_release( &(a)->vlc_gc_data )
542 #define vlc_priv( gc, t ) ((t *)(((char *)(gc)) - offsetof(t, vlc_gc_data)))
544 /*****************************************************************************
545 * Macros and inline functions
546 *****************************************************************************/
548 /* CEIL: division with round to nearest greater integer */
549 #define CEIL(n, d) ( ((n) / (d)) + ( ((n) % (d)) ? 1 : 0) )
551 /* PAD: PAD(n, d) = CEIL(n ,d) * d */
552 #define PAD(n, d) ( ((n) % (d)) ? ((((n) / (d)) + 1) * (d)) : (n) )
554 /* __MAX and __MIN: self explanatory */
556 # define __MAX(a, b) ( ((a) > (b)) ? (a) : (b) )
559 # define __MIN(a, b) ( ((a) < (b)) ? (a) : (b) )
563 static inline int64_t GCD ( int64_t a, int64_t b )
574 /* function imported from libavutil/common.h */
576 static inline uint8_t clip_uint8_vlc( int32_t a )
578 if( a&(~255) ) return (-a)>>31;
582 /* Count leading zeroes */
584 static inline unsigned clz (unsigned x)
587 return __builtin_clz (x);
589 unsigned i = sizeof (x) * 8;
600 #define clz8( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint8_t)) * 8))
601 #define clz16( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint16_t)) * 8))
602 /* XXX: this assumes that int is 32-bits or more */
603 #define clz32( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint32_t)) * 8))
607 static inline unsigned popcount (unsigned x)
610 return __builtin_popcount (x);
622 /* Free and set set the variable to NULL */
623 #define FREENULL(a) do { free( a ); a = NULL; } while(0)
625 #define EMPTY_STR(str) (!str || !*str)
627 VLC_API char const * vlc_error( int ) VLC_USED;
629 #include <vlc_arrays.h>
631 /* MSB (big endian)/LSB (little endian) conversions - network order is always
632 * MSB, and should be used for both network communications and files. */
634 static inline uint16_t U16_AT( const void * _p )
636 const uint8_t * p = (const uint8_t *)_p;
637 return ( ((uint16_t)p[0] << 8) | p[1] );
641 static inline uint32_t U32_AT( const void * _p )
643 const uint8_t * p = (const uint8_t *)_p;
644 return ( ((uint32_t)p[0] << 24) | ((uint32_t)p[1] << 16)
645 | ((uint32_t)p[2] << 8) | p[3] );
649 static inline uint64_t U64_AT( const void * _p )
651 const uint8_t * p = (const uint8_t *)_p;
652 return ( ((uint64_t)p[0] << 56) | ((uint64_t)p[1] << 48)
653 | ((uint64_t)p[2] << 40) | ((uint64_t)p[3] << 32)
654 | ((uint64_t)p[4] << 24) | ((uint64_t)p[5] << 16)
655 | ((uint64_t)p[6] << 8) | p[7] );
659 static inline uint16_t GetWLE( const void * _p )
661 const uint8_t * p = (const uint8_t *)_p;
662 return ( ((uint16_t)p[1] << 8) | p[0] );
666 static inline uint32_t GetDWLE( const void * _p )
668 const uint8_t * p = (const uint8_t *)_p;
669 return ( ((uint32_t)p[3] << 24) | ((uint32_t)p[2] << 16)
670 | ((uint32_t)p[1] << 8) | p[0] );
674 static inline uint64_t GetQWLE( const void * _p )
676 const uint8_t * p = (const uint8_t *)_p;
677 return ( ((uint64_t)p[7] << 56) | ((uint64_t)p[6] << 48)
678 | ((uint64_t)p[5] << 40) | ((uint64_t)p[4] << 32)
679 | ((uint64_t)p[3] << 24) | ((uint64_t)p[2] << 16)
680 | ((uint64_t)p[1] << 8) | p[0] );
683 #define GetWBE( p ) U16_AT( p )
684 #define GetDWBE( p ) U32_AT( p )
685 #define GetQWBE( p ) U64_AT( p )
687 /* Helper writer functions */
688 #define SetWLE( p, v ) _SetWLE( (uint8_t*)(p), v)
689 static inline void _SetWLE( uint8_t *p, uint16_t i_dw )
691 p[1] = ( i_dw >> 8 )&0xff;
692 p[0] = ( i_dw )&0xff;
695 #define SetDWLE( p, v ) _SetDWLE( (uint8_t*)(p), v)
696 static inline void _SetDWLE( uint8_t *p, uint32_t i_dw )
698 p[3] = ( i_dw >> 24 )&0xff;
699 p[2] = ( i_dw >> 16 )&0xff;
700 p[1] = ( i_dw >> 8 )&0xff;
701 p[0] = ( i_dw )&0xff;
703 #define SetQWLE( p, v ) _SetQWLE( (uint8_t*)(p), v)
704 static inline void _SetQWLE( uint8_t *p, uint64_t i_qw )
706 SetDWLE( p, i_qw&0xffffffff );
707 SetDWLE( p+4, ( i_qw >> 32)&0xffffffff );
709 #define SetWBE( p, v ) _SetWBE( (uint8_t*)(p), v)
710 static inline void _SetWBE( uint8_t *p, uint16_t i_dw )
712 p[0] = ( i_dw >> 8 )&0xff;
713 p[1] = ( i_dw )&0xff;
716 #define SetDWBE( p, v ) _SetDWBE( (uint8_t*)(p), v)
717 static inline void _SetDWBE( uint8_t *p, uint32_t i_dw )
719 p[0] = ( i_dw >> 24 )&0xff;
720 p[1] = ( i_dw >> 16 )&0xff;
721 p[2] = ( i_dw >> 8 )&0xff;
722 p[3] = ( i_dw )&0xff;
724 #define SetQWBE( p, v ) _SetQWBE( (uint8_t*)(p), v)
725 static inline void _SetQWBE( uint8_t *p, uint64_t i_qw )
727 SetDWBE( p+4, i_qw&0xffffffff );
728 SetDWBE( p, ( i_qw >> 32)&0xffffffff );
731 #define hton16(i) htons(i)
732 #define hton32(i) htonl(i)
733 #define ntoh16(i) ntohs(i)
734 #define ntoh32(i) ntohl(i)
737 static inline uint64_t ntoh64 (uint64_t ll)
739 union { uint64_t qw; uint8_t b[16]; } v = { ll };
740 return ((uint64_t)v.b[0] << 56)
741 | ((uint64_t)v.b[1] << 48)
742 | ((uint64_t)v.b[2] << 40)
743 | ((uint64_t)v.b[3] << 32)
744 | ((uint64_t)v.b[4] << 24)
745 | ((uint64_t)v.b[5] << 16)
746 | ((uint64_t)v.b[6] << 8)
747 | ((uint64_t)v.b[7] << 0);
749 #define hton64(i) ntoh64(i)
752 #define VLC_UNUSED(x) (void)(x)
754 /* Stuff defined in src/extras/libc.c */
756 #if defined(WIN32) || defined(UNDER_CE)
757 /* win32, cl and icl support */
758 # if defined( _MSC_VER ) || !defined( __MINGW32__ )
759 # define __attribute__(x)
760 # define S_IFBLK 0x3000 /* Block */
761 # define S_ISBLK(m) (0)
762 # define S_ISCHR(m) (0)
763 # define S_ISFIFO(m) (((m)&_S_IFMT) == _S_IFIFO)
764 # define S_ISREG(m) (((m)&_S_IFMT) == _S_IFREG)
767 /* several type definitions */
768 # if defined( __MINGW32__ )
769 # if !defined( _OFF_T_ )
770 typedef long long _off_t;
771 typedef _off_t off_t;
777 # define off_t long long
781 # if defined( _MSC_VER ) && !defined( __WXMSW__ )
782 # if !defined( _OFF_T_DEFINED )
783 typedef __int64 off_t;
784 # define _OFF_T_DEFINED
786 /* for wx compatibility typedef long off_t; */
787 # define off_t __int64
791 # if defined( __BORLANDC__ )
793 # define off_t unsigned __int64
797 # define O_NONBLOCK 0
801 # define alloca _alloca
807 VLC_API bool vlc_ureduce( unsigned *, unsigned *, uint64_t, uint64_t, uint64_t );
809 VLC_API void * vlc_memalign( void **base, size_t alignment, size_t size ) VLC_USED;
811 VLC_API void vlc_tdestroy( void *, void (*)(void *) );
813 /* Fast large memory copy and memory set */
814 VLC_API void * vlc_memcpy( void *, const void *, size_t );
815 #define vlc_memset memset
817 /*****************************************************************************
819 *****************************************************************************/
820 VLC_API char * vlc_gettext( const char *msgid ) VLC_FORMAT_ARG(1);
822 #define vlc_pgettext( ctx, id ) \
823 vlc_pgettext_aux( ctx "\004" id, id )
826 static inline const char *vlc_pgettext_aux( const char *ctx, const char *id )
828 const char *tr = vlc_gettext( ctx );
829 return (tr == ctx) ? id : tr;
832 /*****************************************************************************
833 * Loosy memory allocation functions. Do not use in new code.
834 *****************************************************************************/
835 static inline void *xmalloc (size_t len)
837 void *ptr = malloc (len);
838 if (unlikely (ptr == NULL))
843 static inline void *xrealloc (void *ptr, size_t len)
845 void *nptr = realloc (ptr, len);
846 if (unlikely (nptr == NULL))
851 static inline void *xcalloc (size_t n, size_t size)
853 void *ptr = calloc (n, size);
854 if (unlikely (ptr == NULL))
859 /*****************************************************************************
861 *****************************************************************************/
862 VLC_API const char * VLC_CompileBy( void ) VLC_USED;
863 VLC_API const char * VLC_CompileHost( void ) VLC_USED;
864 VLC_API const char * VLC_Compiler( void ) VLC_USED;
866 /*****************************************************************************
867 * Additional vlc stuff
868 *****************************************************************************/
869 #include "vlc_messages.h"
870 #include "vlc_objects.h"
871 #include "vlc_variables.h"
872 #include "vlc_main.h"
873 #include "vlc_configuration.h"
875 #if defined( WIN32 ) || defined( UNDER_CE ) || defined( __SYMBIAN32__ ) || defined( __OS2__ )
876 # define DIR_SEP_CHAR '\\'
877 # define DIR_SEP "\\"
878 # define PATH_SEP_CHAR ';'
879 # define PATH_SEP ";"
881 # define DIR_SEP_CHAR '/'
883 # define PATH_SEP_CHAR ':'
884 # define PATH_SEP ":"
887 #define LICENSE_MSG \
888 _("This program comes with NO WARRANTY, to the extent permitted by " \
889 "law.\nYou may redistribute it under the terms of the GNU General " \
890 "Public License;\nsee the file named COPYING for details.\n" \
891 "Written by the VideoLAN team; see the AUTHORS file.\n")
893 #endif /* !VLC_COMMON_H */