src/OFThread.h

/*
 * Copyright (c) 2008, 2009, 2010, 2011, 2012
 *   Jonathan Schleifer <js@webkeks.org>
 *
 * All rights reserved.
 *
 * This file is part of ObjFW. It may be distributed under the terms of the
 * Q Public License 1.0, which can be found in the file LICENSE.QPL included in
 * the packaging of this file.
 *
 * Alternatively, it may be distributed under the terms of the GNU General
 * Public License, either version 2 or 3, which can be found in the file
 * LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
 * file.
 */

#import "OFObject.h"
#import "OFList.h"

#import "threading.h"

@class OFDate;

#ifdef OF_HAVE_BLOCKS
typedef id (^of_thread_block_t)(id object);
#endif

@interface OFTLSKey: OFObject
{
@public
        of_tlskey_t key;
/* Work around a bug in gcc 4.4.4 (possibly only on Haiku) */
#if !defined(__GNUC__) || __GNUC__ != 4 || __GNUC_MINOR__ != 4 || \
    __GNUC_PATCHLEVEL__ != 4
@protected
#endif
        void (*destructor)(id);
        of_list_object_t *listObject;
        BOOL initialized;
}

+ TLSKey;

+ TLSKeyWithDestructor: (void(*)(id))destructor;

+ (void)callAllDestructors;

- initWithDestructor: (void(*)(id))destructor;
@end

@interface OFThread: OFObject
{
@public
        id object;
        of_thread_t thread;
        enum {
                OF_THREAD_NOT_RUNNING,
                OF_THREAD_RUNNING,
                OF_THREAD_WAITING_FOR_JOIN
        } running;
#ifdef OF_HAVE_BLOCKS
        of_thread_block_t block;
#endif
        id returnValue;
}

#if defined(OF_HAVE_PROPERTIES) && defined(OF_HAVE_BLOCKS)
@property (retain) of_thread_block_t block;
#endif

+ thread;

+ threadWithObject: (id)object;

#ifdef OF_HAVE_BLOCKS

+ threadWithBlock: (of_thread_block_t)block;

+ threadWithBlock: (of_thread_block_t)block
           object: (id)object;
#endif

+ (void)setObject: (id)object
        forTLSKey: (OFTLSKey*)key;

+ (id)objectForTLSKey: (OFTLSKey*)key;

+ (OFThread*)currentThread;

+ (void)sleepForTimeInterval: (double)seconds;

+ (void)sleepUntilDate: (OFDate*)date;

+ (void)yield;

+ (void)terminate;

+ (void)terminateWithObject: (id)object;

- initWithObject: (id)object;

#ifdef OF_HAVE_BLOCKS

- initWithBlock: (of_thread_block_t)block;

- initWithBlock: (of_thread_block_t)block
         object: (id)object;
#endif

- (id)main;

- (void)handleTermination;

- (void)start;

- (id)join;
@end

@interface OFMutex: OFObject
{
        of_mutex_t mutex;
        BOOL initialized;
}

+ mutex;

- (void)lock;

- (BOOL)tryLock;

- (void)unlock;
@end

@interface OFCondition: OFMutex
{
        of_condition_t condition;
        BOOL conditionInitialized;
}

+ condition;

- (void)wait;

- (void)signal;

- (void)broadcast;
@end