1、带#的关键字
代码 | 作用 |
---|---|
#file | 获取所在文件 |
#function | 获取所在的方法 |
#line | 获取所在的行号 |
#column | 获取所在的列数 |
#sourceLocation(file: String, line: Int) | 改变上面#file和#line的值,line必须大于等于1 |
#sourceLocation() | 重置上面#sourceLocation(file: String, line: Int)的操作 |
行控制语句
#sourceLocation(file: "hello.swift", line: 1)
print("file:\(#file)", "line:\(#line)")
// 无论第一行的文字在哪个文件的哪一行,下面打印都会变成file:hello.swift line:1
编译控制语句
#if condition1
// ...
#elseif condituon2
// ...
#else
// ...
#endif
可以拆分使用,只要以#if开头,#endif结束就可以
最常见的运用就是运行状态和平台以及版本号的判断
函数 | 可选参数值 |
---|---|
os() | OSX, iOS, watchOS, tvOS, Linux |
arch() | i386, x86_64, arm, arm64 |
swift() | 版本号 |
canImport() | 库名称 |
targetEnvironment() | simulation |
// 是否是debug模式
#if DEBUG
// ,,,
#endif
// 是否是iOS系统
#if os(iOS)
// ,,,
#endif
// swift版本是否大于等于且小于5
#if swift(<5) && swift(>=3)
// ,,,
#endif
如果宏DEBUG无效,可以在TARGETS / Build Settings / Swift Complier - Custom Flags / Other Swifr Flags / DEBUG 添加 -D DEBUG
API可用性检查
if #available(iOS 10, macOS 10.14, *) {
} esle {
}
实践
可以利用上面的关键字自定义一个log方法
func xxlog<T>(_ message: T ..., file: String = #file, function: String = #function,
line: Int = #line) {
#if DEBUG
print("\((file as NSString).lastPathComponent) \(function) line:\(line) message:\(message)")
#endif
}
// 打印结果 ViewController.swift viewDidLoad() line:68 message:["hello world"]
2、带@的关键字
@available
用于声明该API的使用与特定的平台和系统版本有关,至少有两个特性参数,参数之间用都好分割且无关顺序
// 在MacOS10.15及之后有效
@available(macOS 10.15, *)
func test() {}
// 在MacOS10.15和iOS 13.0及之后有效
@available(macOS 10.15, iOS 13.0, *)
func test() {}
/* unavailable 表示在指定的平台上是不可用的,调用会报错 */
// 在iOS13不可用
@available(iOS 13.0, unavailable)
// 在全平台不可用
@available(*, unavailable)
/* deprecated表示从指定平台的哪一版本开始弃用,调用会有警告,但是不影响使用 */
/* obsoleted表示从指定平台的哪一版本开始弃用,调用报错 */
/* message提供文本信息。 */
@available(macOS, deprecated: 10.10, message: "该方法已废弃")
func test() {}
// 提示信息:'test()' was deprecated in iOS 13.0: 该方法已废弃
// renamed表示该方法被重命名了新名称。当实用旧名称时,编译器会报错,并提示新名称
@available(iOS 13.0, unavailable, renamed: "newTest")
func test() {}
func newTest() {}
/*
调用test()会报错
'test()' has been renamed to 'newTest'
并提示更新
Replace 'test' with 'newTest'
*/
@discardableResult
正常情况下有返回值的函数调用如果不接收返回值会报一个警告,这个可以屏蔽掉该警告
@discardableResult
func testtest() -> Int {
return 1
}
@testable
给导入模块添加@testable声明,这样在单元测试中就可以访问到这个模块
@convention
@convention是用来修饰闭包的,需要传递一个参数
@convention(swift) 表明这是一个swift的闭包
@convention(block) 表明这是一个兼容OC的block的闭包
@convention(c) 表明这个是兼容C的函数指针的闭包
@inlineable
修饰函数,表示该函数可内联
函数内联,是编译器优化技术,它通过把方法内容直接替换掉方法,这种做法很大程度上优化了性能
func test() {
var a: Int = 0
a++
print(a)
}
// 正常调用
print("开始")
test()
print("结束")
// 内联调用
print("开始")
var a: Int = 0
a++
print(a)
print("结束")