注意: 代码现已更新为 Swift 5 (Xcode 10.2)。 (可以在编辑历史中找到 Swift 3 和 Swift 4.2 版本。)现在还可能正确处理未对齐的数据。
如何从一个值创建Data
从 Swift 4.2 开始,可以简单地从值创建数据
let value = 42.13
let data = withUnsafeBytes(of: value) { Data($0) }
print(data as NSData) // <713d0ad7 a3104540>
解释:
如何从Data 中检索值
从 Swift 5 开始,Data 的 withUnsafeBytes(_:) 调用闭包,并带有“无类型”UnsafeMutableRawBufferPointer 到字节。 load(fromByteOffset:as:) 方法从内存中读取值:
let data = Data([0x71, 0x3d, 0x0a, 0xd7, 0xa3, 0x10, 0x45, 0x40])
let value = data.withUnsafeBytes {
$0.load(as: Double.self)
}
print(value) // 42.13
这种方法有一个问题:它要求内存为类型的属性对齐(这里:对齐到 8 字节地址)。但这不能保证,例如如果数据是作为另一个 Data 值的切片获得的。
因此将字节复制到值更安全:
let data = Data([0x71, 0x3d, 0x0a, 0xd7, 0xa3, 0x10, 0x45, 0x40])
var value = 0.0
let bytesCopied = withUnsafeMutableBytes(of: &value, { data.copyBytes(to: $0)} )
assert(bytesCopied == MemoryLayout.size(ofValue: value))
print(value) // 42.13
解释:
copyBytes() 的返回值是复制的字节数。它等于目标缓冲区的大小,如果数据不包含足够的字节,则小于。
通用解决方案#1
上面的转换现在可以很容易地实现为struct Data的泛型方法:
extension Data {
init<T>(from value: T) {
self = Swift.withUnsafeBytes(of: value) { Data($0) }
}
func to<T>(type: T.Type) -> T? where T: ExpressibleByIntegerLiteral {
var value: T = 0
guard count >= MemoryLayout.size(ofValue: value) else { return nil }
_ = Swift.withUnsafeMutableBytes(of: &value, { copyBytes(to: $0)} )
return value
}
}
此处添加了约束T: ExpressibleByIntegerLiteral,以便我们可以轻松地将值初始化为“零”——这并不是真正的限制,因为此方法无论如何都可以用于“trival”(整数和浮点)类型,请参阅下面。
例子:
let value = 42.13 // implicit Double
let data = Data(from: value)
print(data as NSData) // <713d0ad7 a3104540>
if let roundtrip = data.to(type: Double.self) {
print(roundtrip) // 42.13
} else {
print("not enough data")
}
同样,您可以将 数组 转换为 Data 并返回:
extension Data {
init<T>(fromArray values: [T]) {
self = values.withUnsafeBytes { Data($0) }
}
func toArray<T>(type: T.Type) -> [T] where T: ExpressibleByIntegerLiteral {
var array = Array<T>(repeating: 0, count: self.count/MemoryLayout<T>.stride)
_ = array.withUnsafeMutableBytes { copyBytes(to: $0) }
return array
}
}
例子:
let value: [Int16] = [1, Int16.max, Int16.min]
let data = Data(fromArray: value)
print(data as NSData) // <0100ff7f 0080>
let roundtrip = data.toArray(type: Int16.self)
print(roundtrip) // [1, 32767, -32768]
通用解决方案#2
上述方法有一个缺点:它实际上只适用于“琐碎”
整数和浮点类型等类型。 “复杂”类型,例如 Array
和 String 有(隐藏的)指向底层存储的指针,不能
通过复制结构本身来传递。它也不适用于
引用类型,它们只是指向真实对象存储的指针。
所以解决这个问题,可以
-
定义一个协议,定义转换为Data 并返回的方法:
protocol DataConvertible {
init?(data: Data)
var data: Data { get }
}
-
将转换实现为协议扩展中的默认方法:
extension DataConvertible where Self: ExpressibleByIntegerLiteral{
init?(data: Data) {
var value: Self = 0
guard data.count == MemoryLayout.size(ofValue: value) else { return nil }
_ = withUnsafeMutableBytes(of: &value, { data.copyBytes(to: $0)} )
self = value
}
var data: Data {
return withUnsafeBytes(of: self) { Data($0) }
}
}
我在这里选择了一个 failable 初始化程序,它检查提供的字节数
匹配类型的大小。
-
最后声明符合所有可以安全地转换为 Data 并返回的类型:
extension Int : DataConvertible { }
extension Float : DataConvertible { }
extension Double : DataConvertible { }
// add more types here ...
这使得转换更加优雅:
let value = 42.13
let data = value.data
print(data as NSData) // <713d0ad7 a3104540>
if let roundtrip = Double(data: data) {
print(roundtrip) // 42.13
}
第二种方法的优点是您不会无意中进行不安全的转换。缺点是您必须明确列出所有“安全”类型。
您还可以为需要非平凡转换的其他类型实现协议,例如:
extension String: DataConvertible {
init?(data: Data) {
self.init(data: data, encoding: .utf8)
}
var data: Data {
// Note: a conversion to UTF-8 cannot fail.
return Data(self.utf8)
}
}
或者在你自己的类型中实现转换方法来做任何事情
必要的,所以序列化和反序列化一个值。
字节顺序
以上方法都没有进行字节序转换,数据总是在
主机字节顺序。对于独立于平台的表示(例如
“big endian”又名“network”字节顺序),使用相应的整数
属性分别初始化器。例如:
let value = 1000
let data = value.bigEndian.data
print(data as NSData) // <00000000 000003e8>
if let roundtrip = Int(data: data) {
print(Int(bigEndian: roundtrip)) // 1000
}
当然这个转换一般也可以,在泛型中
转换方法。