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要素配列と部分配列という 2 つの異なる種類のスライスを表すことができます。

要素配列はShapedArrayのサブディメンション要素です。そのランクはベースのランクより 1 つ小さいです。要素配列スライスは、 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内の要素の連続した範囲です。サブ配列のランクはそのベースのランクと同じですが、その先頭の次元はスライス範囲の数です。サブ配列スライスは、(先頭の次元の) 要素の範囲を表すRange<Int32>を使用してShapedArrayにインデックスを付けることによって取得されます。 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]].