LibreOffice
LibreOffice 6.1 SDK C/C++ API Reference
types.h
Go to the documentation of this file.
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3  * This file is part of the LibreOffice project.
4  *
5  * This Source Code Form is subject to the terms of the Mozilla Public
6  * License, v. 2.0. If a copy of the MPL was not distributed with this
7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8  *
9  * This file incorporates work covered by the following license notice:
10  *
11  * Licensed to the Apache Software Foundation (ASF) under one or more
12  * contributor license agreements. See the NOTICE file distributed
13  * with this work for additional information regarding copyright
14  * ownership. The ASF licenses this file to you under the Apache
15  * License, Version 2.0 (the "License"); you may not use this file
16  * except in compliance with the License. You may obtain a copy of
17  * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18  */
19 
20 #ifndef INCLUDED_SAL_TYPES_H
21 #define INCLUDED_SAL_TYPES_H
22 
23 #include "sal/config.h"
24 
25 #include <stddef.h>
26 
27 #include "sal/macros.h"
28 #include "sal/typesizes.h"
29 
30 #if defined LIBO_INTERNAL_ONLY
31 #include "config_global.h"
32 #endif
33 
34 #ifdef __cplusplus
35 extern "C" {
36 #endif
37 
38 typedef unsigned char sal_Bool;
39 # define sal_False ((sal_Bool)0)
40 # define sal_True ((sal_Bool)1)
41 
42 /* char is assumed to always be 1 byte long */
43 typedef signed char sal_Int8;
44 typedef unsigned char sal_uInt8;
45 
46 #if SAL_TYPES_SIZEOFSHORT == 2
47  typedef signed short sal_Int16;
48  typedef unsigned short sal_uInt16;
49 #else
50  #error "Could not find 16-bit type, add support for your architecture"
51 #endif
52 
53 #if SAL_TYPES_SIZEOFLONG == 4
54  typedef signed long sal_Int32;
55  typedef unsigned long sal_uInt32;
56  #define SAL_PRIdINT32 "ld"
57  #define SAL_PRIuUINT32 "lu"
58  #define SAL_PRIxUINT32 "lx"
59  #define SAL_PRIXUINT32 "lX"
60 #elif SAL_TYPES_SIZEOFINT == 4
61  typedef signed int sal_Int32;
62  typedef unsigned int sal_uInt32;
63  #define SAL_PRIdINT32 "d"
64  #define SAL_PRIuUINT32 "u"
65  #define SAL_PRIxUINT32 "x"
66  #define SAL_PRIXUINT32 "X"
67 #else
68  #error "Could not find 32-bit type, add support for your architecture"
69 #endif
70 
71 #ifdef _MSC_VER
72  typedef __int64 sal_Int64;
73  typedef unsigned __int64 sal_uInt64;
74 
75  /* The following are macros that will add the 64 bit constant suffix. */
76  #define SAL_CONST_INT64(x) x##i64
77  #define SAL_CONST_UINT64(x) x##ui64
78 
79  #define SAL_PRIdINT64 "I64d"
80  #define SAL_PRIuUINT64 "I64u"
81  #define SAL_PRIxUINT64 "I64x"
82  #define SAL_PRIXUINT64 "I64X"
83 #elif defined (__GNUC__)
84  #if SAL_TYPES_SIZEOFLONG == 8
85  typedef signed long int sal_Int64;
86  typedef unsigned long int sal_uInt64;
87 
88 
89  /* The following are macros that will add the 64 bit constant suffix. */
90  #define SAL_CONST_INT64(x) x##l
91  #define SAL_CONST_UINT64(x) x##ul
92 
93  #define SAL_PRIdINT64 "ld"
94  #define SAL_PRIuUINT64 "lu"
95  #define SAL_PRIxUINT64 "lx"
96  #define SAL_PRIXUINT64 "lX"
97  #elif SAL_TYPES_SIZEOFLONGLONG == 8
98  typedef signed long long sal_Int64;
99  typedef unsigned long long sal_uInt64;
100 
101  /* The following are macros that will add the 64 bit constant suffix. */
102  #define SAL_CONST_INT64(x) x##ll
103  #define SAL_CONST_UINT64(x) x##ull
104 
105  #define SAL_PRIdINT64 "lld"
106  #define SAL_PRIuUINT64 "llu"
107  #define SAL_PRIxUINT64 "llx"
108  #define SAL_PRIXUINT64 "llX"
109  #else
110  #error "Could not find 64-bit type, add support for your architecture"
111  #endif
112 #else
113  #error "Please define the 64-bit types for your architecture/compiler in include/sal/types.h"
114 #endif
115 
120 typedef char sal_Char;
121 
126 typedef signed char sal_sChar;
127 
132 typedef unsigned char sal_uChar;
133 
134 #if defined LIBO_INTERNAL_ONLY && defined __cplusplus
135  #define SAL_UNICODE_NOTEQUAL_WCHAR_T
136  typedef char16_t sal_Unicode;
137 #elif defined(_WIN32)
138  typedef wchar_t sal_Unicode;
139 #else
140  #define SAL_UNICODE_NOTEQUAL_WCHAR_T
141  typedef sal_uInt16 sal_Unicode;
142 #endif
143 
144 typedef void * sal_Handle;
145 
146 /* sal_Size should currently be the native width of the platform */
147 #if SAL_TYPES_SIZEOFPOINTER == 4
148  typedef sal_uInt32 sal_Size;
149  typedef sal_Int32 sal_sSize;
150 #elif SAL_TYPES_SIZEOFPOINTER == 8
151  typedef sal_uInt64 sal_Size;
152  typedef sal_Int64 sal_sSize;
153 #else
154  #error "Please make sure SAL_TYPES_SIZEOFPOINTER is defined for your architecture/compiler"
155 #endif
156 
157 /* sal_PtrDiff holds the result of a pointer subtraction */
158 #if SAL_TYPES_SIZEOFPOINTER == 4
159  typedef sal_Int32 sal_PtrDiff;
160 #elif SAL_TYPES_SIZEOFPOINTER == 8
161  typedef sal_Int64 sal_PtrDiff;
162 #else
163  #error "Please make sure SAL_TYPES_SIZEOFPOINTER is defined for your architecture/compiler"
164 #endif
165 
166 /* printf-style conversion specification length modifiers for size_t and
167  ptrdiff_t (most platforms support C99, MSC has its own extension) */
168 #if defined(_MSC_VER)
169  #define SAL_PRI_SIZET "I"
170  #define SAL_PRI_PTRDIFFT "I"
171 #else
172  #define SAL_PRI_SIZET "z"
173  #define SAL_PRI_PTRDIFFT "t"
174 #endif
175 
176 /* sal_IntPtr, sal_uIntPtr are integer types designed to hold pointers so that any valid
177  * pointer to void can be converted to this type and back to a pointer to void and the
178  * result will compare to the original pointer */
179 #if SAL_TYPES_SIZEOFPOINTER == 4
180  typedef sal_Int32 sal_IntPtr;
181  typedef sal_uInt32 sal_uIntPtr;
182  #define SAL_PRIdINTPTR SAL_PRIdINT32
183  #define SAL_PRIuUINTPTR SAL_PRIuUINT32
184  #define SAL_PRIxUINTPTR SAL_PRIxUINT32
185  #define SAL_PRIXUINTPTR SAL_PRIXUINT32
186 #elif SAL_TYPES_SIZEOFPOINTER == 8
187  typedef sal_Int64 sal_IntPtr;
188  typedef sal_uInt64 sal_uIntPtr;
189  #define SAL_PRIdINTPTR SAL_PRIdINT64
190  #define SAL_PRIuUINTPTR SAL_PRIuUINT64
191  #define SAL_PRIxUINTPTR SAL_PRIxUINT64
192  #define SAL_PRIXUINTPTR SAL_PRIXUINT64
193 #else
194  #error "Please make sure SAL_TYPES_SIZEOFPOINTER is defined for your architecture/compiler"
195 #endif
196 
197 /* The following SAL_MIN_INTn defines codify the assumption that the signed
198  * sal_Int types use two's complement representation. Defining them as
199  * "-0x7F... - 1" instead of as "-0x80..." prevents warnings about applying the
200  * unary minus operator to unsigned quantities.
201  */
202 #define SAL_MIN_INT8 ((sal_Int8) (-0x7F - 1))
203 #define SAL_MAX_INT8 ((sal_Int8) 0x7F)
204 #define SAL_MAX_UINT8 ((sal_uInt8) 0xFF)
205 #define SAL_MIN_INT16 ((sal_Int16) (-0x7FFF - 1))
206 #define SAL_MAX_INT16 ((sal_Int16) 0x7FFF)
207 #define SAL_MAX_UINT16 ((sal_uInt16) 0xFFFF)
208 #define SAL_MIN_INT32 ((sal_Int32) (-0x7FFFFFFF - 1))
209 #define SAL_MAX_INT32 ((sal_Int32) 0x7FFFFFFF)
210 #define SAL_MAX_UINT32 ((sal_uInt32) 0xFFFFFFFF)
211 #define SAL_MIN_INT64 ((sal_Int64) (SAL_CONST_INT64(-0x7FFFFFFFFFFFFFFF) - 1))
212 #define SAL_MAX_INT64 ((sal_Int64) SAL_CONST_INT64(0x7FFFFFFFFFFFFFFF))
213 #define SAL_MAX_UINT64 ((sal_uInt64) SAL_CONST_UINT64(0xFFFFFFFFFFFFFFFF))
214 
215 #if SAL_TYPES_SIZEOFPOINTER == 4
216 #define SAL_MAX_SSIZE SAL_MAX_INT32
217 #define SAL_MAX_SIZE SAL_MAX_UINT32
218 #elif SAL_TYPES_SIZEOFPOINTER == 8
219 #define SAL_MAX_SSIZE SAL_MAX_INT64
220 #define SAL_MAX_SIZE SAL_MAX_UINT64
221 #endif
222 
223 #define SAL_MAX_ENUM 0x7fffffff
224 
225 #if defined(_MSC_VER)
226 # define SAL_DLLPUBLIC_EXPORT __declspec(dllexport)
227 # define SAL_JNI_EXPORT __declspec(dllexport)
228 # define SAL_DLLPUBLIC_IMPORT __declspec(dllimport)
229 # define SAL_DLLPRIVATE
230 # define SAL_DLLPUBLIC_TEMPLATE
231 # define SAL_DLLPUBLIC_RTTI
232 # define SAL_CALL __cdecl
233 #elif defined SAL_UNX
234 # if defined(__GNUC__)
235 # if defined(DISABLE_DYNLOADING)
236 # define SAL_DLLPUBLIC_EXPORT __attribute__ ((visibility("hidden")))
237 # define SAL_JNI_EXPORT __attribute__ ((visibility("default")))
238 # define SAL_DLLPUBLIC_IMPORT __attribute__ ((visibility("hidden")))
239 # define SAL_DLLPRIVATE __attribute__ ((visibility("hidden")))
240 # define SAL_DLLPUBLIC_TEMPLATE __attribute__ ((visibility("hidden")))
241 # define SAL_DLLPUBLIC_RTTI
242 # else
243 # define SAL_DLLPUBLIC_EXPORT __attribute__ ((visibility("default")))
244 # define SAL_JNI_EXPORT __attribute__ ((visibility("default")))
245 # define SAL_DLLPUBLIC_IMPORT __attribute__ ((visibility("default")))
246 # define SAL_DLLPRIVATE __attribute__ ((visibility("hidden")))
247 # define SAL_DLLPUBLIC_TEMPLATE __attribute__ ((visibility("default")))
248 # if defined __clang__
249 # if __has_attribute(type_visibility)
250 # define SAL_DLLPUBLIC_RTTI __attribute__ ((type_visibility("default")))
251 # else
252 # define SAL_DLLPUBLIC_RTTI __attribute__ ((visibility("default")))
253 # endif
254 # else
255 # define SAL_DLLPUBLIC_RTTI
256 # endif
257 # endif
258 # else
259 # define SAL_DLLPUBLIC_EXPORT
260 # define SAL_JNI_EXPORT
261 # define SAL_DLLPUBLIC_IMPORT
262 # define SAL_DLLPRIVATE
263 # define SAL_DLLPUBLIC_TEMPLATE
264 # define SAL_DLLPUBLIC_RTTI
265 # endif
266 # define SAL_CALL
267 #else
268 # error("unknown platform")
269 #endif
270 
277 #if defined(__GNUC__)
278 # if defined(DISABLE_DYNLOADING)
279 # define SAL_EXCEPTION_DLLPUBLIC_EXPORT __attribute__((visibility("default")))
280 # else
281 # define SAL_EXCEPTION_DLLPUBLIC_EXPORT SAL_DLLPUBLIC_EXPORT
282 # endif
283 # define SAL_EXCEPTION_DLLPRIVATE SAL_DLLPRIVATE
284 #else
285 # define SAL_EXCEPTION_DLLPUBLIC_EXPORT
286 # define SAL_EXCEPTION_DLLPRIVATE
287 #endif
288 
295 #if (defined __GNUC__ \
296  && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 1))) \
297  || defined __clang__
298 # define SAL_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
299 #else
300 # define SAL_WARN_UNUSED_RESULT
301 #endif
302 
307 #ifdef _MSC_VER
308 # define SAL_NO_VTABLE __declspec(novtable)
309 #else
310 # define SAL_NO_VTABLE
311 #endif
312 
313 #ifdef _WIN32
314 # pragma pack(push, 8)
315 #endif
316 
319 typedef struct _sal_Sequence
320 {
323  sal_Int32 nRefCount;
326  sal_Int32 nElements;
329  char elements[1];
330 } sal_Sequence;
331 
332 #define SAL_SEQUENCE_HEADER_SIZE ((sal_Size) offsetof(sal_Sequence,elements))
333 
334 #if defined( _WIN32)
335 #pragma pack(pop)
336 #endif
337 
338 #if defined __cplusplus
339 
344 #define SAL_THROW_EXTERN_C() throw ()
345 
350 #if defined(LIBO_INTERNAL_ONLY) && defined(__COVERITY__)
351 # define COVERITY_NOEXCEPT_FALSE noexcept(false)
352 #else
353 # define COVERITY_NOEXCEPT_FALSE
354 #endif
355 
356 #else
357 
358 #define SAL_THROW_EXTERN_C()
359 
360 #endif
361 
362 #ifdef __cplusplus
363 }
364 #endif /* __cplusplus */
365 
366 #ifdef __cplusplus
367 
369 {
373 };
374 
375 namespace com { namespace sun { namespace star { } } }
376 
381 namespace css = ::com::sun::star;
382 
391 #if defined LIBO_INTERNAL_ONLY
392 #define SAL_DELETED_FUNCTION = delete
393 #else
394 #define SAL_DELETED_FUNCTION
395 #endif
396 
404 #if defined LIBO_INTERNAL_ONLY
405 #define SAL_OVERRIDE override
406 #else
407 #define SAL_OVERRIDE
408 #endif
409 
416 #if defined LIBO_INTERNAL_ONLY
417 #define SAL_FINAL final
418 #else
419 #define SAL_FINAL
420 #endif
421 
422 #if defined LIBO_INTERNAL_ONLY
423 #if defined __clang__
424 #define SAL_FALLTHROUGH [[clang::fallthrough]]
425 #elif defined __GNUC__ && __GNUC__ >= 7
426 #define SAL_FALLTHROUGH [[fallthrough]]
427 #else
428 #define SAL_FALLTHROUGH
429 #endif
430 #endif
431 
432 #endif /* __cplusplus */
433 
434 #ifdef __cplusplus
435 
436 namespace sal {
437 
449 template< typename T1, typename T2 > inline T1 static_int_cast(T2 n) {
450  return static_cast< T1 >(n);
451 }
452 
453 }
454 
455 #else /* __cplusplus */
456 
469 #define SAL_INT_CAST(type, expr) ((type) (expr))
470 
471 #endif /* __cplusplus */
472 
478 #if HAVE_GCC_DEPRECATED_MESSAGE
479 # define SAL_DEPRECATED(message) __attribute__((deprecated(message)))
480 #elif defined __GNUC__ || defined __clang__
481 # define SAL_DEPRECATED(message) __attribute__((deprecated))
482 #elif defined(_MSC_VER)
483 # define SAL_DEPRECATED(message) __declspec(deprecated(message))
484 #else
485 # define SAL_DEPRECATED(message)
486 #endif
487 
499 #ifdef LIBO_INTERNAL_ONLY
500 # define SAL_DEPRECATED_INTERNAL(message)
501 #else
502 # define SAL_DEPRECATED_INTERNAL(message) SAL_DEPRECATED(message)
503 #endif
504 
512 #if HAVE_GCC_PRAGMA_OPERATOR
513 #define SAL_WNODEPRECATED_DECLARATIONS_PUSH \
514  _Pragma(SAL_STRINGIFY_ARG(GCC diagnostic push)) \
515  _Pragma(SAL_STRINGIFY_ARG(GCC diagnostic ignored "-Wdeprecated-declarations"))
516 #define SAL_WNODEPRECATED_DECLARATIONS_POP \
517  _Pragma(SAL_STRINGIFY_ARG(GCC diagnostic pop))
518 #else
519 # define SAL_WNODEPRECATED_DECLARATIONS_PUSH
520 # define SAL_WNODEPRECATED_DECLARATIONS_POP
521 #endif
522 
539 #ifdef _MSC_VER
540 #define SAL_WNOUNREACHABLE_CODE_PUSH \
541  __pragma(warning(push)) \
542  __pragma(warning(disable:4702)) \
543  __pragma(warning(disable:4722))
544 #define SAL_WNOUNREACHABLE_CODE_POP \
545  __pragma(warning(pop))
546 #else
547 /* Add definitions for GCC and Clang if needed */
548 #define SAL_WNOUNREACHABLE_CODE_PUSH
549 #define SAL_WNOUNREACHABLE_CODE_POP
550 #endif
551 
575 #if defined __cplusplus
576 #if defined __GNUC__ || defined __clang__
577 #define SAL_UNUSED_PARAMETER __attribute__ ((unused))
578 #else
579 #define SAL_UNUSED_PARAMETER
580 #endif
581 #endif
582 
595 #if HAVE_GCC_ATTRIBUTE_WARN_UNUSED
596 #define SAL_WARN_UNUSED __attribute__((warn_unused))
597 #else
598 #define SAL_WARN_UNUSED
599 #endif
600 
602 
603 #if defined __GNUC__ || defined __clang__
604 // Macro to try to catch and warn on assignments inside expr.
605 # define SAL_DETAIL_BOOLEAN_EXPR(expr) \
606  __extension__ ({ \
607  int sal_boolean_var_; \
608  if (expr) \
609  sal_boolean_var_ = 1; \
610  else \
611  sal_boolean_var_ = 0; \
612  sal_boolean_var_; \
613  })
614 
625 # define SAL_LIKELY(expr) __builtin_expect(SAL_DETAIL_BOOLEAN_EXPR((expr)), 1)
626 
637 # define SAL_UNLIKELY(expr) __builtin_expect(SAL_DETAIL_BOOLEAN_EXPR((expr)), 0)
638 
650 # define SAL_HOT __attribute__((hot))
651 
665 # define SAL_COLD __attribute__((cold))
666 #else
667 # define SAL_LIKELY(expr) (expr)
668 # define SAL_UNLIKELY(expr) (expr)
669 # define SAL_HOT
670 # define SAL_COLD
671 #endif
672 
674 
676 
685 #ifndef __has_attribute
686 #define __has_attribute(x) 0
687 #endif
688 
689 #if defined LIBO_INTERNAL_ONLY && ((defined __GNUC__ && __GNUC__ > 4) || (defined __clang__ && __has_attribute(returns_nonnull)))
690 #define SAL_RETURNS_NONNULL __attribute__((returns_nonnull))
691 #else
692 #define SAL_RETURNS_NONNULL
693 #endif
694 
696 #endif // INCLUDED_SAL_TYPES_H
697 
698 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
void * sal_Handle
Definition: types.h:144
signed char sal_Int8
Definition: types.h:43
struct _sal_Sequence sal_Sequence
This is the binary specification of a SAL sequence.
signed char sal_sChar
A legacy synonym for signed char.
Definition: types.h:126
sal_uInt16 sal_Unicode
Definition: types.h:141
unsigned char sal_Bool
Definition: types.h:38
unsigned char sal_uChar
A legacy synonym for unsigned char.
Definition: types.h:132
__sal_NoAcquire
Definition: types.h:368
Definition: types.h:375
char elements[1]
elements array
Definition: types.h:329
Definition: types.h:436
definition of a no acquire enum for ctors
Definition: types.h:372
T1 static_int_cast(T2 n)
A static_cast between integral types, to avoid C++ compiler warnings.
Definition: types.h:449
char sal_Char
A legacy synonym for char.
Definition: types.h:120
Definition: types.h:375
sal_Int32 nRefCount
reference count of sequence
Definition: types.h:323
sal_Int32 nElements
element count
Definition: types.h:326
This is the binary specification of a SAL sequence.
Definition: types.h:319
unsigned char sal_uInt8
Definition: types.h:44