LibreOfficeDev
LibreOfficeDev 27.2 SDK C/C++ API Reference
thread.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 /*
21  * This file is part of LibreOffice published API.
22  */
23 
24 #ifndef INCLUDED_OSL_THREAD_H
25 #define INCLUDED_OSL_THREAD_H
26 
27 #include "sal/config.h"
28 
29 #include "rtl/textenc.h"
30 #include "sal/saldllapi.h"
31 
32 #if defined LIBO_INTERNAL_ONLY && defined __cplusplus
33 struct TimeValue;
34 #else
35 #include "osl/time.h"
36 #endif
37 
38 #ifdef __cplusplus
39 extern "C" {
40 #endif
41 
46 typedef void* oslThread;
47 
50 typedef void (SAL_CALL *oslWorkerFunction)(void*);
51 
57 typedef enum
58 {
64  osl_Thread_PriorityUnknown, /* don't use to set */
67 
68 
69 typedef sal_uInt32 oslThreadIdentifier;
70 
71 typedef void* oslThreadKey;
72 
84 SAL_DLLPUBLIC oslThread SAL_CALL osl_createThread(oslWorkerFunction pWorker, void* pThreadData);
85 
98 
107 
116 
123 
130 
138 
146 
154 
161 
167 SAL_DLLPUBLIC void SAL_CALL osl_waitThread(const TimeValue* pDelay);
168 
175 
185 
193 SAL_DLLPUBLIC void SAL_CALL osl_yieldThread(void);
194 
205 SAL_DLLPUBLIC void SAL_CALL osl_setThreadName(char const * name);
206 
207 /* Callback when data stored in a thread key is no longer needed */
208 
209 typedef void (SAL_CALL *oslThreadKeyCallbackFunction)(void *);
210 
213 
216 
219 
222 
225 
230 
231 #ifdef __cplusplus
232 }
233 #endif
234 
235 #endif // INCLUDED_OSL_THREAD_H
236 
237 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
#define SAL_DLLPUBLIC
Definition: saldllapi.h:34
#define SAL_MAX_ENUM
Definition: types.h:205
unsigned char sal_Bool
Definition: types.h:38
sal_uInt16 rtl_TextEncoding
The various supported text encodings.
Definition: textenc.h:37
SAL_DLLPUBLIC void osl_terminateThread(oslThread Thread)
The requested thread will get terminate the next time scheduleThread() is called.
SAL_DLLPUBLIC void osl_setThreadPriority(oslThread Thread, oslThreadPriority Priority)
Changes the threads priority.
SAL_DLLPUBLIC void osl_resumeThread(oslThread Thread)
Wake-up a thread that was suspended with suspend() or createSuspended().
SAL_DLLPUBLIC oslThread osl_createThread(oslWorkerFunction pWorker, void *pThreadData)
Create the thread, using the function-ptr pWorker as its main (worker) function.
SAL_DLLPUBLIC oslThread osl_createSuspendedThread(oslWorkerFunction pWorker, void *pThreadData)
Create the thread, using the function-ptr pWorker as its main (worker) function.
void * oslThreadKey
Definition: thread.h:71
SAL_DLLPUBLIC sal_Bool osl_scheduleThread(oslThread Thread)
Schedules in thread to wait till after time slice of specified thread.
SAL_DLLPUBLIC void osl_setThreadName(char const *name)
Attempts to set the name of the current thread.
SAL_DLLPUBLIC rtl_TextEncoding osl_setThreadTextEncoding(rtl_TextEncoding Encoding)
Set the thread local text encoding.
SAL_DLLPUBLIC void osl_yieldThread(void)
Offers the rest of the threads time-slice to the OS.
void(* oslWorkerFunction)(void *)
the function-ptr.
Definition: thread.h:50
SAL_DLLPUBLIC void osl_destroyThread(oslThread Thread)
Release the thread handle.
SAL_DLLPUBLIC oslThreadIdentifier osl_getThreadIdentifier(oslThread Thread)
Get the identifier for the specified thread or if parameter Thread is NULL of the current active thre...
oslThreadPriority
levels of thread-priority Note that oslThreadPriorityUnknown might be returned by getPriorityOfThread...
Definition: thread.h:58
@ osl_Thread_Priority_FORCE_EQUAL_SIZE
Definition: thread.h:65
@ osl_Thread_PriorityUnknown
Definition: thread.h:64
@ osl_Thread_PriorityHighest
Definition: thread.h:59
@ osl_Thread_PriorityBelowNormal
Definition: thread.h:62
@ osl_Thread_PriorityNormal
Definition: thread.h:61
@ osl_Thread_PriorityAboveNormal
Definition: thread.h:60
@ osl_Thread_PriorityLowest
Definition: thread.h:63
SAL_DLLPUBLIC void osl_joinWithThread(oslThread Thread)
Blocks the calling thread until Thread has terminated.
void(* oslThreadKeyCallbackFunction)(void *)
Definition: thread.h:209
SAL_DLLPUBLIC rtl_TextEncoding osl_getThreadTextEncoding(void)
Get the current thread local text encoding.
SAL_DLLPUBLIC void osl_destroyThreadKey(oslThreadKey Key)
Destroy a key to an associated thread local storage pointer.
sal_uInt32 oslThreadIdentifier
Definition: thread.h:69
SAL_DLLPUBLIC sal_Bool osl_setThreadKeyData(oslThreadKey Key, void *pData)
Set to key associated thread specific data.
void * oslThread
Opaque data type for threads.
Definition: thread.h:46
SAL_DLLPUBLIC sal_Bool osl_isThreadRunning(const oslThread Thread)
Returns True if the thread was created and has not terminated yet.
SAL_DLLPUBLIC void * osl_getThreadKeyData(oslThreadKey Key)
Get to key associated thread specific data.
SAL_DLLPUBLIC void osl_suspendThread(oslThread Thread)
Suspend the execution of the thread.
SAL_DLLPUBLIC oslThreadPriority osl_getThreadPriority(const oslThread Thread)
Retrieves the threads priority.
SAL_DLLPUBLIC oslThreadKey osl_createThreadKey(oslThreadKeyCallbackFunction pCallback)
Create a key to an associated thread local storage pointer.
SAL_DLLPUBLIC void osl_waitThread(const TimeValue *pDelay)
Suspends the execution of the calling thread for at least the given time.
Time since Jan-01-1970.
Definition: time.h:76