[apple/libdispatch.git] / dispatch / data.h

/*
 * Copyright (c) 2009-2013 Apple Inc. All rights reserved.
 *
 * @APPLE_APACHE_LICENSE_HEADER_START@
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * @APPLE_APACHE_LICENSE_HEADER_END@
 */

#ifndef __DISPATCH_DATA__
#define __DISPATCH_DATA__

#ifndef __DISPATCH_INDIRECT__
#error "Please #include <dispatch/dispatch.h> instead of this file directly."
#include <dispatch/base.h> // for HeaderDoc
#endif

DISPATCH_ASSUME_NONNULL_BEGIN

__BEGIN_DECLS

/*! @header
 * Dispatch data objects describe contiguous or sparse regions of memory that
 * may be managed by the system or by the application.
 * Dispatch data objects are immutable, any direct access to memory regions
 * represented by dispatch objects must not modify that memory.
 */

/*!
 * @typedef dispatch_data_t
 * A dispatch object representing memory regions.
 */
DISPATCH_DATA_DECL(dispatch_data);

/*!
 * @var dispatch_data_empty
 * @discussion The singleton dispatch data object representing a zero-length
 * memory region.
 */
#define dispatch_data_empty \
		DISPATCH_GLOBAL_OBJECT(dispatch_data_t, _dispatch_data_empty)
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT struct dispatch_data_s _dispatch_data_empty;

/*!
 * @const DISPATCH_DATA_DESTRUCTOR_DEFAULT
 * @discussion The default destructor for dispatch data objects.
 * Used at data object creation to indicate that the supplied buffer should
 * be copied into internal storage managed by the system.
 */
#define DISPATCH_DATA_DESTRUCTOR_DEFAULT NULL

#ifdef __BLOCKS__
#if !TARGET_OS_WIN32
/*! @parseOnly */
#define DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(name) \
	DISPATCH_EXPORT const dispatch_block_t _dispatch_data_destructor_##name
#else
#define DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(name) \
	DISPATCH_EXPORT dispatch_block_t _dispatch_data_destructor_##name
#endif
#else
#define DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(name) \
	DISPATCH_EXPORT const dispatch_function_t \
	_dispatch_data_destructor_##name
#endif /* __BLOCKS__ */

/*!
 * @const DISPATCH_DATA_DESTRUCTOR_FREE
 * @discussion The destructor for dispatch data objects created from a malloc'd
 * buffer. Used at data object creation to indicate that the supplied buffer
 * was allocated by the malloc() family and should be destroyed with free(3).
 */
#define DISPATCH_DATA_DESTRUCTOR_FREE (_dispatch_data_destructor_free)
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(free);

/*!
 * @const DISPATCH_DATA_DESTRUCTOR_MUNMAP
 * @discussion The destructor for dispatch data objects that have been created
 * from buffers that require deallocation with munmap(2).
 */
#define DISPATCH_DATA_DESTRUCTOR_MUNMAP (_dispatch_data_destructor_munmap)
API_AVAILABLE(macos(10.9), ios(7.0))
DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(munmap);

#ifdef __BLOCKS__
/*!
 * @function dispatch_data_create
 * Creates a dispatch data object from the given contiguous buffer of memory. If
 * a non-default destructor is provided, ownership of the buffer remains with
 * the caller (i.e. the bytes will not be copied). The last release of the data
 * object will result in the invocation of the specified destructor on the
 * specified queue to free the buffer.
 *
 * If the DISPATCH_DATA_DESTRUCTOR_FREE destructor is provided the buffer will
 * be freed via free(3) and the queue argument ignored.
 *
 * If the DISPATCH_DATA_DESTRUCTOR_DEFAULT destructor is provided, data object
 * creation will copy the buffer into internal memory managed by the system.
 *
 * @param buffer	A contiguous buffer of data.
 * @param size		The size of the contiguous buffer of data.
 * @param queue		The queue to which the destructor should be submitted.
 * @param destructor	The destructor responsible for freeing the data when it
 *			is no longer needed.
 * @result		A newly created dispatch data object.
 */
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT DISPATCH_RETURNS_RETAINED DISPATCH_WARN_RESULT DISPATCH_NOTHROW
dispatch_data_t
dispatch_data_create(const void *buffer,
	size_t size,
	dispatch_queue_t _Nullable queue,
	dispatch_block_t _Nullable destructor);
#endif /* __BLOCKS__ */

/*!
 * @function dispatch_data_get_size
 * Returns the logical size of the memory region(s) represented by the specified
 * dispatch data object.
 *
 * @param data	The dispatch data object to query.
 * @result	The number of bytes represented by the data object.
 */
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT DISPATCH_PURE DISPATCH_NONNULL1 DISPATCH_NOTHROW
size_t
dispatch_data_get_size(dispatch_data_t data);

/*!
 * @function dispatch_data_create_map
 * Maps the memory represented by the specified dispatch data object as a single
 * contiguous memory region and returns a new data object representing it.
 * If non-NULL references to a pointer and a size variable are provided, they
 * are filled with the location and extent of that region. These allow direct
 * read access to the represented memory, but are only valid until the returned
 * object is released. Under ARC, if that object is held in a variable with
 * automatic storage, care needs to be taken to ensure that it is not released
 * by the compiler before memory access via the pointer has been completed.
 *
 * @param data		The dispatch data object to map.
 * @param buffer_ptr	A pointer to a pointer variable to be filled with the
 *			location of the mapped contiguous memory region, or
 *			NULL.
 * @param size_ptr	A pointer to a size_t variable to be filled with the
 *			size of the mapped contiguous memory region, or NULL.
 * @result		A newly created dispatch data object.
 */
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT DISPATCH_NONNULL1 DISPATCH_RETURNS_RETAINED
DISPATCH_WARN_RESULT DISPATCH_NOTHROW
dispatch_data_t
dispatch_data_create_map(dispatch_data_t data,
	const void *_Nullable *_Nullable buffer_ptr,
	size_t *_Nullable size_ptr);

/*!
 * @function dispatch_data_create_concat
 * Returns a new dispatch data object representing the concatenation of the
 * specified data objects. Those objects may be released by the application
 * after the call returns (however, the system might not deallocate the memory
 * region(s) described by them until the newly created object has also been
 * released).
 *
 * @param data1	The data object representing the region(s) of memory to place
 *		at the beginning of the newly created object.
 * @param data2	The data object representing the region(s) of memory to place
 *		at the end of the newly created object.
 * @result	A newly created object representing the concatenation of the
 *		data1 and data2 objects.
 */
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT DISPATCH_NONNULL_ALL DISPATCH_RETURNS_RETAINED
DISPATCH_WARN_RESULT DISPATCH_NOTHROW
dispatch_data_t
dispatch_data_create_concat(dispatch_data_t data1, dispatch_data_t data2);

/*!
 * @function dispatch_data_create_subrange
 * Returns a new dispatch data object representing a subrange of the specified
 * data object, which may be released by the application after the call returns
 * (however, the system might not deallocate the memory region(s) described by
 * that object until the newly created object has also been released).
 *
 * @param data		The data object representing the region(s) of memory to
 *			create a subrange of.
 * @param offset	The offset into the data object where the subrange
 *			starts.
 * @param length	The length of the range.
 * @result		A newly created object representing the specified
 *			subrange of the data object.
 */
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT DISPATCH_NONNULL1 DISPATCH_RETURNS_RETAINED
DISPATCH_WARN_RESULT DISPATCH_NOTHROW
dispatch_data_t
dispatch_data_create_subrange(dispatch_data_t data,
	size_t offset,
	size_t length);

#ifdef __BLOCKS__
/*!
 * @typedef dispatch_data_applier_t
 * A block to be invoked for every contiguous memory region in a data object.
 *
 * @param region	A data object representing the current region.
 * @param offset	The logical offset of the current region to the start
 *			of the data object.
 * @param buffer	The location of the memory for the current region.
 * @param size		The size of the memory for the current region.
 * @result		A Boolean indicating whether traversal should continue.
 */
typedef bool (^dispatch_data_applier_t)(dispatch_data_t region,
	size_t offset,
	const void *buffer,
	size_t size);

/*!
 * @function dispatch_data_apply
 * Traverse the memory regions represented by the specified dispatch data object
 * in logical order and invoke the specified block once for every contiguous
 * memory region encountered.
 *
 * Each invocation of the block is passed a data object representing the current
 * region and its logical offset, along with the memory location and extent of
 * the region. These allow direct read access to the memory region, but are only
 * valid until the passed-in region object is released. Note that the region
 * object is released by the system when the block returns, it is the
 * responsibility of the application to retain it if the region object or the
 * associated memory location are needed after the block returns.
 *
 * @param data		The data object to traverse.
 * @param applier	The block to be invoked for every contiguous memory
 *			region in the data object.
 * @result		A Boolean indicating whether traversal completed
 *			successfully.
 */
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT DISPATCH_NONNULL_ALL DISPATCH_NOTHROW
bool
dispatch_data_apply(dispatch_data_t data,
	DISPATCH_NOESCAPE dispatch_data_applier_t applier);
#endif /* __BLOCKS__ */

/*!
 * @function dispatch_data_copy_region
 * Finds the contiguous memory region containing the specified location among
 * the regions represented by the specified object and returns a copy of the
 * internal dispatch data object representing that region along with its logical
 * offset in the specified object.
 *
 * @param data		The dispatch data object to query.
 * @param location	The logical position in the data object to query.
 * @param offset_ptr	A pointer to a size_t variable to be filled with the
 *			logical offset of the returned region object to the
 *			start of the queried data object.
 * @result		A newly created dispatch data object.
 */
API_AVAILABLE(macos(10.7), ios(5.0))
DISPATCH_EXPORT DISPATCH_NONNULL1 DISPATCH_NONNULL3 DISPATCH_RETURNS_RETAINED
DISPATCH_WARN_RESULT DISPATCH_NOTHROW
dispatch_data_t
dispatch_data_copy_region(dispatch_data_t data,
	size_t location,
	size_t *offset_ptr);

__END_DECLS

DISPATCH_ASSUME_NONNULL_END

#endif /* __DISPATCH_DATA__ */
Commit	Line	Data
e85f4437	1	/*
517da941	2	* Copyright (c) 2009-2013 Apple Inc. All rights reserved.
e85f4437 A	3	*
	4	* @APPLE_APACHE_LICENSE_HEADER_START@
	5	*
	6	* Licensed under the Apache License, Version 2.0 (the "License");
	7	* you may not use this file except in compliance with the License.
	8	* You may obtain a copy of the License at
	9	*
	10	* http://www.apache.org/licenses/LICENSE-2.0
	11	*
	12	* Unless required by applicable law or agreed to in writing, software
	13	* distributed under the License is distributed on an "AS IS" BASIS,
	14	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	15	* See the License for the specific language governing permissions and
	16	* limitations under the License.
	17	*
	18	* @APPLE_APACHE_LICENSE_HEADER_END@
	19	*/
	20
	21	#ifndef __DISPATCH_DATA__
	22	#define __DISPATCH_DATA__
	23
	24	#ifndef __DISPATCH_INDIRECT__
	25	#error "Please #include <dispatch/dispatch.h> instead of this file directly."
	26	#include <dispatch/base.h> // for HeaderDoc
	27	#endif
	28
beb15981 A	29	DISPATCH_ASSUME_NONNULL_BEGIN
beb15981 A	30
e85f4437 A	31	__BEGIN_DECLS
	32
	33	/*! @header
	34	* Dispatch data objects describe contiguous or sparse regions of memory that
	35	* may be managed by the system or by the application.
	36	* Dispatch data objects are immutable, any direct access to memory regions
	37	* represented by dispatch objects must not modify that memory.
	38	*/
	39
	40	/*!
	41	* @typedef dispatch_data_t
	42	* A dispatch object representing memory regions.
	43	*/
beb15981	44	DISPATCH_DATA_DECL(dispatch_data);
e85f4437 A	45
	46	/*!
	47	* @var dispatch_data_empty
	48	* @discussion The singleton dispatch data object representing a zero-length
	49	* memory region.
	50	*/
c093abd6 A	51	#define dispatch_data_empty \
c093abd6 A	52	DISPATCH_GLOBAL_OBJECT(dispatch_data_t, _dispatch_data_empty)
6b746eb4	53	API_AVAILABLE(macos(10.7), ios(5.0))
e85f4437 A	54	DISPATCH_EXPORT struct dispatch_data_s _dispatch_data_empty;
e85f4437 A	55
e85f4437 A	56	/*!
	57	* @const DISPATCH_DATA_DESTRUCTOR_DEFAULT
	58	* @discussion The default destructor for dispatch data objects.
	59	* Used at data object creation to indicate that the supplied buffer should
	60	* be copied into internal storage managed by the system.
	61	*/
	62	#define DISPATCH_DATA_DESTRUCTOR_DEFAULT NULL
	63
517da941 A	64	#ifdef __BLOCKS__
	65	#if !TARGET_OS_WIN32
	66	/! @parseOnly /
	67	#define DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(name) \
	68	DISPATCH_EXPORT const dispatch_block_t _dispatch_data_destructor_##name
	69	#else
	70	#define DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(name) \
	71	DISPATCH_EXPORT dispatch_block_t _dispatch_data_destructor_##name
	72	#endif
	73	#else
	74	#define DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(name) \
	75	DISPATCH_EXPORT const dispatch_function_t \
	76	_dispatch_data_destructor_##name
	77	#endif /* __BLOCKS__ */
	78
e85f4437 A	79	/*!
	80	* @const DISPATCH_DATA_DESTRUCTOR_FREE
	81	* @discussion The destructor for dispatch data objects created from a malloc'd
	82	* buffer. Used at data object creation to indicate that the supplied buffer
	83	* was allocated by the malloc() family and should be destroyed with free(3).
	84	*/
	85	#define DISPATCH_DATA_DESTRUCTOR_FREE (_dispatch_data_destructor_free)
6b746eb4	86	API_AVAILABLE(macos(10.7), ios(5.0))
517da941	87	DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(free);
e85f4437	88
517da941 A	89	/*!
	90	* @const DISPATCH_DATA_DESTRUCTOR_MUNMAP
	91	* @discussion The destructor for dispatch data objects that have been created
	92	* from buffers that require deallocation with munmap(2).
	93	*/
	94	#define DISPATCH_DATA_DESTRUCTOR_MUNMAP (_dispatch_data_destructor_munmap)
6b746eb4	95	API_AVAILABLE(macos(10.9), ios(7.0))
517da941 A	96	DISPATCH_DATA_DESTRUCTOR_TYPE_DECL(munmap);
	97
	98	#ifdef __BLOCKS__
e85f4437 A	99	/*!
	100	* @function dispatch_data_create
	101	* Creates a dispatch data object from the given contiguous buffer of memory. If
	102	* a non-default destructor is provided, ownership of the buffer remains with
	103	* the caller (i.e. the bytes will not be copied). The last release of the data
	104	* object will result in the invocation of the specified destructor on the
	105	* specified queue to free the buffer.
	106	*
	107	* If the DISPATCH_DATA_DESTRUCTOR_FREE destructor is provided the buffer will
	108	* be freed via free(3) and the queue argument ignored.
	109	*
	110	* If the DISPATCH_DATA_DESTRUCTOR_DEFAULT destructor is provided, data object
	111	* creation will copy the buffer into internal memory managed by the system.
	112	*
	113	* @param buffer A contiguous buffer of data.
	114	* @param size The size of the contiguous buffer of data.
	115	* @param queue The queue to which the destructor should be submitted.
	116	* @param destructor The destructor responsible for freeing the data when it
	117	* is no longer needed.
	118	* @result A newly created dispatch data object.
	119	*/
6b746eb4	120	API_AVAILABLE(macos(10.7), ios(5.0))
c093abd6	121	DISPATCH_EXPORT DISPATCH_RETURNS_RETAINED DISPATCH_WARN_RESULT DISPATCH_NOTHROW
e85f4437 A	122	dispatch_data_t
	123	dispatch_data_create(const void *buffer,
	124	size_t size,
beb15981 A	125	dispatch_queue_t _Nullable queue,
beb15981 A	126	dispatch_block_t _Nullable destructor);
517da941	127	#endif /* __BLOCKS__ */
e85f4437 A	128
	129	/*!
	130	* @function dispatch_data_get_size
	131	* Returns the logical size of the memory region(s) represented by the specified
	132	* dispatch data object.
	133	*
	134	* @param data The dispatch data object to query.
	135	* @result The number of bytes represented by the data object.
	136	*/
6b746eb4	137	API_AVAILABLE(macos(10.7), ios(5.0))
e85f4437 A	138	DISPATCH_EXPORT DISPATCH_PURE DISPATCH_NONNULL1 DISPATCH_NOTHROW
	139	size_t
	140	dispatch_data_get_size(dispatch_data_t data);
	141
	142	/*!
	143	* @function dispatch_data_create_map
	144	* Maps the memory represented by the specified dispatch data object as a single
	145	* contiguous memory region and returns a new data object representing it.
	146	* If non-NULL references to a pointer and a size variable are provided, they
	147	* are filled with the location and extent of that region. These allow direct
c093abd6 A	148	* read access to the represented memory, but are only valid until the returned
	149	* object is released. Under ARC, if that object is held in a variable with
	150	* automatic storage, care needs to be taken to ensure that it is not released
	151	* by the compiler before memory access via the pointer has been completed.
e85f4437 A	152	*
	153	* @param data The dispatch data object to map.
	154	* @param buffer_ptr A pointer to a pointer variable to be filled with the
	155	* location of the mapped contiguous memory region, or
	156	* NULL.
	157	* @param size_ptr A pointer to a size_t variable to be filled with the
	158	* size of the mapped contiguous memory region, or NULL.
	159	* @result A newly created dispatch data object.
	160	*/
6b746eb4	161	API_AVAILABLE(macos(10.7), ios(5.0))
c093abd6 A	162	DISPATCH_EXPORT DISPATCH_NONNULL1 DISPATCH_RETURNS_RETAINED
c093abd6 A	163	DISPATCH_WARN_RESULT DISPATCH_NOTHROW
e85f4437 A	164	dispatch_data_t
e85f4437 A	165	dispatch_data_create_map(dispatch_data_t data,
beb15981 A	166	const void _Nullable _Nullable buffer_ptr,
beb15981 A	167	size_t *_Nullable size_ptr);
e85f4437 A	168
	169	/*!
	170	* @function dispatch_data_create_concat
	171	* Returns a new dispatch data object representing the concatenation of the
	172	* specified data objects. Those objects may be released by the application
	173	* after the call returns (however, the system might not deallocate the memory
	174	* region(s) described by them until the newly created object has also been
	175	* released).
	176	*
	177	* @param data1 The data object representing the region(s) of memory to place
	178	* at the beginning of the newly created object.
	179	* @param data2 The data object representing the region(s) of memory to place
	180	* at the end of the newly created object.
	181	* @result A newly created object representing the concatenation of the
	182	* data1 and data2 objects.
	183	*/
6b746eb4	184	API_AVAILABLE(macos(10.7), ios(5.0))
c093abd6 A	185	DISPATCH_EXPORT DISPATCH_NONNULL_ALL DISPATCH_RETURNS_RETAINED
c093abd6 A	186	DISPATCH_WARN_RESULT DISPATCH_NOTHROW
e85f4437 A	187	dispatch_data_t
	188	dispatch_data_create_concat(dispatch_data_t data1, dispatch_data_t data2);
	189
	190	/*!
	191	* @function dispatch_data_create_subrange
	192	* Returns a new dispatch data object representing a subrange of the specified
	193	* data object, which may be released by the application after the call returns
	194	* (however, the system might not deallocate the memory region(s) described by
	195	* that object until the newly created object has also been released).
	196	*
	197	* @param data The data object representing the region(s) of memory to
	198	* create a subrange of.
	199	* @param offset The offset into the data object where the subrange
	200	* starts.
	201	* @param length The length of the range.
	202	* @result A newly created object representing the specified
	203	* subrange of the data object.
	204	*/
6b746eb4	205	API_AVAILABLE(macos(10.7), ios(5.0))
c093abd6 A	206	DISPATCH_EXPORT DISPATCH_NONNULL1 DISPATCH_RETURNS_RETAINED
c093abd6 A	207	DISPATCH_WARN_RESULT DISPATCH_NOTHROW
e85f4437 A	208	dispatch_data_t
	209	dispatch_data_create_subrange(dispatch_data_t data,
	210	size_t offset,
	211	size_t length);
	212
517da941	213	#ifdef __BLOCKS__
e85f4437 A	214	/*!
	215	* @typedef dispatch_data_applier_t
	216	* A block to be invoked for every contiguous memory region in a data object.
	217	*
	218	* @param region A data object representing the current region.
	219	* @param offset The logical offset of the current region to the start
	220	* of the data object.
	221	* @param buffer The location of the memory for the current region.
	222	* @param size The size of the memory for the current region.
	223	* @result A Boolean indicating whether traversal should continue.
	224	*/
	225	typedef bool (^dispatch_data_applier_t)(dispatch_data_t region,
	226	size_t offset,
	227	const void *buffer,
	228	size_t size);
	229
	230	/*!
	231	* @function dispatch_data_apply
	232	* Traverse the memory regions represented by the specified dispatch data object
	233	* in logical order and invoke the specified block once for every contiguous
	234	* memory region encountered.
	235	*
	236	* Each invocation of the block is passed a data object representing the current
	237	* region and its logical offset, along with the memory location and extent of
	238	* the region. These allow direct read access to the memory region, but are only
	239	* valid until the passed-in region object is released. Note that the region
	240	* object is released by the system when the block returns, it is the
	241	* responsibility of the application to retain it if the region object or the
	242	* associated memory location are needed after the block returns.
	243	*
	244	* @param data The data object to traverse.
	245	* @param applier The block to be invoked for every contiguous memory
	246	* region in the data object.
	247	* @result A Boolean indicating whether traversal completed
	248	* successfully.
	249	*/
6b746eb4	250	API_AVAILABLE(macos(10.7), ios(5.0))
e85f4437 A	251	DISPATCH_EXPORT DISPATCH_NONNULL_ALL DISPATCH_NOTHROW
e85f4437 A	252	bool
6b746eb4 A	253	dispatch_data_apply(dispatch_data_t data,
6b746eb4 A	254	DISPATCH_NOESCAPE dispatch_data_applier_t applier);
517da941	255	#endif /* __BLOCKS__ */
e85f4437 A	256
	257	/*!
	258	* @function dispatch_data_copy_region
	259	* Finds the contiguous memory region containing the specified location among
	260	* the regions represented by the specified object and returns a copy of the
	261	* internal dispatch data object representing that region along with its logical
	262	* offset in the specified object.
	263	*
	264	* @param data The dispatch data object to query.
	265	* @param location The logical position in the data object to query.
	266	* @param offset_ptr A pointer to a size_t variable to be filled with the
	267	* logical offset of the returned region object to the
	268	* start of the queried data object.
	269	* @result A newly created dispatch data object.
	270	*/
6b746eb4	271	API_AVAILABLE(macos(10.7), ios(5.0))
c093abd6 A	272	DISPATCH_EXPORT DISPATCH_NONNULL1 DISPATCH_NONNULL3 DISPATCH_RETURNS_RETAINED
c093abd6 A	273	DISPATCH_WARN_RESULT DISPATCH_NOTHROW
e85f4437 A	274	dispatch_data_t
	275	dispatch_data_copy_region(dispatch_data_t data,
	276	size_t location,
	277	size_t *offset_ptr);
	278
e85f4437 A	279	__END_DECLS
e85f4437 A	280
beb15981 A	281	DISPATCH_ASSUME_NONNULL_END
beb15981 A	282
e85f4437	283	#endif /* __DISPATCH_DATA__ */