mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-25 17:51:01 +00:00
a5c6cfa9f7
enumeration methods that take blocks as arguments. This allows us to implement the NSEnumerationConcurrent option of those methods with minimal effort. The searching methods on NSIndexSet and all the sorting methods are still missing. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@35010 72102866-910b-0410-8b05-ffd578937521
139 lines
4.5 KiB
Objective-C
139 lines
4.5 KiB
Objective-C
/* Support header for conditionally enabling use of libdispatch.
|
|
Copyright (C) 2012 Free Software Foundation, Inc.
|
|
|
|
Written by: Niels Grewe <niels.grewe@halbordnung.de>
|
|
Date: March 2012
|
|
|
|
This file is part of the GNUstep Base Library.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser 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.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free
|
|
Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02111 USA.
|
|
*/
|
|
|
|
#import "GNUstepBase/GSConfig.h"
|
|
#import <GNUstepBase/GSBlocks.h>
|
|
#if HAVE_DISPATCH_H
|
|
#include <dispatch.h>
|
|
#elif HAVE_DISPATCH_DISPATCH_H
|
|
#include <dispatch/dispatch.h>
|
|
#endif
|
|
|
|
|
|
/*
|
|
* If gnustep-base is built with libdispatch support, these macros will expand
|
|
* to code for creating and cleaning up after libdispach queues to which blocks
|
|
* can be submitted. If libdispatch is not available, setup and teardown will
|
|
* be no-ops, and the block will simply be executed on the calling thread.
|
|
*/
|
|
#if __has_feature(blocks) && (GS_USE_LIBDISPATCH == 1)
|
|
|
|
/*
|
|
* Older versions of libdispatch do not support concurrent queues. We define away the
|
|
* attributes in this case.
|
|
*/
|
|
#ifndef DISPATCH_QUEUE_SERIAL
|
|
#define DISPATCH_QUEUE_SERIAL NULL
|
|
#endif
|
|
#ifndef DISPATCH_QUEUE_CONCURRENT
|
|
#define DISPATCH_QUEUE_CONCURRENT NULL
|
|
#endif
|
|
|
|
#define GS_DISPATCH_GET_DEFAULT_CONCURRENT_QUEUE() dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0)
|
|
/**
|
|
* This macro creates a dispatch queue using the attributes
|
|
*/
|
|
#define GS_DISPATCH_QUEUE_CREATE(attr) dispatch_queue_create(NULL, attr)
|
|
|
|
/**
|
|
* Create a dispatch group
|
|
*/
|
|
#define GS_DISPATCH_GROUP_CREATE() dispatch_group_create()
|
|
|
|
/**
|
|
* Wait for the dispatch group to finish
|
|
*/
|
|
#define GS_DISPATCH_GROUP_FINISH(group) dispatch_group_wait(group, DISPATCH_TIME_FOREVER)
|
|
|
|
/**
|
|
* Release an dispatch object.
|
|
*/
|
|
#define GS_DISPATCH_RELEASE(x) dispatch_release(x)
|
|
/**
|
|
* Allows an arbitrary block to be submitted to the queue. Since dispatch blocks
|
|
* return nothing and take no arguments, the caller can use the before and after
|
|
* arguments to set up and tear down the block as required.
|
|
*/
|
|
#define GS_DISPATCH_SUBMIT_BLOCK(group, queue, before, after, block, args, ...) \
|
|
dispatch_group_async(group, queue, ^(void){before; block(args, ## __VA_ARGS__); after;})
|
|
|
|
/**
|
|
* Submits a block without special provisions.
|
|
*/
|
|
#define GS_DISPATCH_SUBMIT_BLOCK_NO_ARGS(group, queue, block) dispatch_group_async(group, queue, block)
|
|
|
|
|
|
/**
|
|
* Convenience macro to create serial or concurrent dispatch queues for the
|
|
* various -enumerateUsingBlock: methods.
|
|
*/
|
|
#define GS_DISPATCH_CREATE_QUEUE_AND_GROUP_FOR_ENUMERATION(queue, opts)\
|
|
dispatch_queue_t queue;\
|
|
dispatch_group_t queue ## Group;\
|
|
if (opts & NSEnumerationConcurrent)\
|
|
{\
|
|
queue = GS_DISPATCH_GET_DEFAULT_CONCURRENT_QUEUE();\
|
|
}\
|
|
else\
|
|
{\
|
|
queue = GS_DISPATCH_QUEUE_CREATE(DISPATCH_QUEUE_SERIAL);\
|
|
}\
|
|
queue ## Group = GS_DISPATCH_GROUP_CREATE();
|
|
|
|
/**
|
|
* Convenience macro to destroy serial or concurrent dispatch queues for the
|
|
* various -enumerateUsingBlock: methods.
|
|
*/
|
|
#define GS_DISPATCH_TEARDOWN_QUEUE_AND_GROUP_FOR_ENUMERATION(queue, opts)\
|
|
GS_DISPATCH_GROUP_FINISH(queue ## Group);\
|
|
GS_DISPATCH_RELEASE(enumQueueGroup);\
|
|
if (NO == (opts & NSEnumerationConcurrent))\
|
|
{\
|
|
GS_DISPATCH_RELEASE(enumQueue);\
|
|
}
|
|
|
|
|
|
#else
|
|
|
|
/*
|
|
* No-Op defintions if libdispatch is not supposed to be used.
|
|
*/
|
|
#define DISPATCH_QUEUE_SERIAL 0
|
|
#define DISPATCH_QUEUE_CONCURRENT 0
|
|
#define dispatch_queue_attr_t int
|
|
#define dispatch_queue_t int
|
|
#define dispatch_group_t int
|
|
#define GS_DISPATCH_GET_DEFAULT_CONCURRENT_QUEUE() 0
|
|
#define GS_DISPATCH_QUEUE_CREATE(attr) 0
|
|
#define GS_DISPATCH_GROUP_CREATE() 0
|
|
#define GS_DISPATCH_GROUP_FINISH(group)
|
|
#define GS_DISPATCH_RELEASE(x)
|
|
#define GS_DISPATCH_SUBMIT_BLOCK(group, queue, before, after, block, args...) CALL_BLOCK(block, args)
|
|
#define GS_DISPATCH_SUBMIT_BLOCK_NO_ARGS(group, queue, block) CALL_BLOCK_NO_ARGS(block)
|
|
#define GS_DISPATCH_CREATE_QUEUE_AND_GROUP_FOR_ENUMERATION(queue, opts)
|
|
#define GS_DISPATCH_TEARDOWN_QUEUE_AND_GROUP_FOR_ENUMERATION(queue, opts)
|
|
#endif
|
|
|
|
|
|
|