summaryrefslogtreecommitdiff
path: root/attic/historic/anode/libanode/impl/thread.h
blob: accf173ace89eb1e8175b73883772284887631e3 (plain)
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
/* libanode: the Anode C reference implementation
 * Copyright (C) 2009-2010 Adam Ierymenko <adam.ierymenko@gmail.com>
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>. */

#ifndef _ANODE_THREAD_H
#define _ANODE_THREAD_H

#ifdef WINDOWS

#include <windows.h>
#include <thread.h>
typedef DWORD AnodeThreadId;

#else /* not WINDOWS */

#include <pthread.h>
typedef pthread_t AnodeThreadId;

#define AnodeThread_self() pthread_self()
#define AnodeThreadId_equal(a,b) pthread_equal((pthread_t)(a),(pthread_t)(b))

#endif

typedef void AnodeThread;

/**
 * Create and launch a new thread
 *
 * If wait_for_join is true (nonzero), the thread can and must be joined. The
 * thread object won't be freed until join is called and returns. If
 * wait_for_join is false, the thread object frees itself automatically on
 * termination.
 *
 * If wait_for_join is false (zero), there is really no need to keep track of
 * the thread object.
 *
 * @param func Function to call as thread main
 * @param arg Argument to pass to function
 * @param wait_for_join If false, thread deletes itself when it terminates
 */
AnodeThread *AnodeThread_create(void (*func)(void *),void *arg,int wait_for_join);

/**
 * Wait for a thread to terminate and delete thread object
 *
 * This can only be used for threads created with wait_for_join set to true.
 * The thread object is no longer valid after this call.
 *
 * @param thread Thread to wait for termination and delete
 */
void AnodeThread_join(AnodeThread *thread);

#endif