ShapedArraySlice

@frozen
public struct ShapedArraySlice<Scalar> : _ShapedArrayProtocol

extension ShapedArraySlice: RandomAccessCollection, MutableCollection

extension ShapedArraySlice: CustomStringConvertible

extension ShapedArraySlice: CustomPlaygroundDisplayConvertible

extension ShapedArraySlice: CustomReflectable

extension ShapedArraySlice: ExpressibleByArrayLiteral where Scalar: TensorFlowScalar

extension ShapedArraySlice: Equatable where Scalar: Equatable

extension ShapedArraySlice: Hashable where Scalar: Hashable

extension ShapedArraySlice: Codable where Scalar: Codable

یک برش پیوسته از یک نمونه ShapedArray یا ShapedArraySlice .

ShapedArraySlice عملیات سریع و کارآمد را در برش های پیوسته از نمونه های ShapedArray فعال می کند. نمونه های ShapedArraySlice فضای ذخیره سازی خود را ندارند. در عوض، آنها نمایی از فضای ذخیره سازی ShapedArray پایه خود را ارائه می دهند. ShapedArraySlice می تواند دو نوع مختلف از برش ها را نشان دهد: آرایه های عنصر و زیرآرایه.

آرایه های عنصر عناصر زیربعدی یک ShapedArray هستند: رتبه آنها یک کمتر از پایه آنها است. برش های آرایه عناصر با نمایه سازی یک نمونه ShapedArray با شاخص Int32 منفرد به دست می آیند.

مثلا:

    var matrix = ShapedArray(shape: [2, 2], scalars: [0, 1, 2, 3])
    // `matrix` represents [[0, 1], [2, 3]].

    let element = matrix[0]
    // `element` is a `ShapedArraySlice` with shape [2]. It is an element
    // array, specifically the first element in `matrix`: [0, 1].

    matrix[1] = ShapedArraySlice(shape: [2], scalars: [4, 8])
    // The second element in `matrix` has been mutated.
    // `matrix` now represents [[0, 1, 4, 8]].

زیرآرایه ها محدوده پیوسته ای از عناصر یک ShapedArray هستند. رتبه یک زیرآرایه با پایه آن یکسان است، اما بعد اصلی آن تعداد محدوده برش است. برش های زیرآرایی با نمایه سازی ShapedArray با Range<Int32> به دست می آیند که گستره ای از عناصر (در بعد اصلی) را نشان می دهد. متدهایی مانند prefix(:) و suffix(:) که به صورت داخلی با یک محدوده ایندکس می شوند نیز زیرآرایه تولید می کنند.

مثلا:

    let zeros = ShapedArray(repeating: 0, shape: [3, 2])
    var matrix = ShapedArray(shape: [3, 2], scalars: Array(0..<6))
    // `zeros` represents [[0, 0], [0, 0], [0, 0]].
    // `matrix` represents [[0, 1], [2, 3], [4, 5]].

    let subarray = matrix.prefix(2)
    // `subarray` is a `ShapedArraySlice` with shape [2, 2]. It is a slice
    // of the first 2 elements in `matrix` and represents [[0, 1], [2, 3]].

    matrix[0..<2] = zeros.prefix(2)
    // The first 2 elements in `matrix` have been mutated.
    // `matrix` now represents [[0, 0], [0, 0], [4, 5]].