Implement a new 'availability' attribute, that allows one to specify
which versions of an OS provide a certain facility. For example,
void foo()
__attribute__((availability(macosx,introduced=10.2,deprecated=10.4,obsoleted=10.6)));
says that the function "foo" was introduced in 10.2, deprecated in
10.4, and completely obsoleted in 10.6. This attribute ties in with
the deployment targets (e.g., -mmacosx-version-min=10.1 specifies that
we want to deploy back to Mac OS X 10.1). There are several concrete
behaviors that this attribute enables, as illustrated with the
function foo() above:
- If we choose a deployment target >= Mac OS X 10.4, uses of "foo"
will result in a deprecation warning, as if we had placed
attribute((deprecated)) on it (but with a better diagnostic)
- If we choose a deployment target >= Mac OS X 10.6, uses of "foo"
will result in an "unavailable" warning (in C)/error (in C++), as
if we had placed attribute((unavailable)) on it
- If we choose a deployment target prior to 10.2, foo() is
weak-imported (if it is a kind of entity that can be weak
imported), as if we had placed the weak_import attribute on it.
Naturally, there can be multiple availability attributes on a
declaration, for different platforms; only the current platform
matters when checking availability attributes.
The only platforms this attribute currently works for are "ios" and
"macosx", since we already have -mxxxx-version-min flags for them and we
have experience there with macro tricks translating down to the
deprecated/unavailable/weak_import attributes. The end goal is to open
this up to other platforms, and even extension to other "platforms"
that are really libraries (say, through a #pragma clang
define_system), but that hasn't yet been designed and we may want to
shake out more issues with this narrower problem first.
Addresses <rdar://problem/6690412>.
As a drive-by bug-fix, if an entity is both deprecated and
unavailable, we only emit the "unavailable" diagnostic.
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@128127 91177308-0d34-0410-b5e6-96231b3b80d8
2011-03-23 03:50:03 +03:00
// RUN: %clang_cc1 -fsyntax-only -verify %s
2011-03-26 15:16:15 +03:00
# if !__has_feature(attribute_availability)
# error 'availability' attribute is not available
# endif
Implement a new 'availability' attribute, that allows one to specify
which versions of an OS provide a certain facility. For example,
void foo()
__attribute__((availability(macosx,introduced=10.2,deprecated=10.4,obsoleted=10.6)));
says that the function "foo" was introduced in 10.2, deprecated in
10.4, and completely obsoleted in 10.6. This attribute ties in with
the deployment targets (e.g., -mmacosx-version-min=10.1 specifies that
we want to deploy back to Mac OS X 10.1). There are several concrete
behaviors that this attribute enables, as illustrated with the
function foo() above:
- If we choose a deployment target >= Mac OS X 10.4, uses of "foo"
will result in a deprecation warning, as if we had placed
attribute((deprecated)) on it (but with a better diagnostic)
- If we choose a deployment target >= Mac OS X 10.6, uses of "foo"
will result in an "unavailable" warning (in C)/error (in C++), as
if we had placed attribute((unavailable)) on it
- If we choose a deployment target prior to 10.2, foo() is
weak-imported (if it is a kind of entity that can be weak
imported), as if we had placed the weak_import attribute on it.
Naturally, there can be multiple availability attributes on a
declaration, for different platforms; only the current platform
matters when checking availability attributes.
The only platforms this attribute currently works for are "ios" and
"macosx", since we already have -mxxxx-version-min flags for them and we
have experience there with macro tricks translating down to the
deprecated/unavailable/weak_import attributes. The end goal is to open
this up to other platforms, and even extension to other "platforms"
that are really libraries (say, through a #pragma clang
define_system), but that hasn't yet been designed and we may want to
shake out more issues with this narrower problem first.
Addresses <rdar://problem/6690412>.
As a drive-by bug-fix, if an entity is both deprecated and
unavailable, we only emit the "unavailable" diagnostic.
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@128127 91177308-0d34-0410-b5e6-96231b3b80d8
2011-03-23 03:50:03 +03:00
void f0 ( ) __attribute__ ( ( availability ( macosx , introduced = 10.2 , deprecated = 10.4 , obsoleted = 10.6 ) ) ) ;
void f1 ( ) __attribute__ ( ( availability ( macosx , deprecated = 10.4 , introduced = 10.2 , obsoleted = 10.6 ) ) ) ;
void f2 ( ) __attribute__ ( ( availability ( ios , deprecated = 10.4 .7 , introduced = 10 , obsoleted = 10.6 ) ) ) ;
void f3 ( ) __attribute__ ( ( availability ( ios , deprecated = 10.4 .7 , introduced = 10 , obsoleted = 10.6 , introduced = 10.2 ) ) ) ; // expected-error{{redundant 'introduced' availability change; only the last specified change will be used}}
2011-03-26 06:35:55 +03:00
void f4 ( ) __attribute__ ( ( availability ( macosx , introduced = 10.5 ) , availability ( ios , unavailable ) ) ) ;
void f5 ( ) __attribute__ ( ( availability ( macosx , introduced = 10.5 ) , availability ( ios , unavailable , unavailable ) ) ) ; // expected-error{{redundant 'unavailable' availability change; only the last specified change will be used}}
2011-12-15 04:38:15 +04:00
void f6 ( ) __attribute__ ( ( availability ( macosx , unavailable , introduced = 10.5 ) ) ) ; // expected-warning{{'unavailable' availability overrides all other availability information}}
2011-03-26 06:35:55 +03:00
2011-12-10 04:28:41 +04:00
// rdar://10095131
enum E {
2012-11-17 23:16:52 +04:00
gorf __attribute__ ( ( availability ( macosx , introduced = 8.5 , message = 10.0 ) ) ) , / / expected - error { { expected string literal for optional message in ' availability ' attribute } }
2011-12-10 04:28:41 +04:00
garf __attribute__ ( ( availability ( macosx , introduced = 8.5 , message ) ) ) , / / expected - error { { expected ' = ' after ' message ' } }
foo __attribute__ ( ( availability ( macosx , introduced = 8.5 , deprecated = 9.0 , message = " Use CTFontCopyPostScriptName() " , deprecated=10.0))) // expected-error { { expected ' ) ' } } \
// expected-note {{to match this '('}}
} ;
