Files
Karoy Lorentey 537bf9cbfb Drop support for Swift 6.0 and 6.1
This allows the use of Span types without `#if compiler` guards.
2026-09-21 13:34:39 -07:00

163 lines
5.5 KiB
Swift

//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift Collections open source project
//
// Copyright (c) 2024 - 2026 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
//
// SPDX-License-Identifier: Apache-2.0 WITH Swift-exception
//
//===----------------------------------------------------------------------===//
#if !COLLECTIONS_SINGLE_MODULE
import InternalCollectionsUtilities
#endif
@available(SwiftStdlib 5.0, *)
extension UniqueArray where Element: ~Copyable {
/// Initializes a new unique array with no elements.
@inlinable
public init() {
_storage = .init(capacity: 0)
}
/// Initializes a new unique array with the specified capacity and no elements.
@inlinable
public init(minimumCapacity: Int) {
_storage = .init(capacity: minimumCapacity)
}
}
@available(SwiftStdlib 5.0, *)
extension UniqueArray where Element: ~Copyable {
/// Creates a new array with the specified capacity, directly initializing
/// its storage using an output span.
///
/// - Parameters:
/// - capacity: The storage capacity of the new array.
/// - body: A callback that gets called at most once to directly
/// populate newly reserved storage within the array. The function
/// is allowed to add fewer than `capacity` items. The array is
/// initialized with however many items the callback adds to the
/// output span before it returns (or before it throws an error).
@inlinable
public init<E: Error>(
capacity: Int,
initializingWith body: (inout OutputSpan<Element>) throws(E) -> Void
) throws(E) {
self.init(minimumCapacity: capacity)
try edit(body)
}
}
@available(SwiftStdlib 5.0, *)
extension UniqueArray /*where Element: Copyable*/ {
/// Creates a new array containing the specified number of a single,
/// repeated value.
///
/// - Parameters:
/// - repeatedValue: The element to repeat.
/// - count: The number of times to repeat the value passed in the
/// `repeating` parameter. `count` must be zero or greater.
///
/// - Complexity: O(`count`)
public init(repeating repeatedValue: Element, count: Int) {
self.init(consuming: RigidArray(repeating: repeatedValue, count: count))
}
}
@available(SwiftStdlib 5.0, *)
extension UniqueArray where Element: ~Copyable {
/// Creates a new unique array taking over the storage of the specified
/// rigid array instance, consuming it in the process.
///
/// - Complexity: O(1)
@inlinable
public init(consuming storage: consuming RigidArray<Element>) {
self._storage = storage
}
}
@available(SwiftStdlib 5.0, *)
extension UniqueArray /*where Element: Copyable*/ {
#if compiler(>=6.4)
/// Creates a new array with the specified initial capacity, holding a copy
/// of the contents of a given borrowing sequence.
///
/// - Parameters:
/// - capacity: The storage capacity of the new array, or nil to allocate
/// just enough capacity to store the contents.
/// - contents: A sequence whose contents to copy into the new array.
/// The sequence must not contain more than `capacity` elements.
@available(SwiftStdlib 6.4, *)
@_alwaysEmitIntoClient
@inline(__always)
public init<Source: Iterable & ~Copyable & ~Escapable>(
capacity: Int? = nil,
copying contents: borrowing Source
) throws(Source.Failure)
where Source.Element == Element {
self.init(minimumCapacity: capacity ?? 0)
try self.append(copying: contents)
}
#endif
/// Creates a new array with the specified initial capacity, holding a copy
/// of the contents of a given sequence.
///
/// - Parameters:
/// - capacity: The storage capacity of the new array, or nil to allocate
/// just enough capacity to store the contents.
/// - contents: The sequence whose contents to copy into the new array.
@_alwaysEmitIntoClient
@inline(__always)
public init(
capacity: Int? = nil,
copying contents: some Sequence<Element>
) {
self.init(minimumCapacity: capacity ?? 0)
self.append(copying: contents)
}
#if compiler(>=6.4)
/// Creates a new array with the specified initial capacity, holding a copy
/// of the contents of a given container.
///
/// - Parameters:
/// - capacity: The storage capacity of the new array, or nil to allocate
/// just enough capacity to store the contents.
/// - contents: The container whose contents to copy into the new array.
@available(SwiftStdlib 6.4, *)
@_alwaysEmitIntoClient
@inline(__always)
public init<Source: Iterable & Sequence<Element>>(
capacity: Int? = nil,
copying contents: Source
) throws(Source.Failure)
where Source.Element == Element {
self.init(minimumCapacity: capacity ?? 0)
try self.append(copying: contents)
}
#endif
/// Creates a new array with the specified capacity, holding a copy
/// of the contents of the given span.
///
/// - Parameters:
/// - capacity: The storage capacity of the new array, or nil to allocate
/// just enough capacity to store the contents of the span.
/// - span: The span whose contents to copy into the new array.
/// The span must not contain more than `capacity` elements.
@_alwaysEmitIntoClient
@inline(__always)
public init(
capacity: Int? = nil,
copying span: Span<Element>
) {
self.init(minimumCapacity: capacity ?? span.count)
self.append(copying: span)
}
}