CoreFoundation/Base.subproj/CFAvailability.h - third_party/swift-corelibs-foundation - Git at Google

 /*	CFAvailability.h
 	Copyright (c) 2013-2016, Apple Inc. and the Swift project authors

 	Portions Copyright (c) 2014-2016 Apple Inc. and the Swift project authors
 	Licensed under Apache License v2.0 with Runtime Library Exception
 	See http://swift.org/LICENSE.txt for license information
 	See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
 */

 #if !defined(__COREFOUNDATION_CFAVAILABILITY__)
 #define __COREFOUNDATION_CFAVAILABILITY__ 1

 #if DEPLOYMENT_RUNTIME_SWIFT
 #include <CoreFoundation/TargetConditionals.h>
 #else
 #include <TargetConditionals.h>
 #endif

 #if DEPLOYMENT_RUNTIME_SWIFT
 #define API_AVAILABLE(...)
 #define API_DEPRECATED(...)
 #else
 #if (TARGET_OS_MAC || TARGET_OS_EMBEDDED || TARGET_OS_IPHONE || TARGET_OS_WIN32)
 #include <Availability.h>
 #include <os/availability.h>

 // Even if unused, these must remain here for compatibility, because projects rely on them being included.
 #include <AvailabilityMacros.h>
 #endif
 #endif

 #ifndef __has_feature
 #define __has_feature(x) 0
 #endif
 #ifndef __has_attribute
 #define __has_attribute(x) 0
 #endif
 #ifndef __has_extension
 #define __has_extension(x) 0
 #endif

 // The arguments to these availability macros is a version number, e.g. 10_6, 3_0 or 'NA'
 // To use a deprecation message with the macro, add a string as the last argument.
 #if __has_feature(attribute_availability_with_version_underscores) || (__has_feature(attribute_availability_with_message) && __clang__ && __clang_major__ >= 7)
 #if (TARGET_OS_MAC && !(TARGET_OS_EMBEDDED || TARGET_OS_IPHONE))
 // This section is for compilers targeting OS X which support attribute_availability_with_message

 #define CF_AVAILABLE(_mac, _ios) __attribute__((availability(macosx,introduced=_mac)))
 #define CF_AVAILABLE_MAC(_mac) __attribute__((availability(macosx,introduced=_mac)))
 #define CF_AVAILABLE_IOS(_ios) __attribute__((availability(macosx,unavailable)))
 #define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) __attribute__((availability(macosx,introduced=_macIntro,deprecated=_macDep,message="" __VA_ARGS__)))
 #define CF_DEPRECATED_MAC(_macIntro, _macDep, ...) __attribute__((availability(macosx,introduced=_macIntro,deprecated=_macDep,message="" __VA_ARGS__)))
 #define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __attribute__((availability(macosx,unavailable)))

 #elif (TARGET_OS_EMBEDDED || TARGET_OS_IPHONE)
 // This section is for compilers targeting iOS which support attribute_availability_with_message

 #define CF_AVAILABLE(_mac, _ios) __attribute__((availability(ios,introduced=_ios)))
 #define CF_AVAILABLE_MAC(_mac) __attribute__((availability(ios,unavailable)))
 #define CF_AVAILABLE_IOS(_ios) __attribute__((availability(ios,introduced=_ios)))
 #define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) __attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))
 #define CF_DEPRECATED_MAC(_macIntro, _macDep, ...) __attribute__((availability(ios,unavailable)))
 #define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))

 #endif

 #elif (TARGET_OS_MAC && !(TARGET_OS_EMBEDDED || TARGET_OS_IPHONE)) || (TARGET_OS_EMBEDDED || TARGET_OS_IPHONE)
 // This section is for OS X or iOS, and compilers without support for attribute_availability_with_message. We fall back to Availability.h.

 #ifndef __AVAILABILITY_INTERNAL__MAC_10_0_DEP__MAC_10_0
 #define __AVAILABILITY_INTERNAL__MAC_10_0_DEP__MAC_10_0 __AVAILABILITY_INTERNAL_DEPRECATED
 #endif

 #define CF_AVAILABLE(_mac, _ios) __OSX_AVAILABLE_STARTING(__MAC_##_mac, __IPHONE_##_ios)
 #define CF_AVAILABLE_MAC(_mac) __OSX_AVAILABLE_STARTING(__MAC_##_mac, __IPHONE_NA)
 #define CF_AVAILABLE_IOS(_ios) __OSX_AVAILABLE_STARTING(__MAC_NA, __IPHONE_##_ios)
 #define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_##_macIntro, __MAC_##_macDep, __IPHONE_##_iosIntro, __IPHONE_##_iosDep)
 #define CF_DEPRECATED_MAC(_macIntro, _macDep, ...) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_##_macIntro, __MAC_##_macDep, __IPHONE_NA, __IPHONE_NA)
 #define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA, __MAC_NA, __IPHONE_##_iosIntro, __IPHONE_##_iosDep)

 #endif // __has_feature(attribute_availability_with_message)

 #ifndef CF_AVAILABLE
 // This section is for platforms which do not support availability
 #define CF_AVAILABLE(_mac, _ios)
 #define CF_AVAILABLE_MAC(_mac)
 #define CF_AVAILABLE_IOS(_ios)
 #define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...)
 #define CF_DEPRECATED_MAC(_macIntro, _macDep, ...)
 #define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...)
 #endif

 // Older versions of these macros; use iOS versions instead
 #define CF_AVAILABLE_IPHONE(_ios) CF_AVAILABLE_IOS(_ios)
 #define CF_DEPRECATED_IPHONE(_iosIntro, _iosDep) CF_DEPRECATED_IOS(_iosIntro, _iosDep)

 // Enum availability macros
 #if __has_feature(enumerator_attributes) && __has_attribute(availability)
 #define CF_ENUM_AVAILABLE(_mac, _ios) CF_AVAILABLE(_mac, _ios)
 #define CF_ENUM_AVAILABLE_MAC(_mac) CF_AVAILABLE_MAC(_mac)
 #define CF_ENUM_AVAILABLE_IOS(_ios) CF_AVAILABLE_IOS(_ios)
 #define CF_ENUM_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, __VA_ARGS__)
 #define CF_ENUM_DEPRECATED_MAC(_macIntro, _macDep, ...) CF_DEPRECATED_MAC(_macIntro, _macDep, __VA_ARGS__)
 #define CF_ENUM_DEPRECATED_IOS(_iosIntro, _iosDep, ...) CF_DEPRECATED_IOS(_iosIntro, _iosDep, __VA_ARGS__)
 #else
 #define CF_ENUM_AVAILABLE(_mac, _ios)
 #define CF_ENUM_AVAILABLE_MAC(_mac)
 #define CF_ENUM_AVAILABLE_IOS(_ios)
 #define CF_ENUM_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...)
 #define CF_ENUM_DEPRECATED_MAC(_macIntro, _macDep, ...)
 #define CF_ENUM_DEPRECATED_IOS(_iosIntro, _iosDep, ...)
 #endif

 // Enums and Options
 #define __CF_ENUM_GET_MACRO(_1, _2, NAME, ...) NAME
 #if (__cplusplus && __cplusplus >= 201103L && (__has_extension(cxx_strong_enums) || __has_feature(objc_fixed_enum))) || (!__cplusplus && __has_feature(objc_fixed_enum))
 #define __CF_NAMED_ENUM(_type, _name)     enum _name : _type _name; enum _name : _type
 #define __CF_ANON_ENUM(_type)             enum : _type
 #if (__cplusplus)
 #define CF_OPTIONS(_type, _name) _type _name; enum : _type
 #else
 #define CF_OPTIONS(_type, _name) enum _name : _type _name; enum _name : _type
 #endif
 #else
 #define __CF_NAMED_ENUM(_type, _name) _type _name; enum
 #define __CF_ANON_ENUM(_type) enum
 #define CF_OPTIONS(_type, _name) _type _name; enum
 #endif

 /* CF_ENUM supports the use of one or two arguments. The first argument is always the integer type used for the values of the enum. The second argument is an optional type name for the macro. When specifying a type name, you must precede the macro with 'typedef' like so:

 typedef CF_ENUM(CFIndex, CFComparisonResult) {
     ...
 };

 If you do not specify a type name, do not use 'typdef', like so:

 CF_ENUM(CFIndex) {
     ...
 };
 */
 #define CF_ENUM(...) __CF_ENUM_GET_MACRO(__VA_ARGS__, __CF_NAMED_ENUM, __CF_ANON_ENUM, )(__VA_ARGS__)

 #if __has_attribute(swift_wrapper)
 #define _CF_TYPED_ENUM __attribute__((swift_wrapper(enum)))
 #else
 #define _CF_TYPED_ENUM
 #endif

 #if __has_attribute(swift_wrapper)
 #define _CF_TYPED_EXTENSIBLE_ENUM __attribute__((swift_wrapper(struct)))
 #else
 #define _CF_TYPED_EXTENSIBLE_ENUM
 #endif

 #if DEPLOYMENT_RUNTIME_SWIFT
 #define CF_STRING_ENUM
 #define CF_EXTENSIBLE_STRING_ENUM
 #else
 #define CF_STRING_ENUM _CF_TYPED_ENUM
 #define CF_EXTENSIBLE_STRING_ENUM _CF_TYPED_EXTENSIBLE_ENUM
 #endif

 // Extension availability macros
 #define CF_EXTENSION_UNAVAILABLE(_msg)      __OS_EXTENSION_UNAVAILABLE(_msg)
 #define CF_EXTENSION_UNAVAILABLE_MAC(_msg)  __OSX_EXTENSION_UNAVAILABLE(_msg)
 #define CF_EXTENSION_UNAVAILABLE_IOS(_msg)  __IOS_EXTENSION_UNAVAILABLE(_msg)

 // Swift availability macro
 #if __has_feature(attribute_availability_swift)
 #define CF_SWIFT_UNAVAILABLE(_msg) __attribute__((availability(swift, unavailable, message=_msg)))
 #else
 #define CF_SWIFT_UNAVAILABLE(_msg)
 #endif

 #endif // __COREFOUNDATION_CFAVAILABILITY__
	/* CFAvailability.h
	Copyright (c) 2013-2016, Apple Inc. and the Swift project authors

	Portions Copyright (c) 2014-2016 Apple Inc. and the Swift project authors
	Licensed under Apache License v2.0 with Runtime Library Exception
	See http://swift.org/LICENSE.txt for license information
	See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
	*/

	#if !defined(__COREFOUNDATION_CFAVAILABILITY__)
	#define __COREFOUNDATION_CFAVAILABILITY__ 1

	#if DEPLOYMENT_RUNTIME_SWIFT
	#include <CoreFoundation/TargetConditionals.h>
	#else
	#include <TargetConditionals.h>
	#endif

	#if DEPLOYMENT_RUNTIME_SWIFT
	#define API_AVAILABLE(...)
	#define API_DEPRECATED(...)
	#else
	#if (TARGET_OS_MAC \|\| TARGET_OS_EMBEDDED \|\| TARGET_OS_IPHONE \|\| TARGET_OS_WIN32)
	#include <Availability.h>
	#include <os/availability.h>

	// Even if unused, these must remain here for compatibility, because projects rely on them being included.
	#include <AvailabilityMacros.h>
	#endif
	#endif

	#ifndef __has_feature
	#define __has_feature(x) 0
	#endif
	#ifndef __has_attribute
	#define __has_attribute(x) 0
	#endif
	#ifndef __has_extension
	#define __has_extension(x) 0
	#endif

	// The arguments to these availability macros is a version number, e.g. 10_6, 3_0 or 'NA'
	// To use a deprecation message with the macro, add a string as the last argument.
	#if __has_feature(attribute_availability_with_version_underscores) \|\| (__has_feature(attribute_availability_with_message) && __clang__ && __clang_major__ >= 7)
	#if (TARGET_OS_MAC && !(TARGET_OS_EMBEDDED \|\| TARGET_OS_IPHONE))
	// This section is for compilers targeting OS X which support attribute_availability_with_message

	#define CF_AVAILABLE(_mac, _ios) __attribute__((availability(macosx,introduced=_mac)))
	#define CF_AVAILABLE_MAC(_mac) __attribute__((availability(macosx,introduced=_mac)))
	#define CF_AVAILABLE_IOS(_ios) __attribute__((availability(macosx,unavailable)))
	#define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) __attribute__((availability(macosx,introduced=_macIntro,deprecated=_macDep,message="" __VA_ARGS__)))
	#define CF_DEPRECATED_MAC(_macIntro, _macDep, ...) __attribute__((availability(macosx,introduced=_macIntro,deprecated=_macDep,message="" __VA_ARGS__)))
	#define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __attribute__((availability(macosx,unavailable)))

	#elif (TARGET_OS_EMBEDDED \|\| TARGET_OS_IPHONE)
	// This section is for compilers targeting iOS which support attribute_availability_with_message

	#define CF_AVAILABLE(_mac, _ios) __attribute__((availability(ios,introduced=_ios)))
	#define CF_AVAILABLE_MAC(_mac) __attribute__((availability(ios,unavailable)))
	#define CF_AVAILABLE_IOS(_ios) __attribute__((availability(ios,introduced=_ios)))
	#define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) __attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))
	#define CF_DEPRECATED_MAC(_macIntro, _macDep, ...) __attribute__((availability(ios,unavailable)))
	#define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))

	#endif

	#elif (TARGET_OS_MAC && !(TARGET_OS_EMBEDDED \|\| TARGET_OS_IPHONE)) \|\| (TARGET_OS_EMBEDDED \|\| TARGET_OS_IPHONE)
	// This section is for OS X or iOS, and compilers without support for attribute_availability_with_message. We fall back to Availability.h.

	#ifndef __AVAILABILITY_INTERNAL__MAC_10_0_DEP__MAC_10_0
	#define __AVAILABILITY_INTERNAL__MAC_10_0_DEP__MAC_10_0 __AVAILABILITY_INTERNAL_DEPRECATED
	#endif

	#define CF_AVAILABLE(_mac, _ios) __OSX_AVAILABLE_STARTING(__MAC_##_mac, __IPHONE_##_ios)
	#define CF_AVAILABLE_MAC(_mac) __OSX_AVAILABLE_STARTING(__MAC_##_mac, __IPHONE_NA)
	#define CF_AVAILABLE_IOS(_ios) __OSX_AVAILABLE_STARTING(__MAC_NA, __IPHONE_##_ios)
	#define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_##_macIntro, __MAC_##_macDep, __IPHONE_##_iosIntro, __IPHONE_##_iosDep)
	#define CF_DEPRECATED_MAC(_macIntro, _macDep, ...) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_##_macIntro, __MAC_##_macDep, __IPHONE_NA, __IPHONE_NA)
	#define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA, __MAC_NA, __IPHONE_##_iosIntro, __IPHONE_##_iosDep)

	#endif // __has_feature(attribute_availability_with_message)

	#ifndef CF_AVAILABLE
	// This section is for platforms which do not support availability
	#define CF_AVAILABLE(_mac, _ios)
	#define CF_AVAILABLE_MAC(_mac)
	#define CF_AVAILABLE_IOS(_ios)
	#define CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...)
	#define CF_DEPRECATED_MAC(_macIntro, _macDep, ...)
	#define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...)
	#endif

	// Older versions of these macros; use iOS versions instead
	#define CF_AVAILABLE_IPHONE(_ios) CF_AVAILABLE_IOS(_ios)
	#define CF_DEPRECATED_IPHONE(_iosIntro, _iosDep) CF_DEPRECATED_IOS(_iosIntro, _iosDep)

	// Enum availability macros
	#if __has_feature(enumerator_attributes) && __has_attribute(availability)
	#define CF_ENUM_AVAILABLE(_mac, _ios) CF_AVAILABLE(_mac, _ios)
	#define CF_ENUM_AVAILABLE_MAC(_mac) CF_AVAILABLE_MAC(_mac)
	#define CF_ENUM_AVAILABLE_IOS(_ios) CF_AVAILABLE_IOS(_ios)
	#define CF_ENUM_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...) CF_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, __VA_ARGS__)
	#define CF_ENUM_DEPRECATED_MAC(_macIntro, _macDep, ...) CF_DEPRECATED_MAC(_macIntro, _macDep, __VA_ARGS__)
	#define CF_ENUM_DEPRECATED_IOS(_iosIntro, _iosDep, ...) CF_DEPRECATED_IOS(_iosIntro, _iosDep, __VA_ARGS__)
	#else
	#define CF_ENUM_AVAILABLE(_mac, _ios)
	#define CF_ENUM_AVAILABLE_MAC(_mac)
	#define CF_ENUM_AVAILABLE_IOS(_ios)
	#define CF_ENUM_DEPRECATED(_macIntro, _macDep, _iosIntro, _iosDep, ...)
	#define CF_ENUM_DEPRECATED_MAC(_macIntro, _macDep, ...)
	#define CF_ENUM_DEPRECATED_IOS(_iosIntro, _iosDep, ...)
	#endif

	// Enums and Options
	#define __CF_ENUM_GET_MACRO(_1, _2, NAME, ...) NAME
	#if (__cplusplus && __cplusplus >= 201103L && (__has_extension(cxx_strong_enums) \|\| __has_feature(objc_fixed_enum))) \|\| (!__cplusplus && __has_feature(objc_fixed_enum))
	#define __CF_NAMED_ENUM(_type, _name) enum _name : _type _name; enum _name : _type
	#define __CF_ANON_ENUM(_type) enum : _type
	#if (__cplusplus)
	#define CF_OPTIONS(_type, _name) _type _name; enum : _type
	#else
	#define CF_OPTIONS(_type, _name) enum _name : _type _name; enum _name : _type
	#endif
	#else
	#define __CF_NAMED_ENUM(_type, _name) _type _name; enum
	#define __CF_ANON_ENUM(_type) enum
	#define CF_OPTIONS(_type, _name) _type _name; enum
	#endif

	/* CF_ENUM supports the use of one or two arguments. The first argument is always the integer type used for the values of the enum. The second argument is an optional type name for the macro. When specifying a type name, you must precede the macro with 'typedef' like so:

	typedef CF_ENUM(CFIndex, CFComparisonResult) {
	...
	};

	If you do not specify a type name, do not use 'typdef', like so:

	CF_ENUM(CFIndex) {
	...
	};
	*/
	#define CF_ENUM(...) __CF_ENUM_GET_MACRO(__VA_ARGS__, __CF_NAMED_ENUM, __CF_ANON_ENUM, )(__VA_ARGS__)

	#if __has_attribute(swift_wrapper)
	#define _CF_TYPED_ENUM __attribute__((swift_wrapper(enum)))
	#else
	#define _CF_TYPED_ENUM
	#endif

	#if __has_attribute(swift_wrapper)
	#define _CF_TYPED_EXTENSIBLE_ENUM __attribute__((swift_wrapper(struct)))
	#else
	#define _CF_TYPED_EXTENSIBLE_ENUM
	#endif

	#if DEPLOYMENT_RUNTIME_SWIFT
	#define CF_STRING_ENUM
	#define CF_EXTENSIBLE_STRING_ENUM
	#else
	#define CF_STRING_ENUM _CF_TYPED_ENUM
	#define CF_EXTENSIBLE_STRING_ENUM _CF_TYPED_EXTENSIBLE_ENUM
	#endif

	// Extension availability macros
	#define CF_EXTENSION_UNAVAILABLE(_msg) __OS_EXTENSION_UNAVAILABLE(_msg)
	#define CF_EXTENSION_UNAVAILABLE_MAC(_msg) __OSX_EXTENSION_UNAVAILABLE(_msg)
	#define CF_EXTENSION_UNAVAILABLE_IOS(_msg) __IOS_EXTENSION_UNAVAILABLE(_msg)

	// Swift availability macro
	#if __has_feature(attribute_availability_swift)
	#define CF_SWIFT_UNAVAILABLE(_msg) __attribute__((availability(swift, unavailable, message=_msg)))
	#else
	#define CF_SWIFT_UNAVAILABLE(_msg)
	#endif

	#endif // __COREFOUNDATION_CFAVAILABILITY__