1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef _SAL_TYPES_H_
#define _SAL_TYPES_H_
#include <sal/config.h>
#include <sal/macros.h>
/* Grab __SIZEOFxxx constants from typesconfig tool on Unix */
#if defined UNX
#include <sal/typesizes.h>
#elif defined(WNT)
/* FIXME: autogeneration of type sizes on Win32/Win64? */
#define SAL_TYPES_ALIGNMENT2 1
#define SAL_TYPES_ALIGNMENT4 1
#define SAL_TYPES_ALIGNMENT8 1
#define SAL_TYPES_SIZEOFSHORT 2
#define SAL_TYPES_SIZEOFINT 4
#define SAL_TYPES_SIZEOFLONG 4
#define SAL_TYPES_SIZEOFLONGLONG 8
#ifdef _WIN64
#define SAL_TYPES_SIZEOFPOINTER 8
#else
#define SAL_TYPES_SIZEOFPOINTER 4
#endif
#endif
#ifdef __cplusplus
extern "C" {
#endif
/********************************************************************************/
/* Data types
*/
/* Boolean */
typedef unsigned char sal_Bool;
# define sal_False ((sal_Bool)0)
# define sal_True ((sal_Bool)1)
/* char is assumed to always be 1 byte long */
typedef signed char sal_Int8;
typedef unsigned char sal_uInt8;
#if SAL_TYPES_SIZEOFSHORT == 2
typedef signed short sal_Int16;
typedef unsigned short sal_uInt16;
#else
#error "Could not find 16-bit type, add support for your architecture"
#endif
#if SAL_TYPES_SIZEOFLONG == 4
typedef signed long sal_Int32;
typedef unsigned long sal_uInt32;
#define SAL_PRIdINT32 "ld"
#define SAL_PRIuUINT32 "lu"
#define SAL_PRIxUINT32 "lx"
#define SAL_PRIXUINT32 "lX"
#elif SAL_TYPES_SIZEOFINT == 4
typedef signed int sal_Int32;
typedef unsigned int sal_uInt32;
#define SAL_PRIdINT32 "d"
#define SAL_PRIuUINT32 "u"
#define SAL_PRIxUINT32 "x"
#define SAL_PRIXUINT32 "X"
#else
#error "Could not find 32-bit type, add support for your architecture"
#endif
#if defined _MSC_VER && _MSC_VER >= 1000
typedef __int64 sal_Int64;
typedef unsigned __int64 sal_uInt64;
/* The following are macros that will add the 64 bit constant suffix. */
#define SAL_CONST_INT64(x) x##i64
#define SAL_CONST_UINT64(x) x##ui64
#define SAL_PRIdINT64 "I64d"
#define SAL_PRIuUINT64 "I64u"
#define SAL_PRIxUINT64 "I64x"
#define SAL_PRIXUINT64 "I64X"
#elif defined(__SUNPRO_CC) || defined(__SUNPRO_C) || defined (__GNUC__) || defined (sgi)
#if SAL_TYPES_SIZEOFLONG == 8
typedef signed long int sal_Int64;
typedef unsigned long int sal_uInt64;
/* The following are macros that will add the 64 bit constant suffix. */
#define SAL_CONST_INT64(x) x##l
#define SAL_CONST_UINT64(x) x##ul
#define SAL_PRIdINT64 "ld"
#define SAL_PRIuUINT64 "lu"
#define SAL_PRIxUINT64 "lx"
#define SAL_PRIXUINT64 "lX"
#elif SAL_TYPES_SIZEOFLONGLONG == 8
typedef signed long long sal_Int64;
typedef unsigned long long sal_uInt64;
/* The following are macros that will add the 64 bit constant suffix. */
#define SAL_CONST_INT64(x) x##ll
#define SAL_CONST_UINT64(x) x##ull
#ifdef __MINGW32__
#define SAL_PRIdINT64 "I64d"
#define SAL_PRIuUINT64 "I64u"
#define SAL_PRIxUINT64 "I64x"
#define SAL_PRIXUINT64 "I64X"
#else
#define SAL_PRIdINT64 "lld"
#define SAL_PRIuUINT64 "llu"
#define SAL_PRIxUINT64 "llx"
#define SAL_PRIXUINT64 "llX"
#endif
#else
#error "Could not find 64-bit type, add support for your architecture"
#endif
#else
#error "Please define the 64-bit types for your architecture/compiler in sal/inc/sal/types.h"
#endif
typedef char sal_Char;
typedef signed char sal_sChar;
typedef unsigned char sal_uChar;
#if ( defined(SAL_W32) && !defined(__MINGW32__) )
// http://msdn.microsoft.com/en-us/library/s3f49ktz%28v=vs.80%29.aspx
// "By default wchar_t is a typedef for unsigned short."
// But MinGW has a native wchar_t, and on many places, we cannot deal with
// that, so sal_Unicode has to be explicitly typedef'd as sal_uInt16 there.
typedef wchar_t sal_Unicode;
#else
#define SAL_UNICODE_NOTEQUAL_WCHAR_T
typedef sal_uInt16 sal_Unicode;
#endif
typedef void * sal_Handle;
/* sal_Size should currently be the native width of the platform */
#if SAL_TYPES_SIZEOFPOINTER == 4
typedef sal_uInt32 sal_Size;
typedef sal_Int32 sal_sSize;
#elif SAL_TYPES_SIZEOFPOINTER == 8
typedef sal_uInt64 sal_Size;
typedef sal_Int64 sal_sSize;
#else
#error "Please make sure SAL_TYPES_SIZEOFPOINTER is defined for your architecture/compiler"
#endif
/* sal_PtrDiff holds the result of a pointer subtraction */
#if SAL_TYPES_SIZEOFPOINTER == 4
typedef sal_Int32 sal_PtrDiff;
#elif SAL_TYPES_SIZEOFPOINTER == 8
typedef sal_Int64 sal_PtrDiff;
#else
#error "Please make sure SAL_TYPES_SIZEOFPOINTER is defined for your architecture/compiler"
#endif
/* printf-style conversion specification length modifiers for size_t and
ptrdiff_t (most platforms support C99, MSC has its own extension) */
#if defined(_MSC_VER) || defined(__MINGW32__)
#define SAL_PRI_SIZET "I"
#define SAL_PRI_PTRDIFFT "I"
#else
#define SAL_PRI_SIZET "z"
#define SAL_PRI_PTRDIFFT "t"
#endif
/* sal_IntPtr, sal_uIntPtr are integer types designed to hold pointers so that any valid
* pointer to void can be converted to this type and back to a pointer to void and the
* result will compare to the original pointer */
#if SAL_TYPES_SIZEOFPOINTER == 4
typedef sal_Int32 sal_IntPtr;
typedef sal_uInt32 sal_uIntPtr;
#define SAL_PRIdINTPTR SAL_PRIdINT32
#define SAL_PRIuUINTPTR SAL_PRIuUINT32
#define SAL_PRIxUINTPTR SAL_PRIxUINT32
#define SAL_PRIXUINTPTR SAL_PRIXUINT32
#elif SAL_TYPES_SIZEOFPOINTER == 8
typedef sal_Int64 sal_IntPtr;
typedef sal_uInt64 sal_uIntPtr;
#define SAL_PRIdINTPTR SAL_PRIdINT64
#define SAL_PRIuUINTPTR SAL_PRIuUINT64
#define SAL_PRIxUINTPTR SAL_PRIxUINT64
#define SAL_PRIXUINTPTR SAL_PRIXUINT64
#else
#error "Please make sure SAL_TYPES_SIZEOFPOINTER is defined for your architecture/compiler"
#endif
/********************************************************************************/
/* Useful defines
*/
/* The following SAL_MIN_INTn defines codify the assumption that the signed
* sal_Int types use two's complement representation. Defining them as
* "-0x7F... - 1" instead of as "-0x80..." prevents warnings about applying the
* unary minus operator to unsigned quantities.
*/
#define SAL_MIN_INT8 ((sal_Int8) (-0x7F - 1))
#define SAL_MAX_INT8 ((sal_Int8) 0x7F)
#define SAL_MAX_UINT8 ((sal_uInt8) 0xFF)
#define SAL_MIN_INT16 ((sal_Int16) (-0x7FFF - 1))
#define SAL_MAX_INT16 ((sal_Int16) 0x7FFF)
#define SAL_MAX_UINT16 ((sal_uInt16) 0xFFFF)
#define SAL_MIN_INT32 ((sal_Int32) (-0x7FFFFFFF - 1))
#define SAL_MAX_INT32 ((sal_Int32) 0x7FFFFFFF)
#define SAL_MAX_UINT32 ((sal_uInt32) 0xFFFFFFFF)
#define SAL_MIN_INT64 ((sal_Int64) (SAL_CONST_INT64(-0x7FFFFFFFFFFFFFFF) - 1))
#define SAL_MAX_INT64 ((sal_Int64) SAL_CONST_INT64(0x7FFFFFFFFFFFFFFF))
#define SAL_MAX_UINT64 ((sal_uInt64) SAL_CONST_UINT64(0xFFFFFFFFFFFFFFFF))
#if SAL_TYPES_SIZEOFLONG == 4
#define SAL_MAX_SSIZE SAL_MAX_INT32
#define SAL_MAX_SIZE SAL_MAX_UINT32
#elif SAL_TYPES_SIZEOFLONG == 8
#define SAL_MAX_SSIZE SAL_MAX_INT64
#define SAL_MAX_SIZE SAL_MAX_UINT64
#endif
#if defined(SAL_W32) || defined(SAL_UNX)
# define SAL_MAX_ENUM 0x7fffffff
#endif
#if defined(_MSC_VER) || defined(__MINGW32__)
# define SAL_DLLPUBLIC_EXPORT __declspec(dllexport)
#if defined(_MSC_VER)
# define SAL_DLLPUBLIC_IMPORT __declspec(dllimport)
#else
# define SAL_DLLPUBLIC_IMPORT
#endif // defined(_MSC_VER)
# define SAL_DLLPRIVATE
# define SAL_DLLPUBLIC_TEMPLATE
# define SAL_CALL __cdecl
# define SAL_CALL_ELLIPSE __cdecl
#elif defined SAL_UNX
# if defined(__SUNPRO_CC) && (__SUNPRO_CC >= 0x550)
# define SAL_DLLPUBLIC_EXPORT __global
# define SAL_DLLPUBLIC_IMPORT
# define SAL_DLLPRIVATE __hidden
# define SAL_DLLPUBLIC_TEMPLATE
# elif defined(__SUNPRO_C ) && (__SUNPRO_C >= 0x550)
# define SAL_DLLPUBLIC_EXPORT __global
# define SAL_DLLPUBLIC_IMPORT
# define SAL_DLLPRIVATE __hidden
# define SAL_DLLPUBLIC_TEMPLATE
# elif defined(__GNUC__) && defined(HAVE_GCC_VISIBILITY_FEATURE)
# define SAL_DLLPUBLIC_EXPORT __attribute__ ((visibility("default")))
# define SAL_DLLPUBLIC_IMPORT __attribute__ ((visibility("default")))
# define SAL_DLLPRIVATE __attribute__ ((visibility("hidden")))
# define SAL_DLLPUBLIC_TEMPLATE __attribute__ ((visibility("default")))
# else
# define SAL_DLLPUBLIC_EXPORT
# define SAL_DLLPUBLIC_IMPORT
# define SAL_DLLPRIVATE
# define SAL_DLLPUBLIC_TEMPLATE
# endif
# define SAL_CALL
# define SAL_CALL_ELLIPSE
#else
# error("unknown platform")
#endif
/**
Exporting the symbols necessary for exception handling on GCC.
These macros are used for inline declarations of exception classes, as in
rtl/malformeduriexception.hxx.
*/
#if defined(__GNUC__) && ! defined(__MINGW32__)
#define SAL_EXCEPTION_DLLPUBLIC_EXPORT SAL_DLLPUBLIC_EXPORT
#define SAL_EXCEPTION_DLLPRIVATE SAL_DLLPRIVATE
#else
#define SAL_EXCEPTION_DLLPUBLIC_EXPORT
#define SAL_EXCEPTION_DLLPRIVATE
#endif
#include <sal/saldllapi.h>
/** Use this as markup for functions and methods whose return value must be
checked.
Compilers that support a construct of this nature will emit a compile
time warning on unchecked return value.
*/
#if defined(__GNUC__)
# define SAL_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
#else
# define SAL_WARN_UNUSED_RESULT
#endif
/** Use this for pure virtual classes, e.g. class SAL_NO_VTABLE Foo { ...
This hinders the compiler from setting a generic vtable stating that
a pure virtual function was called and thus slightly reduces code size.
*/
#ifdef _MSC_VER
# define SAL_NO_VTABLE __declspec(novtable)
#else
# define SAL_NO_VTABLE
#endif
#ifdef SAL_W32
# pragma pack(push, 8)
#endif
/** This is the binary specification of a SAL sequence.
<br>
*/
typedef struct _sal_Sequence
{
/** reference count of sequence<br>
*/
sal_Int32 nRefCount;
/** element count<br>
*/
sal_Int32 nElements;
/** elements array<br>
*/
char elements[1];
} sal_Sequence;
#define SAL_SEQUENCE_HEADER_SIZE ((sal_Size)&((sal_Sequence *)0)->elements)
#if defined( SAL_W32)
#pragma pack(pop)
#endif
/** Definition of function throw clause macros. These have been introduced
to reduce code size by balancing out compiler bugs.
These macros are ONLY for function declarations,
use common C++ throw statement for throwing exceptions, e.g.
throw RuntimeException();
SAL_THROW() should be used for all C++ functions, e.g. SAL_THROW(())
SAL_THROW_EXTERN_C() should be used for all C functions
*/
#ifdef __cplusplus
#if defined(__GNUC__) || defined(__SUNPRO_CC) || defined(__sgi)
#define SAL_THROW( exc )
#else /* MSVC, all other */
#define SAL_THROW( exc ) throw exc
#endif /* __GNUC__, __SUNPRO_CC */
#define SAL_THROW_EXTERN_C() throw ()
#else /* ! __cplusplus */
/* SAL_THROW() must not be used in C headers, only SAL_THROW_EXTERN_C() is defined */
#define SAL_THROW_EXTERN_C()
#endif
#ifdef __cplusplus
enum __sal_NoAcquire
{
/** definition of a no acquire enum for ctors
*/
SAL_NO_ACQUIRE
};
#endif /* __cplusplus */
#ifdef __cplusplus
}
#endif /* __cplusplus */
#ifdef __cplusplus
namespace sal {
/**
A static_cast between integral types, to avoid C++ compiler warnings.
In C++ source code, use sal::static_int_cast<T>(n) instead of
static_cast<T>(n) whenever a compiler warning about integral type problems
shall be silenced. That way, source code that needs to be modified when the
type of any of the expressions involved in the compiler warning is changed
can be found more easily.
Both template arguments T1 and T2 must be integral types.
*/
template< typename T1, typename T2 > inline T1 static_int_cast(T2 n) {
return static_cast< T1 >(n);
}
}
#else /* __cplusplus */
/**
A cast between integer types, to avoid C compiler warnings.
In C source code, use SAL_INT_CAST(type, expr) instead of ((type) (expr))
whenever a compiler warning about integer type problems shall be silenced.
That way, source code that needs to be modified when the type of any of the
expressions involved in the compiler warning is changed can be found more
easily.
The argument 'type' must be an integer type and the argument 'expr' must be
an integer expression. Both arguments are evaluated exactly once.
*/
#define SAL_INT_CAST(type, expr) ((type) (expr))
#endif /* __cplusplus */
/**
Use as follows:
SAL_DEPRECATED("Dont use, its evil.") void doit(int nPara);
*/
#if (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5))
# define SAL_DEPRECATED(message) __attribute__((deprecated(message)))
#elif (__GNUC__)
# define SAL_DEPRECATED(message) __attribute__((deprecated))
#elif defined(_MSC_VER)
# define SAL_DEPRECATED(message) __declspec(deprecated(message))
#else
# define SAL_DEPRECATED(message)
#endif
/**
Use as follows:
SAL_WNODEPRECATED_DECLARATIONS_PUSH
\::std::auto_ptr<X> ...
SAL_WNODEPRECATED_DECLARATIONS_POP
*/
#if (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6))
#define SAL_WNODEPRECATED_DECLARATIONS_PUSH \
_Pragma(SAL_STRINGIFY_ARG(GCC diagnostic push)) \
_Pragma(SAL_STRINGIFY_ARG(GCC diagnostic ignored "-Wdeprecated-declarations"))
#define SAL_WNODEPRECATED_DECLARATIONS_POP \
_Pragma(SAL_STRINGIFY_ARG(GCC diagnostic pop))
#else
# define SAL_WNODEPRECATED_DECLARATIONS_PUSH
# define SAL_WNODEPRECATED_DECLARATIONS_POP
#endif
/** Annotate unused but required C++ function parameters.
An unused parameter is required if the function needs to adhere to a given
type (e.g., if its address is assigned to a function pointer of a specific
type, or if it is called from template code). This annotation helps static
analysis tools suppress false warnings. In the case of virtual functions
(where unused required parameters are common, too), the annotation is not
required (as static analysis tools can themselves derive the information
whether a function is virtual).
Use the annotation in function definitions like
void f(SAL_UNUSED_PARAMETER int) {}
C does not allow unnamed parameters, anyway, so a function definition like
the above needs to be written there as
void f(int dummy) { (void) dummy; / * avoid warnings * / }
without a SAL_UNUSED_PARAMETER annotation.
@since LibreOffice 3.6
*/
#if defined __cplusplus
#if defined __GNUC__
#define SAL_UNUSED_PARAMETER __attribute__ ((unused))
#else
#define SAL_UNUSED_PARAMETER
#endif
#endif
#endif /*_SAL_TYPES_H_ */
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|