[apple/libdispatch.git] / os / object.h

/*
 * Copyright (c) 2011-2014 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 __OS_OBJECT__
#define __OS_OBJECT__

#ifdef __APPLE__
#include <Availability.h>
#include <os/availability.h>
#include <TargetConditionals.h>
#include <os/base.h>
#elif defined(__linux__)
#include <os/linux_base.h>
#endif

/*!
 * @header
 *
 * @preprocinfo
 * By default, libSystem objects such as GCD and XPC objects are declared as
 * Objective-C types when building with an Objective-C compiler. This allows
 * them to participate in ARC, in RR management by the Blocks runtime and in
 * leaks checking by the static analyzer, and enables them to be added to Cocoa
 * collections.
 *
 * NOTE: this requires explicit cancellation of dispatch sources and xpc
 *       connections whose handler blocks capture the source/connection object,
 *       resp. ensuring that such captures do not form retain cycles (e.g. by
 *       declaring the source as __weak).
 *
 * To opt-out of this default behavior, add -DOS_OBJECT_USE_OBJC=0 to your
 * compiler flags.
 *
 * This mode requires a platform with the modern Objective-C runtime, the
 * Objective-C GC compiler option to be disabled, and at least a Mac OS X 10.8
 * or iOS 6.0 deployment target.
 */

#ifndef OS_OBJECT_HAVE_OBJC_SUPPORT
#if !defined(__OBJC__) || defined(__OBJC_GC__)
#  define OS_OBJECT_HAVE_OBJC_SUPPORT 0
#elif !defined(TARGET_OS_MAC) || !TARGET_OS_MAC
#  define OS_OBJECT_HAVE_OBJC_SUPPORT 0
#elif TARGET_OS_IOS && __IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_6_0
#  define OS_OBJECT_HAVE_OBJC_SUPPORT 0
#elif TARGET_OS_MAC && !TARGET_OS_IPHONE
#  if __MAC_OS_X_VERSION_MIN_REQUIRED < __MAC_10_8
#  define OS_OBJECT_HAVE_OBJC_SUPPORT 0
#  elif defined(__i386__) && __MAC_OS_X_VERSION_MIN_REQUIRED < __MAC_10_12
#  define OS_OBJECT_HAVE_OBJC_SUPPORT 0
#  else
#  define OS_OBJECT_HAVE_OBJC_SUPPORT 1
#  endif
#else
#  define OS_OBJECT_HAVE_OBJC_SUPPORT 1
#endif
#endif // OS_OBJECT_HAVE_OBJC_SUPPORT

#if OS_OBJECT_HAVE_OBJC_SUPPORT
#if defined(__swift__) && __swift__ && !OS_OBJECT_USE_OBJC
#define OS_OBJECT_USE_OBJC 1
#endif
#ifndef OS_OBJECT_USE_OBJC
#define OS_OBJECT_USE_OBJC 1
#endif
#elif defined(OS_OBJECT_USE_OBJC) && OS_OBJECT_USE_OBJC
/* Unsupported platform for OS_OBJECT_USE_OBJC=1 */
#undef OS_OBJECT_USE_OBJC
#define OS_OBJECT_USE_OBJC 0
#else
#define OS_OBJECT_USE_OBJC 0
#endif

#ifndef OS_OBJECT_SWIFT3
#if defined(SWIFT_SDK_OVERLAY_DISPATCH_EPOCH) && \
		SWIFT_SDK_OVERLAY_DISPATCH_EPOCH >= 2
#define OS_OBJECT_SWIFT3 1
#else
#define OS_OBJECT_SWIFT3 0
#endif // SWIFT_SDK_OVERLAY_DISPATCH_EPOCH >= 2
#endif // OS_OBJECT_SWIFT3

#if OS_OBJECT_USE_OBJC
#import <objc/NSObject.h>
#if __has_attribute(objc_independent_class)
#define OS_OBJC_INDEPENDENT_CLASS __attribute__((objc_independent_class))
#endif // __has_attribute(objc_independent_class)
#ifndef OS_OBJC_INDEPENDENT_CLASS
#define OS_OBJC_INDEPENDENT_CLASS
#endif
#define OS_OBJECT_CLASS(name) OS_##name
#define OS_OBJECT_DECL_PROTOCOL(name, ...) \
		@protocol OS_OBJECT_CLASS(name) __VA_ARGS__ \
		@end
#define OS_OBJECT_CLASS_IMPLEMENTS_PROTOCOL_IMPL(name, proto) \
		@interface name () <proto> \
		@end
#define OS_OBJECT_CLASS_IMPLEMENTS_PROTOCOL(name, proto) \
		OS_OBJECT_CLASS_IMPLEMENTS_PROTOCOL_IMPL( \
				OS_OBJECT_CLASS(name), OS_OBJECT_CLASS(proto))
#define OS_OBJECT_DECL_IMPL(name, ...) \
		OS_OBJECT_DECL_PROTOCOL(name, __VA_ARGS__) \
		typedef NSObject<OS_OBJECT_CLASS(name)> \
				* OS_OBJC_INDEPENDENT_CLASS name##_t
#define OS_OBJECT_DECL_BASE(name, ...) \
		@interface OS_OBJECT_CLASS(name) : __VA_ARGS__ \
		- (instancetype)init OS_SWIFT_UNAVAILABLE("Unavailable in Swift"); \
		@end
#define OS_OBJECT_DECL_IMPL_CLASS(name, ...) \
		OS_OBJECT_DECL_BASE(name, ## __VA_ARGS__) \
		typedef OS_OBJECT_CLASS(name) \
				* OS_OBJC_INDEPENDENT_CLASS name##_t
#define OS_OBJECT_DECL(name, ...) \
		OS_OBJECT_DECL_IMPL(name, <NSObject>)
#define OS_OBJECT_DECL_SUBCLASS(name, super) \
		OS_OBJECT_DECL_IMPL(name, <OS_OBJECT_CLASS(super)>)
#if __has_attribute(ns_returns_retained)
#define OS_OBJECT_RETURNS_RETAINED __attribute__((__ns_returns_retained__))
#else
#define OS_OBJECT_RETURNS_RETAINED
#endif
#if __has_attribute(ns_consumed)
#define OS_OBJECT_CONSUMED __attribute__((__ns_consumed__))
#else
#define OS_OBJECT_CONSUMED
#endif
#if __has_feature(objc_arc)
#define OS_OBJECT_BRIDGE __bridge
#define OS_WARN_RESULT_NEEDS_RELEASE
#else
#define OS_OBJECT_BRIDGE
#define OS_WARN_RESULT_NEEDS_RELEASE OS_WARN_RESULT
#endif
#if __has_attribute(objc_runtime_visible) && \
		((defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && \
		__MAC_OS_X_VERSION_MIN_REQUIRED < __MAC_10_12) || \
		(defined(__IPHONE_OS_VERSION_MIN_REQUIRED) && \
		!defined(__TV_OS_VERSION_MIN_REQUIRED) && \
		!defined(__WATCH_OS_VERSION_MIN_REQUIRED) && \
		__IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_10_0) || \
		(defined(__TV_OS_VERSION_MIN_REQUIRED) && \
		__TV_OS_VERSION_MIN_REQUIRED < __TVOS_10_0) || \
		(defined(__WATCH_OS_VERSION_MIN_REQUIRED) && \
		__WATCH_OS_VERSION_MIN_REQUIRED < __WATCHOS_3_0))
/*
 * To provide backward deployment of ObjC objects in Swift on pre-10.12
 * SDKs, OS_object classes can be marked as OS_OBJECT_OBJC_RUNTIME_VISIBLE.
 * When compiling with a deployment target earlier than OS X 10.12 (iOS 10.0, 
 * tvOS 10.0, watchOS 3.0) the Swift compiler will only refer to this type at
 * runtime (using the ObjC runtime).
 */
#define OS_OBJECT_OBJC_RUNTIME_VISIBLE __attribute__((objc_runtime_visible))
#else
#define OS_OBJECT_OBJC_RUNTIME_VISIBLE
#endif
#ifndef OS_OBJECT_USE_OBJC_RETAIN_RELEASE
#if defined(__clang_analyzer__)
#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 1
#elif __has_feature(objc_arc) && !OS_OBJECT_SWIFT3
#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 1
#else
#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 0
#endif
#endif
#if OS_OBJECT_SWIFT3
#define OS_OBJECT_DECL_SWIFT(name) \
		OS_EXPORT OS_OBJECT_OBJC_RUNTIME_VISIBLE \
		OS_OBJECT_DECL_IMPL_CLASS(name, NSObject)
#define OS_OBJECT_DECL_SUBCLASS_SWIFT(name, super) \
		OS_EXPORT OS_OBJECT_OBJC_RUNTIME_VISIBLE \
		OS_OBJECT_DECL_IMPL_CLASS(name, OS_OBJECT_CLASS(super))
OS_EXPORT OS_OBJECT_OBJC_RUNTIME_VISIBLE
OS_OBJECT_DECL_BASE(object, NSObject);
#endif // OS_OBJECT_SWIFT3
#else
/*! @parseOnly */
#define OS_OBJECT_RETURNS_RETAINED
/*! @parseOnly */
#define OS_OBJECT_CONSUMED
/*! @parseOnly */
#define OS_OBJECT_BRIDGE
/*! @parseOnly */
#define OS_WARN_RESULT_NEEDS_RELEASE OS_WARN_RESULT
/*! @parseOnly */
#define OS_OBJECT_OBJC_RUNTIME_VISIBLE
#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 0
#endif

#if OS_OBJECT_SWIFT3
#define OS_OBJECT_DECL_CLASS(name) \
		OS_OBJECT_DECL_SUBCLASS_SWIFT(name, object)
#elif OS_OBJECT_USE_OBJC
#define OS_OBJECT_DECL_CLASS(name) \
		OS_OBJECT_DECL(name)
#else
#define OS_OBJECT_DECL_CLASS(name) \
		typedef struct name##_s *name##_t
#endif

#define OS_OBJECT_GLOBAL_OBJECT(type, object) ((OS_OBJECT_BRIDGE type)&(object))

__BEGIN_DECLS

/*!
 * @function os_retain
 *
 * @abstract
 * Increment the reference count of an os_object.
 *
 * @discussion
 * On a platform with the modern Objective-C runtime this is exactly equivalent
 * to sending the object the -[retain] message.
 *
 * @param object
 * The object to retain.
 *
 * @result
 * The retained object.
 */
API_AVAILABLE(macos(10.10), ios(8.0))
OS_EXPORT OS_SWIFT_UNAVAILABLE("Can't be used with ARC")
void*
os_retain(void *object);
#if OS_OBJECT_USE_OBJC
#undef os_retain
#define os_retain(object) [object retain]
#endif

/*!
 * @function os_release
 *
 * @abstract
 * Decrement the reference count of a os_object.
 *
 * @discussion
 * On a platform with the modern Objective-C runtime this is exactly equivalent
 * to sending the object the -[release] message.
 *
 * @param object
 * The object to release.
 */
API_AVAILABLE(macos(10.10), ios(8.0))
OS_EXPORT
void OS_SWIFT_UNAVAILABLE("Can't be used with ARC")
os_release(void *object);
#if OS_OBJECT_USE_OBJC
#undef os_release
#define os_release(object) [object release]
#endif

__END_DECLS

#endif
Commit	Line	Data
c093abd6	1	/*
98cf8cd2	2	* Copyright (c) 2011-2014 Apple Inc. All rights reserved.
c093abd6 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 __OS_OBJECT__
	22	#define __OS_OBJECT__
	23
	24	#ifdef __APPLE__
	25	#include <Availability.h>
6b746eb4	26	#include <os/availability.h>
beb15981	27	#include <TargetConditionals.h>
98cf8cd2	28	#include <os/base.h>
6b746eb4	29	#elif defined(__linux__)
beb15981 A	30	#include <os/linux_base.h>
beb15981 A	31	#endif
c093abd6 A	32
	33	/*!
	34	* @header
	35	*
	36	* @preprocinfo
	37	* By default, libSystem objects such as GCD and XPC objects are declared as
	38	* Objective-C types when building with an Objective-C compiler. This allows
	39	* them to participate in ARC, in RR management by the Blocks runtime and in
	40	* leaks checking by the static analyzer, and enables them to be added to Cocoa
	41	* collections.
	42	*
	43	* NOTE: this requires explicit cancellation of dispatch sources and xpc
	44	* connections whose handler blocks capture the source/connection object,
	45	* resp. ensuring that such captures do not form retain cycles (e.g. by
	46	* declaring the source as __weak).
	47	*
	48	* To opt-out of this default behavior, add -DOS_OBJECT_USE_OBJC=0 to your
	49	* compiler flags.
	50	*
	51	* This mode requires a platform with the modern Objective-C runtime, the
	52	* Objective-C GC compiler option to be disabled, and at least a Mac OS X 10.8
517da941	53	* or iOS 6.0 deployment target.
c093abd6 A	54	*/
	55
	56	#ifndef OS_OBJECT_HAVE_OBJC_SUPPORT
beb15981 A	57	#if !defined(__OBJC__) \|\| defined(__OBJC_GC__)
	58	# define OS_OBJECT_HAVE_OBJC_SUPPORT 0
	59	#elif !defined(TARGET_OS_MAC) \|\| !TARGET_OS_MAC
	60	# define OS_OBJECT_HAVE_OBJC_SUPPORT 0
	61	#elif TARGET_OS_IOS && __IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_6_0
	62	# define OS_OBJECT_HAVE_OBJC_SUPPORT 0
	63	#elif TARGET_OS_MAC && !TARGET_OS_IPHONE
	64	# if __MAC_OS_X_VERSION_MIN_REQUIRED < __MAC_10_8
	65	# define OS_OBJECT_HAVE_OBJC_SUPPORT 0
	66	# elif defined(__i386__) && __MAC_OS_X_VERSION_MIN_REQUIRED < __MAC_10_12
	67	# define OS_OBJECT_HAVE_OBJC_SUPPORT 0
	68	# else
	69	# define OS_OBJECT_HAVE_OBJC_SUPPORT 1
	70	# endif
c093abd6	71	#else
beb15981	72	# define OS_OBJECT_HAVE_OBJC_SUPPORT 1
c093abd6	73	#endif
beb15981	74	#endif // OS_OBJECT_HAVE_OBJC_SUPPORT
c093abd6 A	75
c093abd6 A	76	#if OS_OBJECT_HAVE_OBJC_SUPPORT
6b746eb4 A	77	#if defined(__swift__) && __swift__ && !OS_OBJECT_USE_OBJC
	78	#define OS_OBJECT_USE_OBJC 1
	79	#endif
c093abd6 A	80	#ifndef OS_OBJECT_USE_OBJC
	81	#define OS_OBJECT_USE_OBJC 1
	82	#endif
	83	#elif defined(OS_OBJECT_USE_OBJC) && OS_OBJECT_USE_OBJC
	84	/* Unsupported platform for OS_OBJECT_USE_OBJC=1 */
	85	#undef OS_OBJECT_USE_OBJC
	86	#define OS_OBJECT_USE_OBJC 0
	87	#else
	88	#define OS_OBJECT_USE_OBJC 0
	89	#endif
	90
beb15981 A	91	#ifndef OS_OBJECT_SWIFT3
	92	#if defined(SWIFT_SDK_OVERLAY_DISPATCH_EPOCH) && \
	93	SWIFT_SDK_OVERLAY_DISPATCH_EPOCH >= 2
	94	#define OS_OBJECT_SWIFT3 1
	95	#else
	96	#define OS_OBJECT_SWIFT3 0
	97	#endif // SWIFT_SDK_OVERLAY_DISPATCH_EPOCH >= 2
	98	#endif // OS_OBJECT_SWIFT3
	99
c093abd6	100	#if OS_OBJECT_USE_OBJC
517da941	101	#import <objc/NSObject.h>
beb15981 A	102	#if __has_attribute(objc_independent_class)
	103	#define OS_OBJC_INDEPENDENT_CLASS __attribute__((objc_independent_class))
	104	#endif // __has_attribute(objc_independent_class)
	105	#ifndef OS_OBJC_INDEPENDENT_CLASS
	106	#define OS_OBJC_INDEPENDENT_CLASS
	107	#endif
c093abd6	108	#define OS_OBJECT_CLASS(name) OS_##name
beb15981	109	#define OS_OBJECT_DECL_PROTOCOL(name, ...) \
c093abd6	110	@protocol OS_OBJECT_CLASS(name) __VA_ARGS__ \
beb15981 A	111	@end
	112	#define OS_OBJECT_CLASS_IMPLEMENTS_PROTOCOL_IMPL(name, proto) \
	113	@interface name () <proto> \
	114	@end
	115	#define OS_OBJECT_CLASS_IMPLEMENTS_PROTOCOL(name, proto) \
	116	OS_OBJECT_CLASS_IMPLEMENTS_PROTOCOL_IMPL( \
	117	OS_OBJECT_CLASS(name), OS_OBJECT_CLASS(proto))
	118	#define OS_OBJECT_DECL_IMPL(name, ...) \
	119	OS_OBJECT_DECL_PROTOCOL(name, __VA_ARGS__) \
	120	typedef NSObject<OS_OBJECT_CLASS(name)> \
	121	* OS_OBJC_INDEPENDENT_CLASS name##_t
	122	#define OS_OBJECT_DECL_BASE(name, ...) \
	123	@interface OS_OBJECT_CLASS(name) : __VA_ARGS__ \
	124	- (instancetype)init OS_SWIFT_UNAVAILABLE("Unavailable in Swift"); \
	125	@end
	126	#define OS_OBJECT_DECL_IMPL_CLASS(name, ...) \
	127	OS_OBJECT_DECL_BASE(name, ## __VA_ARGS__) \
	128	typedef OS_OBJECT_CLASS(name) \
	129	* OS_OBJC_INDEPENDENT_CLASS name##_t
45201a42	130	#define OS_OBJECT_DECL(name, ...) \
beb15981	131	OS_OBJECT_DECL_IMPL(name, <NSObject>)
c093abd6	132	#define OS_OBJECT_DECL_SUBCLASS(name, super) \
45201a42	133	OS_OBJECT_DECL_IMPL(name, <OS_OBJECT_CLASS(super)>)
517da941	134	#if __has_attribute(ns_returns_retained)
c093abd6 A	135	#define OS_OBJECT_RETURNS_RETAINED __attribute__((__ns_returns_retained__))
	136	#else
	137	#define OS_OBJECT_RETURNS_RETAINED
	138	#endif
98cf8cd2 A	139	#if __has_attribute(ns_consumed)
	140	#define OS_OBJECT_CONSUMED __attribute__((__ns_consumed__))
	141	#else
	142	#define OS_OBJECT_CONSUMED
	143	#endif
517da941	144	#if __has_feature(objc_arc)
c093abd6	145	#define OS_OBJECT_BRIDGE __bridge
98cf8cd2	146	#define OS_WARN_RESULT_NEEDS_RELEASE
c093abd6 A	147	#else
c093abd6 A	148	#define OS_OBJECT_BRIDGE
98cf8cd2	149	#define OS_WARN_RESULT_NEEDS_RELEASE OS_WARN_RESULT
c093abd6	150	#endif
beb15981 A	151	#if __has_attribute(objc_runtime_visible) && \
	152	((defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && \
	153	__MAC_OS_X_VERSION_MIN_REQUIRED < __MAC_10_12) \|\| \
	154	(defined(__IPHONE_OS_VERSION_MIN_REQUIRED) && \
	155	!defined(__TV_OS_VERSION_MIN_REQUIRED) && \
	156	!defined(__WATCH_OS_VERSION_MIN_REQUIRED) && \
	157	__IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_10_0) \|\| \
	158	(defined(__TV_OS_VERSION_MIN_REQUIRED) && \
	159	__TV_OS_VERSION_MIN_REQUIRED < __TVOS_10_0) \|\| \
	160	(defined(__WATCH_OS_VERSION_MIN_REQUIRED) && \
	161	__WATCH_OS_VERSION_MIN_REQUIRED < __WATCHOS_3_0))
	162	/*
	163	* To provide backward deployment of ObjC objects in Swift on pre-10.12
	164	* SDKs, OS_object classes can be marked as OS_OBJECT_OBJC_RUNTIME_VISIBLE.
	165	* When compiling with a deployment target earlier than OS X 10.12 (iOS 10.0,
	166	* tvOS 10.0, watchOS 3.0) the Swift compiler will only refer to this type at
	167	* runtime (using the ObjC runtime).
	168	*/
	169	#define OS_OBJECT_OBJC_RUNTIME_VISIBLE __attribute__((objc_runtime_visible))
517da941	170	#else
beb15981	171	#define OS_OBJECT_OBJC_RUNTIME_VISIBLE
517da941	172	#endif
c093abd6	173	#ifndef OS_OBJECT_USE_OBJC_RETAIN_RELEASE
517da941 A	174	#if defined(__clang_analyzer__)
517da941 A	175	#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 1
beb15981	176	#elif __has_feature(objc_arc) && !OS_OBJECT_SWIFT3
c093abd6 A	177	#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 1
	178	#else
	179	#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 0
	180	#endif
	181	#endif
beb15981 A	182	#if OS_OBJECT_SWIFT3
	183	#define OS_OBJECT_DECL_SWIFT(name) \
	184	OS_EXPORT OS_OBJECT_OBJC_RUNTIME_VISIBLE \
	185	OS_OBJECT_DECL_IMPL_CLASS(name, NSObject)
	186	#define OS_OBJECT_DECL_SUBCLASS_SWIFT(name, super) \
	187	OS_EXPORT OS_OBJECT_OBJC_RUNTIME_VISIBLE \
	188	OS_OBJECT_DECL_IMPL_CLASS(name, OS_OBJECT_CLASS(super))
	189	OS_EXPORT OS_OBJECT_OBJC_RUNTIME_VISIBLE
	190	OS_OBJECT_DECL_BASE(object, NSObject);
	191	#endif // OS_OBJECT_SWIFT3
c093abd6 A	192	#else
	193	/! @parseOnly /
	194	#define OS_OBJECT_RETURNS_RETAINED
	195	/! @parseOnly /
98cf8cd2 A	196	#define OS_OBJECT_CONSUMED
98cf8cd2 A	197	/! @parseOnly /
c093abd6	198	#define OS_OBJECT_BRIDGE
98cf8cd2 A	199	/! @parseOnly /
98cf8cd2 A	200	#define OS_WARN_RESULT_NEEDS_RELEASE OS_WARN_RESULT
beb15981 A	201	/! @parseOnly /
beb15981 A	202	#define OS_OBJECT_OBJC_RUNTIME_VISIBLE
c093abd6 A	203	#define OS_OBJECT_USE_OBJC_RETAIN_RELEASE 0
	204	#endif
	205
beb15981 A	206	#if OS_OBJECT_SWIFT3
	207	#define OS_OBJECT_DECL_CLASS(name) \
	208	OS_OBJECT_DECL_SUBCLASS_SWIFT(name, object)
	209	#elif OS_OBJECT_USE_OBJC
	210	#define OS_OBJECT_DECL_CLASS(name) \
	211	OS_OBJECT_DECL(name)
	212	#else
	213	#define OS_OBJECT_DECL_CLASS(name) \
	214	typedef struct name##_s *name##_t
	215	#endif
	216
98cf8cd2 A	217	#define OS_OBJECT_GLOBAL_OBJECT(type, object) ((OS_OBJECT_BRIDGE type)&(object))
	218
	219	__BEGIN_DECLS
	220
	221	/*!
	222	* @function os_retain
	223	*
	224	* @abstract
	225	* Increment the reference count of an os_object.
	226	*
	227	* @discussion
	228	* On a platform with the modern Objective-C runtime this is exactly equivalent
	229	* to sending the object the -[retain] message.
	230	*
	231	* @param object
	232	* The object to retain.
	233	*
	234	* @result
	235	* The retained object.
	236	*/
6b746eb4	237	API_AVAILABLE(macos(10.10), ios(8.0))
beb15981	238	OS_EXPORT OS_SWIFT_UNAVAILABLE("Can't be used with ARC")
98cf8cd2 A	239	void*
	240	os_retain(void *object);
	241	#if OS_OBJECT_USE_OBJC
	242	#undef os_retain
	243	#define os_retain(object) [object retain]
	244	#endif
	245
	246	/*!
	247	* @function os_release
	248	*
	249	* @abstract
	250	* Decrement the reference count of a os_object.
	251	*
	252	* @discussion
	253	* On a platform with the modern Objective-C runtime this is exactly equivalent
	254	* to sending the object the -[release] message.
	255	*
	256	* @param object
	257	* The object to release.
	258	*/
6b746eb4	259	API_AVAILABLE(macos(10.10), ios(8.0))
98cf8cd2	260	OS_EXPORT
beb15981	261	void OS_SWIFT_UNAVAILABLE("Can't be used with ARC")
98cf8cd2 A	262	os_release(void *object);
	263	#if OS_OBJECT_USE_OBJC
	264	#undef os_release
	265	#define os_release(object) [object release]
	266	#endif
	267
	268	__END_DECLS
	269
c093abd6	270	#endif