mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
66d2ba43c6
That commit made a protocol public. The protocol was underscored but some of its APIs were not, and those became unintentionally publicly visible. This commit corrects that problem. Since Builtin.RawPointer properties were being renamed from "value" to "_rawValue" for clarity, COpaquePointer got that treatment too, even though it wasn't strictly necessary, for consistency. Swift SVN r22252
79 lines
2.6 KiB
Swift
79 lines
2.6 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2015 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
/// A stdlib-internal protocol modeled by the intrinsic pointer types,
|
|
/// UnsafeMutablePointer, UnsafePointer, and
|
|
/// AutoreleasingUnsafeMutablePointer.
|
|
public protocol _PointerType {
|
|
/// The underlying raw pointer value.
|
|
var _rawValue: Builtin.RawPointer { get }
|
|
|
|
/// Construct a pointer from a raw value.
|
|
init(_ _rawValue: Builtin.RawPointer)
|
|
}
|
|
|
|
/// Derive a pointer argument from a convertible pointer type.
|
|
@transparent public
|
|
func _convertPointerToPointerArgument<
|
|
FromPointer: _PointerType,
|
|
ToPointer: _PointerType
|
|
>(from: FromPointer) -> ToPointer {
|
|
return ToPointer(from._rawValue)
|
|
}
|
|
|
|
/// Derive a pointer argument from the address of an inout parameter.
|
|
@transparent public
|
|
func _convertInOutToPointerArgument<
|
|
ToPointer: _PointerType
|
|
>(from: Builtin.RawPointer) -> ToPointer {
|
|
return ToPointer(from)
|
|
}
|
|
|
|
/// Derive a pointer argument from an inout array parameter.
|
|
@transparent public
|
|
func _convertMutableArrayToPointerArgument<
|
|
FromElement,
|
|
ToPointer: _PointerType
|
|
>(inout a: Array<FromElement>) -> (AnyObject?, ToPointer) {
|
|
// TODO: Putting a canary at the end of the array in checked builds might
|
|
// be a good idea
|
|
|
|
// Call reserve to force contiguous storage.
|
|
a.reserveCapacity(0)
|
|
_debugPrecondition(a._baseAddressIfContiguous != nil || a.count == 0)
|
|
|
|
return (a._owner, ToPointer(a._baseAddressIfContiguous._rawValue))
|
|
}
|
|
|
|
/// Derive a pointer argument from a value array parameter.
|
|
@transparent public
|
|
func _convertConstArrayToPointerArgument<
|
|
FromElement,
|
|
ToPointer: _PointerType
|
|
>(arr: Array<FromElement>) -> (AnyObject?, ToPointer) {
|
|
let (owner: AnyObject?, raw) = arr._cPointerArgs()
|
|
return (owner, ToPointer(raw))
|
|
}
|
|
|
|
/// Derive a UTF-8 pointer argument from a value string parameter.
|
|
@transparent public
|
|
func _convertConstStringToUTF8PointerArgument<
|
|
ToPointer: _PointerType
|
|
>(str: String) -> (AnyObject?, ToPointer) {
|
|
// Convert the UTF-8 representation to a null-terminated array.
|
|
var utf8 = Array(str.utf8)
|
|
utf8.append(0)
|
|
// Extract the owner and pointer from the array.
|
|
let (owner: AnyObject?, raw) = utf8._cPointerArgs()
|
|
return (owner, ToPointer(raw))
|
|
}
|