1 /*****************************************************************************
2 * vlc_common.h: common definitions
3 * Collection of useful common types and macros definitions
4 *****************************************************************************
5 * Copyright (C) 1998-2011 VLC authors and VideoLAN
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 it
13 * under the terms of the GNU Lesser General Public License as published by
14 * the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
22 * You should have received a copy of the GNU Lesser General Public License
23 * along with this program; if not, write to the Free Software Foundation,
24 * 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 /* Helper for GCC version checks */
61 # define VLC_GCC_VERSION(maj,min) \
62 ((__GNUC__ > (maj)) || (__GNUC__ == (maj) && __GNUC_MINOR__ >= (min)))
64 # define VLC_GCC_VERSION(maj,min) (0)
67 /* Try to fix format strings for all versions of mingw and mingw64 */
68 #if defined( _WIN32 ) && defined( __USE_MINGW_ANSI_STDIO )
79 #define snprintf __mingw_snprintf
80 #define vsnprintf __mingw_vsnprintf
83 /* Function attributes for compiler warnings */
85 # define VLC_DEPRECATED __attribute__((deprecated))
87 # if defined( _WIN32 ) && VLC_GCC_VERSION(4,4)
88 # define VLC_FORMAT(x,y) __attribute__ ((format(gnu_printf,x,y)))
90 # define VLC_FORMAT(x,y) __attribute__ ((format(printf,x,y)))
92 # define VLC_FORMAT_ARG(x) __attribute__ ((format_arg(x)))
94 # define VLC_MALLOC __attribute__ ((malloc))
95 # define VLC_NORETURN __attribute__ ((noreturn))
97 # if VLC_GCC_VERSION(3,4)
98 # define VLC_USED __attribute__ ((warn_unused_result))
104 # define VLC_DEPRECATED
105 # define VLC_FORMAT(x,y)
106 # define VLC_FORMAT_ARG(x)
108 # define VLC_NORETURN
113 /* Branch prediction */
115 # define likely(p) __builtin_expect(!!(p), 1)
116 # define unlikely(p) __builtin_expect(!!(p), 0)
118 # define likely(p) (!!(p))
119 # define unlikely(p) (!!(p))
124 # define VLC_EXTERN extern "C"
129 #if defined (WIN32) && defined (DLL_EXPORT)
130 # define VLC_EXPORT __declspec(dllexport)
131 #elif VLC_GCC_VERSION(4,0)
132 # define VLC_EXPORT __attribute__((visibility("default")))
137 #define VLC_API VLC_EXTERN VLC_EXPORT
140 /*****************************************************************************
141 * Basic types definitions
142 *****************************************************************************/
143 #if defined( WIN32 ) || defined( UNDER_CE )
146 # define PATH_MAX MAX_PATH
151 #include <sys/syslimits.h>
155 typedef uint16_t audio_volume_t
;
158 * High precision date or time interval
160 * Store a high precision date or time interval. The maximum precision is the
161 * microsecond, and a 64 bits integer is used to avoid overflows (maximum
162 * time interval is then 292271 years, which should be long enough for any
163 * video). Dates are stored as microseconds since a common date (usually the
164 * epoch). Note that date and time intervals can be manipulated using regular
165 * arithmetic operators, and that no special functions are required.
167 typedef int64_t mtime_t
;
170 * The vlc_fourcc_t type.
172 * See http://www.webartz.com/fourcc/ for a very detailed list.
174 typedef uint32_t vlc_fourcc_t
;
176 #ifdef WORDS_BIGENDIAN
177 # define VLC_FOURCC( a, b, c, d ) \
178 ( ((uint32_t)d) | ( ((uint32_t)c) << 8 ) \
179 | ( ((uint32_t)b) << 16 ) | ( ((uint32_t)a) << 24 ) )
180 # define VLC_TWOCC( a, b ) \
181 ( (uint16_t)(b) | ( (uint16_t)(a) << 8 ) )
184 # define VLC_FOURCC( a, b, c, d ) \
185 ( ((uint32_t)a) | ( ((uint32_t)b) << 8 ) \
186 | ( ((uint32_t)c) << 16 ) | ( ((uint32_t)d) << 24 ) )
187 # define VLC_TWOCC( a, b ) \
188 ( (uint16_t)(a) | ( (uint16_t)(b) << 8 ) )
193 * Translate a vlc_fourcc into its string representation. This function
194 * assumes there is enough room in psz_fourcc to store 4 characters in.
196 * \param fcc a vlc_fourcc_t
197 * \param psz_fourcc string to store string representation of vlc_fourcc in
199 static inline void vlc_fourcc_to_char( vlc_fourcc_t fcc
, char *psz_fourcc
)
201 memcpy( psz_fourcc
, &fcc
, 4 );
204 #define vlc_fourcc_to_char( a, b ) \
205 vlc_fourcc_to_char( (vlc_fourcc_t)(a), (char *)(b) )
207 /*****************************************************************************
208 * Classes declaration
209 *****************************************************************************/
212 typedef struct vlc_list_t vlc_list_t
;
213 typedef struct vlc_object_t vlc_object_t
;
214 typedef struct libvlc_int_t libvlc_int_t
;
215 typedef struct date_t date_t
;
224 PLAYLIST_PLAY
, /**< No arg. res=can fail*/
225 PLAYLIST_VIEWPLAY
, /**< arg1= playlist_item_t*,*/
226 /** arg2 = playlist_item_t* , res=can fail */
227 PLAYLIST_PAUSE
, /**< No arg res=can fail*/
228 PLAYLIST_STOP
, /**< No arg res=can fail*/
229 PLAYLIST_SKIP
, /**< arg1=int, res=can fail*/
230 } playlist_command_t
;
233 typedef struct playlist_t playlist_t
;
234 typedef struct playlist_item_t playlist_item_t
;
235 typedef struct playlist_view_t playlist_view_t
;
236 typedef struct services_discovery_t services_discovery_t
;
237 typedef struct services_discovery_sys_t services_discovery_sys_t
;
238 typedef struct playlist_add_t playlist_add_t
;
241 typedef struct module_t module_t
;
242 typedef struct module_config_t module_config_t
;
244 typedef struct config_category_t config_category_t
;
247 typedef struct input_thread_t input_thread_t
;
248 typedef struct input_item_t input_item_t
;
249 typedef struct input_item_node_t input_item_node_t
;
250 typedef struct access_t access_t
;
251 typedef struct access_sys_t access_sys_t
;
252 typedef struct stream_t stream_t
;
253 typedef struct stream_sys_t stream_sys_t
;
254 typedef struct demux_t demux_t
;
255 typedef struct demux_sys_t demux_sys_t
;
256 typedef struct es_out_t es_out_t
;
257 typedef struct es_out_id_t es_out_id_t
;
258 typedef struct es_out_sys_t es_out_sys_t
;
259 typedef struct seekpoint_t seekpoint_t
;
260 typedef struct info_t info_t
;
261 typedef struct info_category_t info_category_t
;
262 typedef struct input_attachment_t input_attachment_t
;
265 typedef struct audio_format_t audio_format_t
;
266 typedef struct video_format_t video_format_t
;
267 typedef struct subs_format_t subs_format_t
;
268 typedef struct es_format_t es_format_t
;
269 typedef struct video_palette_t video_palette_t
;
272 typedef struct audio_output audio_output_t
;
273 typedef struct aout_sys_t aout_sys_t
;
274 typedef struct aout_fifo_t aout_fifo_t
;
275 typedef struct aout_input_t aout_input_t
;
276 typedef struct block_t aout_buffer_t
;
277 typedef audio_format_t audio_sample_format_t
;
280 typedef struct vout_thread_t vout_thread_t
;
282 typedef video_format_t video_frame_format_t
;
283 typedef struct picture_t picture_t
;
284 typedef struct picture_sys_t picture_sys_t
;
287 typedef struct spu_t spu_t
;
288 typedef struct subpicture_t subpicture_t
;
289 typedef struct subpicture_sys_t subpicture_sys_t
;
290 typedef struct subpicture_region_t subpicture_region_t
;
292 typedef struct image_handler_t image_handler_t
;
295 typedef struct sout_instance_t sout_instance_t
;
296 typedef struct sout_instance_sys_t sout_instance_sys_t
;
298 typedef struct sout_input_t sout_input_t
;
299 typedef struct sout_packetizer_input_t sout_packetizer_input_t
;
301 typedef struct sout_access_out_t sout_access_out_t
;
302 typedef struct sout_access_out_sys_t sout_access_out_sys_t
;
304 typedef struct sout_mux_t sout_mux_t
;
305 typedef struct sout_mux_sys_t sout_mux_sys_t
;
307 typedef struct sout_stream_t sout_stream_t
;
308 typedef struct sout_stream_sys_t sout_stream_sys_t
;
310 typedef struct config_chain_t config_chain_t
;
311 typedef struct session_descriptor_t session_descriptor_t
;
314 typedef struct decoder_t decoder_t
;
315 typedef struct decoder_sys_t decoder_sys_t
;
316 typedef struct decoder_synchro_t decoder_synchro_t
;
319 typedef struct encoder_t encoder_t
;
320 typedef struct encoder_sys_t encoder_sys_t
;
323 typedef struct filter_t filter_t
;
324 typedef struct filter_sys_t filter_sys_t
;
327 typedef struct virtual_socket_t v_socket_t
;
328 typedef struct vlc_acl_t vlc_acl_t
;
329 typedef struct vlc_url_t vlc_url_t
;
332 typedef struct iso639_lang_t iso639_lang_t
;
335 typedef struct block_t block_t
;
336 typedef struct block_fifo_t block_fifo_t
;
339 typedef struct httpd_t httpd_t
;
340 typedef struct httpd_host_t httpd_host_t
;
341 typedef struct httpd_url_t httpd_url_t
;
342 typedef struct httpd_client_t httpd_client_t
;
343 typedef struct httpd_callback_sys_t httpd_callback_sys_t
;
344 typedef struct httpd_message_t httpd_message_t
;
345 typedef int (*httpd_callback_t
)( httpd_callback_sys_t
*, httpd_client_t
*, httpd_message_t
*answer
, const httpd_message_t
*query
);
346 typedef struct httpd_file_t httpd_file_t
;
347 typedef struct httpd_file_sys_t httpd_file_sys_t
;
348 typedef int (*httpd_file_callback_t
)( httpd_file_sys_t
*, httpd_file_t
*, uint8_t *psz_request
, uint8_t **pp_data
, int *pi_data
);
349 typedef struct httpd_handler_t httpd_handler_t
;
350 typedef struct httpd_handler_sys_t httpd_handler_sys_t
;
351 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
);
352 typedef struct httpd_redirect_t httpd_redirect_t
;
353 typedef struct httpd_stream_t httpd_stream_t
;
356 typedef struct md5_s md5_t
;
359 typedef struct xml_t xml_t
;
360 typedef struct xml_sys_t xml_sys_t
;
361 typedef struct xml_reader_t xml_reader_t
;
362 typedef struct xml_reader_sys_t xml_reader_sys_t
;
365 typedef struct vod_t vod_t
;
366 typedef struct vod_sys_t vod_sys_t
;
367 typedef struct vod_media_t vod_media_t
;
370 typedef struct osd_menu_t osd_menu_t
;
371 typedef struct osd_state_t osd_state_t
;
372 typedef struct osd_event_t osd_event_t
;
373 typedef struct osd_button_t osd_button_t
;
374 typedef struct osd_menu_state_t osd_menu_state_t
;
377 typedef struct vlm_t vlm_t
;
378 typedef struct vlm_message_t vlm_message_t
;
381 typedef struct vlc_meta_t vlc_meta_t
;
382 typedef struct input_stats_t input_stats_t
;
385 typedef struct update_t update_t
;
386 typedef struct update_iterator_t update_iterator_t
;
389 typedef struct meta_engine_t meta_engine_t
;
392 * VLC value structure
401 vlc_object_t
* p_object
;
404 struct { int32_t x
; int32_t y
; } coords
;
414 vlc_value_t
* p_values
;
419 /*****************************************************************************
420 * Error values (shouldn't be exposed)
421 *****************************************************************************/
422 #define VLC_SUCCESS -0 /* No error */
423 #define VLC_ENOMEM -1 /* Not enough memory */
424 #define VLC_ETIMEOUT -3 /* Timeout */
426 #define VLC_ENOMOD -10 /* Module not found */
428 #define VLC_ENOOBJ -20 /* Object not found */
430 #define VLC_ENOVAR -30 /* Variable not found */
431 #define VLC_EBADVAR -31 /* Bad variable value */
433 #define VLC_ENOITEM -40 /**< Item not found */
435 #define VLC_EEXIT -255 /* Program exited */
436 #define VLC_EEXITSUCCESS -999 /* Program exited successfully */
437 #define VLC_EGENERIC -666 /* Generic error */
439 /*****************************************************************************
441 *****************************************************************************/
442 typedef int ( * vlc_callback_t
) ( vlc_object_t
*, /* variable's object */
443 char const *, /* variable name */
444 vlc_value_t
, /* old value */
445 vlc_value_t
, /* new value */
446 void * ); /* callback data */
448 /*****************************************************************************
449 * OS-specific headers and thread types
450 *****************************************************************************/
451 #if defined( WIN32 ) || defined( UNDER_CE )
452 # include <windows.h>
456 # define OS2EMX_PLAIN_CHAR
462 #include "vlc_mtime.h"
463 #include "vlc_threads.h"
466 * Memory storage space for an atom. Never access it directly.
470 volatile uintptr_t u
;
474 /*****************************************************************************
475 * Common structure members
476 *****************************************************************************/
478 /* VLC_COMMON_MEMBERS : members common to all basic vlc objects */
479 #define VLC_COMMON_MEMBERS \
480 /** \name VLC_COMMON_MEMBERS \
481 * these members are common for all vlc objects \
484 const char *psz_object_type; \
486 /* Messages header */ \
490 /* Object properties */ \
491 volatile bool b_die; /**< set by the outside */ \
492 bool b_force; /**< set by the outside (eg. module_need()) */ \
494 /* Stuff related to the libvlc structure */ \
495 libvlc_int_t *p_libvlc; /**< (root of all evil) - 1 */ \
497 vlc_object_t * p_parent; /**< our parent */ \
501 /* VLC_OBJECT: attempt at doing a clever cast */
502 #if VLC_GCC_VERSION(4,0)
504 # define VLC_OBJECT( x ) \
505 __builtin_choose_expr( \
506 __builtin_offsetof(__typeof__(*(x)), psz_object_type), \
507 (void)0 /* screw you */, \
510 # define VLC_OBJECT( x ) \
511 ((vlc_object_t *)(x) \
512 + 0 * __builtin_offsetof(__typeof__(*(x)), psz_object_type))
515 # define VLC_OBJECT( x ) ((vlc_object_t *)(x))
518 typedef struct gc_object_t
521 void (*pf_destructor
) (struct gc_object_t
*);
525 * These members are common to all objects that wish to be garbage-collected.
527 #define VLC_GC_MEMBERS gc_object_t vlc_gc_data;
529 VLC_API
void * vlc_gc_init(gc_object_t
*, void (*)(gc_object_t
*));
530 VLC_API
void * vlc_hold(gc_object_t
*);
531 VLC_API
void vlc_release(gc_object_t
*);
533 #define vlc_gc_init( a,b ) vlc_gc_init( &(a)->vlc_gc_data, (b) )
534 #define vlc_gc_incref( a ) vlc_hold( &(a)->vlc_gc_data )
535 #define vlc_gc_decref( a ) vlc_release( &(a)->vlc_gc_data )
536 #define vlc_priv( gc, t ) ((t *)(((char *)(gc)) - offsetof(t, vlc_gc_data)))
538 /*****************************************************************************
539 * Macros and inline functions
540 *****************************************************************************/
542 /* CEIL: division with round to nearest greater integer */
543 #define CEIL(n, d) ( ((n) / (d)) + ( ((n) % (d)) ? 1 : 0) )
545 /* PAD: PAD(n, d) = CEIL(n ,d) * d */
546 #define PAD(n, d) ( ((n) % (d)) ? ((((n) / (d)) + 1) * (d)) : (n) )
548 /* __MAX and __MIN: self explanatory */
550 # define __MAX(a, b) ( ((a) > (b)) ? (a) : (b) )
553 # define __MIN(a, b) ( ((a) < (b)) ? (a) : (b) )
556 /* clip v in [min, max] */
557 #define VLC_CLIP(v, min, max) __MIN(__MAX((v), (min)), (max))
560 static inline int64_t GCD ( int64_t a
, int64_t b
)
571 /* function imported from libavutil/common.h */
573 static inline uint8_t clip_uint8_vlc( int32_t a
)
575 if( a
&(~255) ) return (-a
)>>31;
579 /** Count leading zeroes */
581 static inline unsigned clz (unsigned x
)
583 #if VLC_GCC_VERSION(3,4)
584 return __builtin_clz (x
);
586 unsigned i
= sizeof (x
) * 8;
597 #define clz8( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint8_t)) * 8))
598 #define clz16( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint16_t)) * 8))
599 /* XXX: this assumes that int is 32-bits or more */
600 #define clz32( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint32_t)) * 8))
604 static inline unsigned popcount (unsigned x
)
606 #if VLC_GCC_VERSION(3,4)
607 return __builtin_popcount (x
);
625 /** Byte swap (16 bits) */
627 static inline uint16_t bswap16 (uint16_t x
)
629 return (x
<< 8) | (x
>> 8);
632 /** Byte swap (32 bits) */
634 static inline uint32_t bswap32 (uint32_t x
)
636 #if VLC_GCC_VERSION(4,3)
637 return __builtin_bswap32 (x
);
639 return ((x
& 0x000000FF) << 24)
640 | ((x
& 0x0000FF00) << 8)
641 | ((x
& 0x00FF0000) >> 8)
642 | ((x
& 0xFF000000) >> 24);
646 /** Byte swap (64 bits) */
648 static inline uint64_t bswap64 (uint64_t x
)
650 #if VLC_GCC_VERSION(4,3)
651 return __builtin_bswap64 (x
);
652 #elif !defined (__cplusplus)
653 return ((x
& 0x00000000000000FF) << 56)
654 | ((x
& 0x000000000000FF00) << 40)
655 | ((x
& 0x0000000000FF0000) << 24)
656 | ((x
& 0x00000000FF000000) << 8)
657 | ((x
& 0x000000FF00000000) >> 8)
658 | ((x
& 0x0000FF0000000000) >> 24)
659 | ((x
& 0x00FF000000000000) >> 40)
660 | ((x
& 0xFF00000000000000) >> 56);
662 return ((x
& 0x00000000000000FFLLU
) << 56)
663 | ((x
& 0x000000000000FF00LLU
) << 40)
664 | ((x
& 0x0000000000FF0000LLU
) << 24)
665 | ((x
& 0x00000000FF000000LLU
) << 8)
666 | ((x
& 0x000000FF00000000LLU
) >> 8)
667 | ((x
& 0x0000FF0000000000LLU
) >> 24)
668 | ((x
& 0x00FF000000000000LLU
) >> 40)
669 | ((x
& 0xFF00000000000000LLU
) >> 56);
674 /* Free and set set the variable to NULL */
675 #define FREENULL(a) do { free( a ); a = NULL; } while(0)
677 #define EMPTY_STR(str) (!str || !*str)
679 VLC_API
char const * vlc_error( int ) VLC_USED
;
681 #include <vlc_arrays.h>
683 /* MSB (big endian)/LSB (little endian) conversions - network order is always
684 * MSB, and should be used for both network communications and files. */
686 #ifdef WORDS_BIGENDIAN
687 # define hton16(i) ((uint16_t)(i))
688 # define hton32(i) ((uint32_t)(i))
689 # define hton64(i) ((uint64_t)(i))
691 # define hton16(i) bswap16(i)
692 # define hton32(i) bswap32(i)
693 # define hton64(i) bswap64(i)
695 #define ntoh16(i) hton16(i)
696 #define ntoh32(i) hton32(i)
697 #define ntoh64(i) hton64(i)
699 /** Reads 16 bits in network byte order */
701 static inline uint16_t U16_AT (const void *p
)
705 memcpy (&x
, p
, sizeof (x
));
709 /** Reads 32 bits in network byte order */
711 static inline uint32_t U32_AT (const void *p
)
715 memcpy (&x
, p
, sizeof (x
));
719 /** Reads 64 bits in network byte order */
721 static inline uint64_t U64_AT (const void *p
)
725 memcpy (&x
, p
, sizeof (x
));
729 #define GetWBE(p) U16_AT(p)
730 #define GetDWBE(p) U32_AT(p)
731 #define GetQWBE(p) U64_AT(p)
733 /** Reads 16 bits in little-endian order */
735 static inline uint16_t GetWLE (const void *p
)
739 memcpy (&x
, p
, sizeof (x
));
740 #ifdef WORDS_BIGENDIAN
746 /** Reads 32 bits in little-endian order */
748 static inline uint32_t GetDWLE (const void *p
)
752 memcpy (&x
, p
, sizeof (x
));
753 #ifdef WORDS_BIGENDIAN
759 /** Reads 64 bits in little-endian order */
761 static inline uint64_t GetQWLE (const void *p
)
765 memcpy (&x
, p
, sizeof (x
));
766 #ifdef WORDS_BIGENDIAN
772 /** Writes 16 bits in network byte order */
773 static inline void SetWBE (void *p
, uint16_t w
)
776 memcpy (p
, &w
, sizeof (w
));
779 /** Writes 32 bits in network byte order */
780 static inline void SetDWBE (void *p
, uint32_t dw
)
783 memcpy (p
, &dw
, sizeof (dw
));
786 /** Writes 64 bits in network byte order */
787 static inline void SetQWBE (void *p
, uint64_t qw
)
790 memcpy (p
, &qw
, sizeof (qw
));
793 /** Writes 16 bits in little endian order */
794 static inline void SetWLE (void *p
, uint16_t w
)
796 #ifdef WORDS_BIGENDIAN
799 memcpy (p
, &w
, sizeof (w
));
802 /** Writes 32 bits in little endian order */
803 static inline void SetDWLE (void *p
, uint32_t dw
)
805 #ifdef WORDS_BIGENDIAN
808 memcpy (p
, &dw
, sizeof (dw
));
811 /** Writes 64 bits in little endian order */
812 static inline void SetQWLE (void *p
, uint64_t qw
)
814 #ifdef WORDS_BIGENDIAN
817 memcpy (p
, &qw
, sizeof (qw
));
821 #define VLC_UNUSED(x) (void)(x)
823 /* Stuff defined in src/extras/libc.c */
825 #if defined(WIN32) || defined(UNDER_CE)
826 /* win32, cl and icl support */
827 # if defined( _MSC_VER ) || !defined( __MINGW32__ )
828 # define __attribute__(x)
829 # define S_IFBLK 0x3000 /* Block */
830 # define S_ISBLK(m) (0)
831 # define S_ISCHR(m) (0)
832 # define S_ISFIFO(m) (((m)&_S_IFMT) == _S_IFIFO)
833 # define S_ISREG(m) (((m)&_S_IFMT) == _S_IFREG)
836 /* several type definitions */
837 # if defined( __MINGW32__ )
838 # if !defined( _OFF_T_ )
839 typedef long long _off_t
;
840 typedef _off_t off_t
;
846 # define off_t long long
850 # if defined( _MSC_VER )
851 # if !defined( _OFF_T_DEFINED )
852 typedef __int64 off_t
;
853 # define _OFF_T_DEFINED
855 /* for wx compatibility typedef long off_t; */
856 # define off_t __int64
860 # if defined( __BORLANDC__ )
862 # define off_t unsigned __int64
866 # define O_NONBLOCK 0
870 # define alloca _alloca
876 VLC_API
bool vlc_ureduce( unsigned *, unsigned *, uint64_t, uint64_t, uint64_t );
878 /* Aligned memory allocator */
880 #include <AvailabilityMacros.h>
885 # define vlc_memalign(align, size) (__mingw_aligned_malloc(size, align))
886 # define vlc_free(base) (__mingw_aligned_free(base))
887 #elif defined(__APPLE__) && !defined(MAC_OS_X_VERSION_10_6)
888 static inline void *vlc_memalign(size_t align
, size_t size
)
893 ptr
= malloc(size
+align
);
896 diff
= ((-(long)ptr
- 1)&(align
-1)) + 1;
897 ptr
= (char*)ptr
+ diff
;
898 ((char*)ptr
)[-1]= diff
;
902 static void vlc_free(void *ptr
)
905 free((char*)ptr
- ((char*)ptr
)[-1]);
907 #elif defined(__ANDROID__)
908 # define vlc_memalign(align, size) memalign(align, size)
909 # define vlc_free(base) free(base)
911 static inline void *vlc_memalign(size_t align
, size_t size
)
914 if (unlikely(posix_memalign(&base
, align
, size
)))
918 # define vlc_free(base) free(base)
921 VLC_API
void vlc_tdestroy( void *, void (*)(void *) );
923 /* Fast large memory copy and memory set */
924 VLC_API
void * vlc_memcpy( void *, const void *, size_t );
925 #define vlc_memset memset
927 /*****************************************************************************
929 *****************************************************************************/
930 VLC_API
char * vlc_gettext( const char *msgid
) VLC_FORMAT_ARG(1);
932 #define vlc_pgettext( ctx, id ) \
933 vlc_pgettext_aux( ctx "\004" id, id )
936 static inline const char *vlc_pgettext_aux( const char *ctx
, const char *id
)
938 const char *tr
= vlc_gettext( ctx
);
939 return (tr
== ctx
) ? id
: tr
;
942 /*****************************************************************************
943 * Loosy memory allocation functions. Do not use in new code.
944 *****************************************************************************/
945 static inline void *xmalloc (size_t len
)
947 void *ptr
= malloc (len
);
948 if (unlikely (ptr
== NULL
))
953 static inline void *xrealloc (void *ptr
, size_t len
)
955 void *nptr
= realloc (ptr
, len
);
956 if (unlikely (nptr
== NULL
))
961 static inline void *xcalloc (size_t n
, size_t size
)
963 void *ptr
= calloc (n
, size
);
964 if (unlikely (ptr
== NULL
))
969 /*****************************************************************************
971 *****************************************************************************/
972 VLC_API
const char * VLC_CompileBy( void ) VLC_USED
;
973 VLC_API
const char * VLC_CompileHost( void ) VLC_USED
;
974 VLC_API
const char * VLC_Compiler( void ) VLC_USED
;
976 /*****************************************************************************
977 * Additional vlc stuff
978 *****************************************************************************/
979 #include "vlc_messages.h"
980 #include "vlc_objects.h"
981 #include "vlc_variables.h"
982 #include "vlc_main.h"
983 #include "vlc_configuration.h"
985 #if defined( WIN32 ) || defined( UNDER_CE ) || defined( __SYMBIAN32__ ) || defined( __OS2__ )
986 # define DIR_SEP_CHAR '\\'
987 # define DIR_SEP "\\"
988 # define PATH_SEP_CHAR ';'
989 # define PATH_SEP ";"
991 # define DIR_SEP_CHAR '/'
993 # define PATH_SEP_CHAR ':'
994 # define PATH_SEP ":"
997 #define LICENSE_MSG \
998 _("This program comes with NO WARRANTY, to the extent permitted by " \
999 "law.\nYou may redistribute it under the terms of the GNU General " \
1000 "Public License;\nsee the file named COPYING for details.\n" \
1001 "Written by the VideoLAN team; see the AUTHORS file.\n")
1003 #endif /* !VLC_COMMON_H */