LibreOffice
LibreOffice 6.0 SDK C/C++ API Reference
main.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_MAIN_H
21 #define INCLUDED_SAL_MAIN_H
22 
23 #include <sal/config.h>
24 
25 #include <sal/saldllapi.h>
26 #include <sal/types.h>
27 
28 #if defined AIX
29 #include <unistd.h>
30 #endif
31 
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
35 
36 SAL_DLLPUBLIC void SAL_CALL sal_detail_initialize(int argc, char ** argv);
37 SAL_DLLPUBLIC void SAL_CALL sal_detail_deinitialize(void);
38 
39 #if defined IOS || defined ANDROID
40 
41 #error No code that includes this should be built for iOS or Android
42 
43 #else
44 
45 #define SAL_MAIN_WITH_ARGS_IMPL \
46 int SAL_DLLPUBLIC_EXPORT SAL_CALL main(int argc, char ** argv) \
47 { \
48  int ret; \
49  sal_detail_initialize(argc, argv); \
50  ret = sal_main_with_args(argc, argv); \
51  sal_detail_deinitialize(); \
52  return ret; \
53 }
54 
55 #define SAL_MAIN_IMPL \
56 int SAL_DLLPUBLIC_EXPORT SAL_CALL main(int argc, char ** argv) \
57 { \
58  int ret; \
59  sal_detail_initialize(argc, argv); \
60  ret = sal_main(); \
61  sal_detail_deinitialize(); \
62  return ret; \
63 }
64 
65 #endif
66 
67 
68 /* Definition macros for CRT entries */
69 
70 #ifdef SAL_W32
71 
72 #include <stdlib.h>
73 
74 /* Sorry but this is necessary cause HINSTANCE is a typedef that differs (C++ causes an error) */
75 
76 #ifndef WINAPI
77 # define WINAPI __stdcall
78 #endif
79 
80 #if !defined(DECLARE_HANDLE)
81 # ifdef STRICT
82  typedef void *HANDLE;
83 # define DECLARE_HANDLE(name) struct name##__ { int unused; }; typedef struct name##__ *name
84 # else
85  typedef void *PVOID;
86  typedef PVOID HANDLE;
87 # define DECLARE_HANDLE(name) typedef HANDLE name
88 # endif
89 DECLARE_HANDLE(HINSTANCE);
90 #endif
91 
92 
93 
94 #define SAL_WIN_WinMain \
95 int WINAPI WinMain( HINSTANCE _hinst, HINSTANCE _dummy, char* _cmdline, int _nshow ) \
96 { \
97  int argc = __argc; char ** argv = __argv; \
98  (void) _hinst; (void) _dummy; (void) _cmdline; (void) _nshow; /* unused */ \
99  return main(argc, argv); \
100 }
101 
102 #else /* ! SAL_W32 */
103 
104 # define SAL_WIN_WinMain
105 
106 #endif /* ! SAL_W32 */
107 
108 /* Implementation macro */
109 
110 #define SAL_IMPLEMENT_MAIN_WITH_ARGS(_argc_, _argv_) \
111  static int SAL_CALL sal_main_with_args (int _argc_, char ** _argv_); \
112  SAL_MAIN_WITH_ARGS_IMPL \
113  SAL_WIN_WinMain \
114  static int SAL_CALL sal_main_with_args(int _argc_, char ** _argv_)
115 
116 #define SAL_IMPLEMENT_MAIN() \
117  static int SAL_CALL sal_main(void); \
118  SAL_MAIN_IMPL \
119  SAL_WIN_WinMain \
120  static int SAL_CALL sal_main(void)
121 
122 /*
123  "How to use" Examples:
124 
125  #include <sal/main.h>
126 
127  SAL_IMPLEMENT_MAIN()
128  {
129  DoSomething();
130 
131  return 0;
132  }
133 
134  SAL_IMPLEMENT_MAIN_WITH_ARGS(argc, argv)
135  {
136  DoSomethingWithArgs(argc, argv);
137 
138  return 0;
139  }
140 
141 */
142 
143 #ifdef __cplusplus
144 } /* extern "C" */
145 #endif
146 
147 #endif // INCLUDED_SAL_MAIN_H
148 
149 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
#define SAL_DLLPUBLIC
Definition: saldllapi.h:30
SAL_DLLPUBLIC void sal_detail_initialize(int argc, char **argv)
SAL_DLLPUBLIC void sal_detail_deinitialize(void)