mirror of
https://github.com/gnustep/libs-base.git
synced 2025-05-07 23:10:44 +00:00
c2b8811456
forward declaration. * Headers/Additions/GNUstepBase/GSCategories.h: Remove declaraion of gnustep_global_lock. (GS_INITIALIZED_LOCK): New macro. (+[NSLock newLockAt:]): New method. (+[NSRecursiveLock newLockAt:]): Ditto. * Headers/Foundation/NSLock.h: Ditto. * Source/Additions/GSCategories.m: Replace global lock with local lock. (_GSLockInitializer): New class to initialize local lock safely. (newLockAt): New static function shared by +newLockAt: implementations to safely intialize lock variables. (+[NSLock newLockAt:]): Implemented and documented. (+[NSRecursiveLock newLockAt:]): Ditto. * Source/Additions/GSCompatibility.m: Remove gnustep_global_lock. * Source/Additions/GSObjCRuntime.m: Remove superfluous locking. * Source/Additions/Unicode.m: Use new GS_INITIALIZED_LOCK macro and replace global lock with local lock. * Source/NSLock.m (-[NSConditionLock lockWhenCondition:beforeDate:]): Implemented. * Testing/gslock.m: New test case. * Testing/GNUmakefile: Add new test case. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@18010 72102866-910b-0410-8b05-ffd578937521
169 lines
3.8 KiB
Objective-C
169 lines
3.8 KiB
Objective-C
/*
|
|
NSLock.h
|
|
|
|
Definitions for locking protocol and classes
|
|
|
|
Copyright (C) 1996 Free Software Foundation, Inc.
|
|
|
|
Author: Scott Christley <scottc@net-community.com>
|
|
Date: 1996
|
|
|
|
This file is part of the GNUstep Objective-C Library.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library 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
|
|
Library General Public License for more details.
|
|
|
|
If you are interested in a warranty or support for this source code,
|
|
contact Scott Christley <scottc@net-community.com> for more information.
|
|
|
|
You should have received a copy of the GNU Library General Public
|
|
License along with this library; if not, write to the Free
|
|
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
|
|
*/
|
|
|
|
#ifndef _GNUstep_H_NSLock
|
|
#define _GNUstep_H_NSLock
|
|
|
|
#include <Foundation/NSObject.h>
|
|
#ifdef NeXT_RUNTIME
|
|
#include <GNUstepBase/thr-mach.h>
|
|
#endif
|
|
|
|
/*
|
|
* NSLocking protocol
|
|
*/
|
|
@protocol NSLocking
|
|
|
|
- (void) lock;
|
|
- (void) unlock;
|
|
|
|
@end
|
|
|
|
/*
|
|
* NSLock class
|
|
* Simplest lock for protecting critical sections of code
|
|
*/
|
|
@interface NSLock : NSObject <NSLocking, GCFinalization>
|
|
{
|
|
@private
|
|
objc_mutex_t _mutex;
|
|
}
|
|
|
|
- (BOOL) tryLock;
|
|
- (BOOL) lockBeforeDate: (NSDate*)limit;
|
|
|
|
- (void) lock;
|
|
- (void) unlock;
|
|
|
|
@end
|
|
|
|
/*
|
|
* NSConditionLock
|
|
* Allows locking and unlocking to be based upon a condition
|
|
*/
|
|
@interface NSConditionLock : NSObject <NSLocking, GCFinalization>
|
|
{
|
|
@private
|
|
objc_condition_t _condition;
|
|
objc_mutex_t _mutex;
|
|
int _condition_value;
|
|
}
|
|
|
|
/*
|
|
* Initialize lock with condition
|
|
*/
|
|
- (id) initWithCondition: (int)value;
|
|
|
|
/*
|
|
* Return the current condition of the lock
|
|
*/
|
|
- (int) condition;
|
|
|
|
/*
|
|
* Acquiring and release the lock
|
|
*/
|
|
- (void) lockWhenCondition: (int)value;
|
|
- (void) unlockWithCondition: (int)value;
|
|
- (BOOL) tryLock;
|
|
- (BOOL) tryLockWhenCondition: (int)value;
|
|
|
|
/*
|
|
* Acquiring the lock with a date condition
|
|
*/
|
|
- (BOOL) lockBeforeDate: (NSDate*)limit;
|
|
- (BOOL) lockWhenCondition: (int)condition_to_meet
|
|
beforeDate: (NSDate*)limitDate;
|
|
|
|
- (void) lock;
|
|
- (void) unlock;
|
|
|
|
@end
|
|
|
|
/*
|
|
* NSRecursiveLock
|
|
* Allows the lock to be recursively acquired by the same thread
|
|
*
|
|
* If the same thread locks the mutex (n) times then that same
|
|
* thread must also unlock it (n) times before another thread
|
|
* can acquire the lock.
|
|
*/
|
|
@interface NSRecursiveLock : NSObject <NSLocking, GCFinalization>
|
|
{
|
|
@private
|
|
objc_mutex_t _mutex;
|
|
}
|
|
|
|
- (BOOL) tryLock;
|
|
- (BOOL) lockBeforeDate: (NSDate*)limit;
|
|
|
|
- (void) lock;
|
|
- (void) unlock;
|
|
|
|
@end
|
|
|
|
#ifndef NO_GNUSTEP
|
|
|
|
/**
|
|
* Returns IDENT which will be initialized
|
|
* to an instance of a CLASSNAME in a thread safe manner.
|
|
* If IDENT has been previoulsy initilized
|
|
* this macro merely returns IDENT.
|
|
* IDENT is considered uninitialzed, if it contains nil.
|
|
* CLASSNAME must be either NSLock, NSRecursiveLock or one
|
|
* of thier subclasses.
|
|
* See [NSLock+newLockAt:] for details.
|
|
* This macro is intended for code that cannot insure
|
|
* that a lock can be initialized in thread safe manner otherwise.
|
|
* <example>
|
|
* NSLock *my_lock = nil;
|
|
*
|
|
* void function (void)
|
|
* {
|
|
* [GS_INITIALIZED_LOCK(my_lock, NSLock) lock];
|
|
* do_work ();
|
|
* [my_lock unlock];
|
|
* }
|
|
*
|
|
* </example>
|
|
*/
|
|
#define GS_INITIALIZED_LOCK(IDENT,CLASSNAME) \
|
|
(IDENT != nil ? IDENT : [CLASSNAME newLockAt: &IDENT])
|
|
|
|
@interface NSLock (GSCategories)
|
|
+ (id)newLockAt:(id *)location;
|
|
@end
|
|
|
|
@interface NSRecursiveLock (GSCategories)
|
|
+ (id)newLockAt:(id *)location;
|
|
@end
|
|
|
|
#endif /* NO_GNUSTEP */
|
|
|
|
#endif /* _GNUstep_H_NSLock*/
|