1.9.8
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,9 +1,9 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ -/home/rene/Debian/Pakete/LibreOffice/libreoffice/libreoffice-26.8.0.3/odk/docs/
│ │ │ │ -cpp/main.dox File Reference
│ │ │ │ +/build/reproducible-path/libreoffice-26.8.0.3/odk/docs/cpp/main.dox File
│ │ │ │ +Reference
│ │ │ │ ===============================================================================
│ │ │ │ Generated by _[_d_o_x_y_g_e_n_] 1.9.8
│ │ ├── ./usr/share/doc/libreoffice/sdk/docs/cpp/ref/a00005.html
│ │ │ @@ -1,15 +1,15 @@
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │ - 1.9.8
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,9 +1,9 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ -/home/rene/Debian/Pakete/LibreOffice/libreoffice/libreoffice-26.8.0.3/include/
│ │ │ │ -sal/log-areas.dox File Reference
│ │ │ │ +/build/reproducible-path/libreoffice-26.8.0.3/include/sal/log-areas.dox File
│ │ │ │ +Reference
│ │ │ │ ===============================================================================
│ │ │ │ Generated by _[_d_o_x_y_g_e_n_] 1.9.8
│ │ ├── ./usr/share/doc/libreoffice/sdk/docs/cpp/ref/a00008.html
│ │ │ @@ -1,15 +1,15 @@
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │ -
Go to the source code of this file.
│ │ │ +│ │ │ +Macros | |
| #define | SAL_DLLPUBLIC SAL_DLLPUBLIC_IMPORT |
| #define SAL_DLLPUBLIC SAL_DLLPUBLIC_IMPORT | │ │ │ +
1.9.8
│ │ │
│ │ │
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,10 +1,21 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ * _s_a_l
│ │ │ │ -alloca.h File Reference
│ │ │ │ +_M_a_c_r_o_s
│ │ │ │ +saldllapi.h File Reference
│ │ │ │ +#include "_s_a_l_/_c_o_n_f_i_g_._h"
│ │ │ │ +#include "_s_a_l_/_t_y_p_e_s_._h"
│ │ │ │ +Include dependency graph for saldllapi.h:
│ │ │ │ +This graph shows which files directly or indirectly include this file:
│ │ │ │ _G_o_ _t_o_ _t_h_e_ _s_o_u_r_c_e_ _c_o_d_e_ _o_f_ _t_h_i_s_ _f_i_l_e_.
│ │ │ │ +MMaaccrrooss
│ │ │ │ +#define _S_A_L___D_L_L_P_U_B_L_I_C SAL_DLLPUBLIC_IMPORT
│ │ │ │ +
│ │ │ │ +********** MMaaccrroo DDeeffiinniittiioonn DDooccuummeennttaattiioonn **********
│ │ │ │ +********** _?◆_? SSAALL__DDLLLLPPUUBBLLIICC **********
│ │ │ │ +#define SAL_DLLPUBLIC SAL_DLLPUBLIC_IMPORT
│ │ │ │ ===============================================================================
│ │ │ │ Generated by _[_d_o_x_y_g_e_n_] 1.9.8
│ │ ├── ./usr/share/doc/libreoffice/sdk/docs/cpp/ref/a00008_source.html
│ │ │ @@ -1,15 +1,15 @@
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │ - 1.9.8
│ │ │
│ │ │
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,14 +1,14 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ * _s_a_l
│ │ │ │ -alloca.h
│ │ │ │ +saldllapi.h
│ │ │ │ _G_o_ _t_o_ _t_h_e_ _d_o_c_u_m_e_n_t_a_t_i_o_n_ _o_f_ _t_h_i_s_ _f_i_l_e_.
│ │ │ │ 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
│ │ │ │ @@ -26,46 +26,27 @@
│ │ │ │ 17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
│ │ │ │ 18 */
│ │ │ │ 19
│ │ │ │ 20/*
│ │ │ │ 21 * This file is part of LibreOffice published API.
│ │ │ │ 22 */
│ │ │ │ 23
│ │ │ │ -24#ifndef INCLUDED_SAL_ALLOCA_H
│ │ │ │ -25#define INCLUDED_SAL_ALLOCA_H
│ │ │ │ +24#ifndef INCLUDED_SAL_SALDLLAPI_H
│ │ │ │ +25#define INCLUDED_SAL_SALDLLAPI_H
│ │ │ │ 26
│ │ │ │ -27#if defined(__sun) || defined(LINUX) || defined(ANDROID) || defined(HAIKU) ||
│ │ │ │ -defined(MACOSX) \
│ │ │ │ -28 || defined(IOS) || defined(__EMSCRIPTEN__)
│ │ │ │ -29
│ │ │ │ -30#ifndef INCLUDED_ALLOCA_H
│ │ │ │ -31#include <_a_l_l_o_c_a_._h>
│ │ │ │ -32#define INCLUDED_ALLOCA_H
│ │ │ │ -33#endif
│ │ │ │ -34
│ │ │ │ -35#elif defined(FREEBSD) || defined(NETBSD) || defined(OPENBSD) || defined
│ │ │ │ -(DRAGONFLY)
│ │ │ │ +27#include "_s_a_l_/_c_o_n_f_i_g_._h"
│ │ │ │ +28
│ │ │ │ +29#include "_s_a_l_/_t_y_p_e_s_._h"
│ │ │ │ +30
│ │ │ │ +31#if defined(SAL_DLLIMPLEMENTATION)
│ │ │ │ +32#define SAL_DLLPUBLIC SAL_DLLPUBLIC_EXPORT
│ │ │ │ +33#else
│ │ │ │ +_3_4#define SAL_DLLPUBLIC SAL_DLLPUBLIC_IMPORT
│ │ │ │ +35#endif
│ │ │ │ 36
│ │ │ │ -37#ifndef INCLUDED_STDLIB_H
│ │ │ │ -38#include #include "sal/config.h"#include <stddef.h>#include "sal/macros.h"#include "sal/typesizes.h"
Go to the source code of this file.
│ │ │ -│ │ │ -Classes | |
| struct | _sal_Sequence |
| This is the binary specification of a SAL sequence. More... | |
│ │ │ -Namespaces | |
| namespace | com |
| namespace | com::sun |
| namespace | com::sun::star |
| namespace | sal |
│ │ │ -Macros | |
| #define | sal_False ((sal_Bool)0) |
| #define | sal_True ((sal_Bool)1) |
| #define | SAL_UNICODE_NOTEQUAL_WCHAR_T |
| #define | SAL_PRI_SIZET "z" |
| #define | SAL_PRI_PTRDIFFT "t" |
| #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)) |
| #define | SAL_MAX_ENUM 0x7fffffff |
| #define | SAL_EXCEPTION_DLLPUBLIC_EXPORT |
| Exporting the symbols necessary for exception handling on GCC. | |
| #define | SAL_EXCEPTION_DLLPRIVATE |
| #define | SAL_WARN_UNUSED_RESULT |
| Use this as markup for functions and methods whose return value must be used. | |
| #define | SAL_NO_VTABLE |
| Use this for pure virtual classes, e.g. | |
| #define | SAL_SEQUENCE_HEADER_SIZE ((sal_Size) offsetof(sal_Sequence,elements)) |
| #define | SAL_THROW_EXTERN_C() throw () |
| Nothrow specification for C functions. | |
| #define | COVERITY_NOEXCEPT_FALSE |
| To markup destructors that coverity warns might throw exceptions which won't throw in practice, or where std::terminate is an acceptable response if they do. | |
| #define | SAL_DELETED_FUNCTION |
| short-circuit extra-verbose API namespaces | |
| #define | SAL_OVERRIDE |
| C++11 "override" feature. | |
| #define | SAL_CONSTEXPR |
| C++11 "constexpr" feature. | |
| #define | SAL_NOEXCEPT throw () |
| Macro for C++11 "noexcept" vs. | |
| #define | SAL_DEPRECATED(message) |
| Use as follows: SAL_DEPRECATED("Don't use, it's evil.") void doit(int nPara);. | |
| #define | SAL_DEPRECATED_INTERNAL(message) SAL_DEPRECATED(message) |
| This macro is used in cppumaker-generated include files, to tag entities that are marked as. | |
| #define | SAL_WNODEPRECATED_DECLARATIONS_PUSH |
| Use as follows: SAL_WNODEPRECATED_DECLARATIONS_PUSH ::std::auto_ptr<X> ... SAL_WNODEPRECATED_DECLARATIONS_POP. | |
| #define | SAL_WNODEPRECATED_DECLARATIONS_POP |
| #define | SAL_WNOUNREACHABLE_CODE_PUSH |
| Use as follows: | |
| #define | SAL_WNOUNREACHABLE_CODE_POP |
| #define | SAL_UNUSED_PARAMETER |
| Annotate unused but required C++ function parameters. | |
| #define | SAL_WARN_UNUSED |
| Annotate classes where a compiler should warn if an instance is unused. | |
│ │ │ -Typedefs | |
| typedef unsigned char | sal_Bool |
| typedef signed char | sal_Int8 |
| typedef unsigned char | sal_uInt8 |
| typedef sal_uInt16 | sal_Unicode |
| typedef void * | sal_Handle |
| typedef struct _sal_Sequence | sal_Sequence |
| This is the binary specification of a SAL sequence. | |
│ │ │ -Enumerations | |
| enum | __sal_NoAcquire { SAL_NO_ACQUIRE │ │ │ - } |
│ │ │ -Functions | |
| template<typename T1 , typename T2 > | |
| T1 | sal::static_int_cast (T2 n) |
| A static_cast between integral types, to avoid C++ compiler warnings. | |
| #define COVERITY_NOEXCEPT_FALSE | │ │ │ -
To markup destructors that coverity warns might throw exceptions which won't throw in practice, or where std::terminate is an acceptable response if they do.
│ │ │ - │ │ │ -| #define SAL_CONSTEXPR | │ │ │ -
C++11 "constexpr" feature.
│ │ │ -For LIBO_INTERNAL_ONLY, declare that it's possible to evaluate the value at compile time.
│ │ │ -| #define SAL_DELETED_FUNCTION | │ │ │ -
short-circuit extra-verbose API namespaces
│ │ │ -For LIBO_INTERNAL_ONLY, calling a deleted function will cause a compile-time error, while otherwise it will only cause a link-time error as the declared function is not defined.
│ │ │ -| #define SAL_DEPRECATED | │ │ │ -( | │ │ │ -│ │ │ - | message | ) | │ │ │ -│ │ │ - |
Use as follows: SAL_DEPRECATED("Don't use, it's evil.") void doit(int nPara);.
│ │ │ - │ │ │ -| #define SAL_DEPRECATED_INTERNAL | │ │ │ -( | │ │ │ -│ │ │ - | message | ) | │ │ │ -SAL_DEPRECATED(message) | │ │ │ -
This macro is used in cppumaker-generated include files, to tag entities that are marked as.
│ │ │ -It causes deprecation warnings to be generated in external code, but for now is silenced in internal code. It would need some substantial clean-up of internal code to fix all warnings/errors generated by it. (Once that is done, it can become a synonym for SAL_DEPRECATED under LIBO_INTERNAL_ONLY, too. Completely removing the macro then would be incompatible, in case there are include files still around generated with a cppumaker that emitted it.)
│ │ │ - │ │ │ -| #define SAL_EXCEPTION_DLLPRIVATE | │ │ │ -
| #define SAL_EXCEPTION_DLLPUBLIC_EXPORT | │ │ │ -
Exporting the symbols necessary for exception handling on GCC.
│ │ │ -These macros are used for inline declarations of exception classes, as in rtl/malformeduriexception.hxx.
│ │ │ - │ │ │ -| #define sal_False ((sal_Bool)0) | │ │ │ -
| #define SAL_MAX_ENUM 0x7fffffff | │ │ │ -
| #define SAL_MAX_INT16 ((sal_Int16) 0x7FFF) | │ │ │ -
| #define SAL_MAX_INT32 ((sal_Int32) 0x7FFFFFFF) | │ │ │ -
| #define SAL_MAX_INT64 ((sal_Int64) SAL_CONST_INT64(0x7FFFFFFFFFFFFFFF)) | │ │ │ -
| #define SAL_MAX_INT8 ((sal_Int8) 0x7F) | │ │ │ -
| #define SAL_MAX_UINT16 ((sal_uInt16) 0xFFFF) | │ │ │ -
| #define SAL_MAX_UINT32 ((sal_uInt32) 0xFFFFFFFF) | │ │ │ -
| #define SAL_MAX_UINT64 ((sal_uInt64) SAL_CONST_UINT64(0xFFFFFFFFFFFFFFFF)) | │ │ │ -
| #define SAL_MAX_UINT8 ((sal_uInt8) 0xFF) | │ │ │ -
| #define SAL_MIN_INT16 ((sal_Int16) (-0x7FFF - 1)) | │ │ │ -
| #define SAL_MIN_INT32 ((sal_Int32) (-0x7FFFFFFF - 1)) | │ │ │ -
| #define SAL_MIN_INT64 ((sal_Int64) (SAL_CONST_INT64(-0x7FFFFFFFFFFFFFFF) - 1)) | │ │ │ -
| #define SAL_MIN_INT8 ((sal_Int8) (-0x7F - 1)) | │ │ │ -
| #define SAL_NO_VTABLE | │ │ │ -
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.
│ │ │ - │ │ │ -| #define SAL_NOEXCEPT throw () | │ │ │ -
Macro for C++11 "noexcept" vs.
│ │ │ -"throw ()" exception specification.
│ │ │ -The latter has been removed completely from C++20.
│ │ │ -| #define SAL_OVERRIDE | │ │ │ -
C++11 "override" feature.
│ │ │ -For LIBO_INTERNAL_ONLY, force the method to override an existing method in parent, error out if the method with the correct signature does not exist.
│ │ │ -| #define SAL_PRI_PTRDIFFT "t" | │ │ │ -
| #define SAL_PRI_SIZET "z" | │ │ │ -
| #define SAL_SEQUENCE_HEADER_SIZE ((sal_Size) offsetof(sal_Sequence,elements)) | │ │ │ -
| #define SAL_THROW_EXTERN_C | │ │ │ -( | │ │ │ -) | │ │ │ -throw () | │ │ │ -
Nothrow specification for C functions.
│ │ │ -This is a macro so it can expand to nothing in C code.
│ │ │ - │ │ │ -| #define sal_True ((sal_Bool)1) | │ │ │ -
| #define SAL_UNICODE_NOTEQUAL_WCHAR_T | │ │ │ -
| #define SAL_UNUSED_PARAMETER | │ │ │ -
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.
│ │ │ -| #define SAL_WARN_UNUSED | │ │ │ -
Annotate classes where a compiler should warn if an instance is unused.
│ │ │ -The compiler cannot warn about unused instances if they have non-trivial or external constructors or destructors. Classes marked with SAL_WARN_UNUSED will be warned about.
│ │ │ -| #define SAL_WARN_UNUSED_RESULT | │ │ │ -
Use this as markup for functions and methods whose return value must be used.
│ │ │ -Compilers that support a construct of this nature will emit a compile time warning on unused return value.
│ │ │ - │ │ │ -| #define SAL_WNODEPRECATED_DECLARATIONS_POP | │ │ │ -
| #define SAL_WNODEPRECATED_DECLARATIONS_PUSH | │ │ │ -
Use as follows: SAL_WNODEPRECATED_DECLARATIONS_PUSH ::std::auto_ptr<X> ... SAL_WNODEPRECATED_DECLARATIONS_POP.
│ │ │ - │ │ │ -| #define SAL_WNOUNREACHABLE_CODE_POP | │ │ │ -
| #define SAL_WNOUNREACHABLE_CODE_PUSH | │ │ │ -
Use as follows:
│ │ │ -SAL_WNOUNREACHABLE_CODE_PUSH
│ │ │ -function definition
│ │ │ -SAL_WNOUNREACHABLE_CODE_POP
│ │ │ -Useful in cases where the compiler is "too clever" like when doing link-time code generation, and noticing that a called function always throws, and fixing the problem cleanly so that it produces no warnings in normal non-LTO compilations either is not easy.
│ │ │ - │ │ │ -| typedef unsigned char sal_Bool | │ │ │ -
| typedef void* sal_Handle | │ │ │ -
| typedef signed char sal_Int8 | │ │ │ -
| typedef struct _sal_Sequence sal_Sequence | │ │ │ -
This is the binary specification of a SAL sequence.
│ │ │ - │ │ │ -| typedef unsigned char sal_uInt8 | │ │ │ -
| typedef sal_uInt16 sal_Unicode | │ │ │ -
| enum __sal_NoAcquire | │ │ │ -
1.9.8
│ │ │
│ │ │
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,327 +1,10 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ * _s_a_l
│ │ │ │ -_C_l_a_s_s_e_s | _N_a_m_e_s_p_a_c_e_s | _M_a_c_r_o_s | _T_y_p_e_d_e_f_s | _E_n_u_m_e_r_a_t_i_o_n_s | _F_u_n_c_t_i_o_n_s
│ │ │ │ -types.h File Reference
│ │ │ │ -#include "_s_a_l_/_c_o_n_f_i_g_._h"
│ │ │ │ -#include 1.9.8
│ │ │
│ │ │
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,14 +1,14 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ * _s_a_l
│ │ │ │ -types.h
│ │ │ │ +alloca.h
│ │ │ │ _G_o_ _t_o_ _t_h_e_ _d_o_c_u_m_e_n_t_a_t_i_o_n_ _o_f_ _t_h_i_s_ _f_i_l_e_.
│ │ │ │ 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
│ │ │ │ @@ -26,558 +26,46 @@
│ │ │ │ 17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
│ │ │ │ 18 */
│ │ │ │ 19
│ │ │ │ 20/*
│ │ │ │ 21 * This file is part of LibreOffice published API.
│ │ │ │ 22 */
│ │ │ │ 23
│ │ │ │ -24#ifndef INCLUDED_SAL_TYPES_H
│ │ │ │ -25#define INCLUDED_SAL_TYPES_H
│ │ │ │ +24#ifndef INCLUDED_SAL_ALLOCA_H
│ │ │ │ +25#define INCLUDED_SAL_ALLOCA_H
│ │ │ │ 26
│ │ │ │ -27#include "_s_a_l_/_c_o_n_f_i_g_._h"
│ │ │ │ -28
│ │ │ │ -29#include #include <stddef.h>#include "sal/config.h"#include <stddef.h>#include "sal/macros.h"#include "sal/typesizes.h"
Go to the source code of this file.
│ │ ││ │ │ +Classes | |
| struct | _sal_Sequence |
| This is the binary specification of a SAL sequence. More... | |
│ │ │ +Namespaces | |
| namespace | com |
| namespace | com::sun |
| namespace | com::sun::star |
| namespace | sal |
│ │ │ Macros | |
| #define | SAL_N_ELEMENTS(arr) (sizeof (arr) / sizeof ((arr)[0])) |
| #define | SAL_STRINGIFY_ARG(x) #x |
| #define | SAL_STRINGIFY(x) SAL_STRINGIFY_ARG(x) |
| #define | sal_False ((sal_Bool)0) |
| #define | sal_True ((sal_Bool)1) |
| #define | SAL_UNICODE_NOTEQUAL_WCHAR_T |
| #define | SAL_PRI_SIZET "z" |
| #define | SAL_PRI_PTRDIFFT "t" |
| #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)) |
| #define | SAL_MAX_ENUM 0x7fffffff |
| #define | SAL_EXCEPTION_DLLPUBLIC_EXPORT |
| Exporting the symbols necessary for exception handling on GCC. | |
| #define | SAL_EXCEPTION_DLLPRIVATE |
| #define | SAL_WARN_UNUSED_RESULT |
| Use this as markup for functions and methods whose return value must be used. | |
| #define | SAL_NO_VTABLE |
| Use this for pure virtual classes, e.g. | |
| #define | SAL_SEQUENCE_HEADER_SIZE ((sal_Size) offsetof(sal_Sequence,elements)) |
| #define | SAL_THROW_EXTERN_C() throw () |
| Nothrow specification for C functions. | |
| #define | COVERITY_NOEXCEPT_FALSE |
| To markup destructors that coverity warns might throw exceptions which won't throw in practice, or where std::terminate is an acceptable response if they do. | |
| #define | SAL_DELETED_FUNCTION |
| short-circuit extra-verbose API namespaces | |
| #define | SAL_OVERRIDE |
| C++11 "override" feature. | |
| #define | SAL_CONSTEXPR |
| C++11 "constexpr" feature. | |
| #define | SAL_NOEXCEPT throw () |
| Macro for C++11 "noexcept" vs. | |
| #define | SAL_DEPRECATED(message) |
| Use as follows: SAL_DEPRECATED("Don't use, it's evil.") void doit(int nPara);. | |
| #define | SAL_DEPRECATED_INTERNAL(message) SAL_DEPRECATED(message) |
| This macro is used in cppumaker-generated include files, to tag entities that are marked as. | |
| #define | SAL_WNODEPRECATED_DECLARATIONS_PUSH |
| Use as follows: SAL_WNODEPRECATED_DECLARATIONS_PUSH ::std::auto_ptr<X> ... SAL_WNODEPRECATED_DECLARATIONS_POP. | |
| #define | SAL_WNODEPRECATED_DECLARATIONS_POP |
| #define | SAL_WNOUNREACHABLE_CODE_PUSH |
| Use as follows: | |
| #define | SAL_WNOUNREACHABLE_CODE_POP |
| #define | SAL_UNUSED_PARAMETER |
| Annotate unused but required C++ function parameters. | |
| #define | SAL_WARN_UNUSED |
| Annotate classes where a compiler should warn if an instance is unused. | |
│ │ │ +Typedefs | |
| typedef unsigned char | sal_Bool |
| typedef signed char | sal_Int8 |
| typedef unsigned char | sal_uInt8 |
| typedef sal_uInt16 | sal_Unicode |
| typedef void * | sal_Handle |
| typedef struct _sal_Sequence | sal_Sequence |
| This is the binary specification of a SAL sequence. | |
│ │ │ +Enumerations | |
| enum | __sal_NoAcquire { SAL_NO_ACQUIRE │ │ │ + } |
│ │ │ +Functions | |
| template<typename T1 , typename T2 > | |
| T1 | sal::static_int_cast (T2 n) |
| A static_cast between integral types, to avoid C++ compiler warnings. | |
| #define COVERITY_NOEXCEPT_FALSE | │ │ │ +
To markup destructors that coverity warns might throw exceptions which won't throw in practice, or where std::terminate is an acceptable response if they do.
│ │ │ + │ │ │ +| #define SAL_CONSTEXPR | │ │ │ +
C++11 "constexpr" feature.
│ │ │ +For LIBO_INTERNAL_ONLY, declare that it's possible to evaluate the value at compile time.
│ │ │ +| #define SAL_DELETED_FUNCTION | │ │ │ +
short-circuit extra-verbose API namespaces
│ │ │ +For LIBO_INTERNAL_ONLY, calling a deleted function will cause a compile-time error, while otherwise it will only cause a link-time error as the declared function is not defined.
│ │ │ +| #define SAL_N_ELEMENTS | │ │ │ +#define SAL_DEPRECATED | │ │ │( | │ │ ││ │ │ - | arr | ) | │ │ │ -(sizeof (arr) / sizeof ((arr)[0])) | │ │ │ +message | ) | │ │ │ +│ │ │ |
Use as follows: SAL_DEPRECATED("Don't use, it's evil.") void doit(int nPara);.
│ │ │ + │ │ │| #define SAL_STRINGIFY | │ │ │ +#define SAL_DEPRECATED_INTERNAL | │ │ │( | │ │ ││ │ │ - | x | ) | │ │ │ -SAL_STRINGIFY_ARG(x) | │ │ │ +message | ) | │ │ │ +SAL_DEPRECATED(message) | │ │ │ +
This macro is used in cppumaker-generated include files, to tag entities that are marked as.
│ │ │ +It causes deprecation warnings to be generated in external code, but for now is silenced in internal code. It would need some substantial clean-up of internal code to fix all warnings/errors generated by it. (Once that is done, it can become a synonym for SAL_DEPRECATED under LIBO_INTERNAL_ONLY, too. Completely removing the macro then would be incompatible, in case there are include files still around generated with a cppumaker that emitted it.)
│ │ │ + │ │ │ +| #define SAL_EXCEPTION_DLLPRIVATE | │ │ │
| #define SAL_STRINGIFY_ARG | │ │ │ +#define SAL_EXCEPTION_DLLPUBLIC_EXPORT | │ │ │ +
Exporting the symbols necessary for exception handling on GCC.
│ │ │ +These macros are used for inline declarations of exception classes, as in rtl/malformeduriexception.hxx.
│ │ │ + │ │ │ +| #define sal_False ((sal_Bool)0) | │ │ │ +
| #define SAL_MAX_ENUM 0x7fffffff | │ │ │ +
| #define SAL_MAX_INT16 ((sal_Int16) 0x7FFF) | │ │ │ +
| #define SAL_MAX_INT32 ((sal_Int32) 0x7FFFFFFF) | │ │ │ +
| #define SAL_MAX_INT64 ((sal_Int64) SAL_CONST_INT64(0x7FFFFFFFFFFFFFFF)) | │ │ │ +
| #define SAL_MAX_INT8 ((sal_Int8) 0x7F) | │ │ │ +
| #define SAL_MAX_UINT16 ((sal_uInt16) 0xFFFF) | │ │ │ +
| #define SAL_MAX_UINT32 ((sal_uInt32) 0xFFFFFFFF) | │ │ │ +
| #define SAL_MAX_UINT64 ((sal_uInt64) SAL_CONST_UINT64(0xFFFFFFFFFFFFFFFF)) | │ │ │ +
| #define SAL_MAX_UINT8 ((sal_uInt8) 0xFF) | │ │ │ +
| #define SAL_MIN_INT16 ((sal_Int16) (-0x7FFF - 1)) | │ │ │ +
| #define SAL_MIN_INT32 ((sal_Int32) (-0x7FFFFFFF - 1)) | │ │ │ +
| #define SAL_MIN_INT64 ((sal_Int64) (SAL_CONST_INT64(-0x7FFFFFFFFFFFFFFF) - 1)) | │ │ │ +
| #define SAL_MIN_INT8 ((sal_Int8) (-0x7F - 1)) | │ │ │ +
| #define SAL_NO_VTABLE | │ │ │ +
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.
│ │ │ + │ │ │ +| #define SAL_NOEXCEPT throw () | │ │ │ +
Macro for C++11 "noexcept" vs.
│ │ │ +"throw ()" exception specification.
│ │ │ +The latter has been removed completely from C++20.
│ │ │ +| #define SAL_OVERRIDE | │ │ │ +
C++11 "override" feature.
│ │ │ +For LIBO_INTERNAL_ONLY, force the method to override an existing method in parent, error out if the method with the correct signature does not exist.
│ │ │ +| #define SAL_PRI_PTRDIFFT "t" | │ │ │ +
| #define SAL_PRI_SIZET "z" | │ │ │ +
| #define SAL_SEQUENCE_HEADER_SIZE ((sal_Size) offsetof(sal_Sequence,elements)) | │ │ │ +
| #define SAL_THROW_EXTERN_C | │ │ │( | │ │ │ -│ │ │ - | x | ) | │ │ │ -#x | │ │ │ +) | │ │ │ +throw () | │ │ │ +
Nothrow specification for C functions.
│ │ │ +This is a macro so it can expand to nothing in C code.
│ │ │ + │ │ │ +| #define sal_True ((sal_Bool)1) | │ │ │ +
| #define SAL_UNICODE_NOTEQUAL_WCHAR_T | │ │ │ +
| #define SAL_UNUSED_PARAMETER | │ │ │ +
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.
│ │ │ +| #define SAL_WARN_UNUSED | │ │ │ +
Annotate classes where a compiler should warn if an instance is unused.
│ │ │ +The compiler cannot warn about unused instances if they have non-trivial or external constructors or destructors. Classes marked with SAL_WARN_UNUSED will be warned about.
│ │ │ +| #define SAL_WARN_UNUSED_RESULT | │ │ │ +
Use this as markup for functions and methods whose return value must be used.
│ │ │ +Compilers that support a construct of this nature will emit a compile time warning on unused return value.
│ │ │ + │ │ │ +| #define SAL_WNODEPRECATED_DECLARATIONS_POP | │ │ │ +
| #define SAL_WNODEPRECATED_DECLARATIONS_PUSH | │ │ │ +
Use as follows: SAL_WNODEPRECATED_DECLARATIONS_PUSH ::std::auto_ptr<X> ... SAL_WNODEPRECATED_DECLARATIONS_POP.
│ │ │ + │ │ │ +| #define SAL_WNOUNREACHABLE_CODE_POP | │ │ │ +
| #define SAL_WNOUNREACHABLE_CODE_PUSH | │ │ │ +
Use as follows:
│ │ │ +SAL_WNOUNREACHABLE_CODE_PUSH
│ │ │ +function definition
│ │ │ +SAL_WNOUNREACHABLE_CODE_POP
│ │ │ +Useful in cases where the compiler is "too clever" like when doing link-time code generation, and noticing that a called function always throws, and fixing the problem cleanly so that it produces no warnings in normal non-LTO compilations either is not easy.
│ │ │ + │ │ │ +| typedef unsigned char sal_Bool | │ │ │ +
| typedef void* sal_Handle | │ │ │ +
| typedef signed char sal_Int8 | │ │ │ +
| typedef struct _sal_Sequence sal_Sequence | │ │ │
This is the binary specification of a SAL sequence.
│ │ │ + │ │ │ +| typedef unsigned char sal_uInt8 | │ │ │ +
| typedef sal_uInt16 sal_Unicode | │ │ │ +
| enum __sal_NoAcquire | │ │ │ +
1.9.8
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,28 +1,327 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ * _s_a_l
│ │ │ │ -_M_a_c_r_o_s
│ │ │ │ -macros.h File Reference
│ │ │ │ +_C_l_a_s_s_e_s | _N_a_m_e_s_p_a_c_e_s | _M_a_c_r_o_s | _T_y_p_e_d_e_f_s | _E_n_u_m_e_r_a_t_i_o_n_s | _F_u_n_c_t_i_o_n_s
│ │ │ │ +types.h File Reference
│ │ │ │ +#include "_s_a_l_/_c_o_n_f_i_g_._h"
│ │ │ │ #include 1.9.8
│ │ │
│ │ │
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,14 +1,14 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ * _s_a_l
│ │ │ │ -macros.h
│ │ │ │ +types.h
│ │ │ │ _G_o_ _t_o_ _t_h_e_ _d_o_c_u_m_e_n_t_a_t_i_o_n_ _o_f_ _t_h_i_s_ _f_i_l_e_.
│ │ │ │ 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
│ │ │ │ @@ -26,49 +26,558 @@
│ │ │ │ 17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
│ │ │ │ 18 */
│ │ │ │ 19
│ │ │ │ 20/*
│ │ │ │ 21 * This file is part of LibreOffice published API.
│ │ │ │ 22 */
│ │ │ │ 23
│ │ │ │ -24#ifndef INCLUDED_SAL_MACROS_H
│ │ │ │ -25#define INCLUDED_SAL_MACROS_H
│ │ │ │ +24#ifndef INCLUDED_SAL_TYPES_H
│ │ │ │ +25#define INCLUDED_SAL_TYPES_H
│ │ │ │ 26
│ │ │ │ -27#include #include "osl/endian.h"#include <stddef.h>
Go to the source code of this file.
│ │ ││ │ │ Macros | |
| #define | SAL_MATH_FPEXCEPTIONS_OFF() |
| #define | SAL_N_ELEMENTS(arr) (sizeof (arr) / sizeof ((arr)[0])) |
| #define | SAL_STRINGIFY_ARG(x) #x |
| #define | SAL_STRINGIFY(x) SAL_STRINGIFY_ARG(x) |
| #define SAL_MATH_FPEXCEPTIONS_OFF | │ │ │ +#define SAL_N_ELEMENTS | │ │ │( | │ │ │ -) | │ │ │ -│ │ │ + | │ │ │ + | arr | ) | │ │ │ +(sizeof (arr) / sizeof ((arr)[0])) | │ │ │ +
| #define SAL_STRINGIFY | │ │ │ +( | │ │ │ +│ │ │ + | x | ) | │ │ │ +SAL_STRINGIFY_ARG(x) | │ │ │ +
| #define SAL_STRINGIFY_ARG | │ │ │ +( | │ │ │ +│ │ │ + | x | ) | │ │ │ +#x | │ │ │
1.9.8
│ │ │
│ │ │
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,14 +1,14 @@
│ │ │ │ LibreOffice
│ │ │ │ LibreOffice 26.8 SDK C/C++ API Reference
│ │ │ │ Loading...
│ │ │ │ Searching...
│ │ │ │ No Matches
│ │ │ │ * _s_a_l
│ │ │ │ -mathconf.h
│ │ │ │ +macros.h
│ │ │ │ _G_o_ _t_o_ _t_h_e_ _d_o_c_u_m_e_n_t_a_t_i_o_n_ _o_f_ _t_h_i_s_ _f_i_l_e_.
│ │ │ │ 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
│ │ │ │ @@ -26,161 +26,49 @@
│ │ │ │ 17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
│ │ │ │ 18 */
│ │ │ │ 19
│ │ │ │ 20/*
│ │ │ │ 21 * This file is part of LibreOffice published API.
│ │ │ │ 22 */
│ │ │ │ 23
│ │ │ │ -24#ifndef INCLUDED_SAL_MATHCONF_H
│ │ │ │ -25#define INCLUDED_SAL_MATHCONF_H
│ │ │ │ +24#ifndef INCLUDED_SAL_MACROS_H
│ │ │ │ +25#define INCLUDED_SAL_MACROS_H
│ │ │ │ 26
│ │ │ │ -27#include "_o_s_l_/_e_n_d_i_a_n_._h"
│ │ │ │ +27#include