从 .NET 11 开始,多维张量复制和采用目标的操作在写入输出之前,使用 ArgumentException 拒绝不支持的重叠存储布局。 Tensor-span 构造函数还验证存储的 System.Array 元素类型。
该更改在 System.Numerics.Tensors 包中提供,包括其支持的目标框架。 更新包可能会影响面向早期.NET版本的应用。 单独的 TensorPrimitives API 保留其现有的重叠约定。
引入的版本
.NET 11
以前的行为
CopyTo、 FlattenTo、 TryCopyTo和 TryFlattenTo 记录了对重叠源和目标存储的支持。
Try 方法描述了处理源的方式,就好像它首先被复制到临时存储一样。
例如,以下源和目标引用同一数组的重叠区域:
int[] storage = { 1, 2, 3, 4, 5, 6 };
ReadOnlyTensorSpan<int> source = new(storage, new nint[] { 2, 2 }, new nint[] { 3, 1 });
TensorSpan<int> destination = new(storage, new nint[] { 2, 2 });
source.CopyTo(destination);
记录的快照样式约定暗示目标将接收 [1, 2, 4, 5]。 不受支持的重叠的实际结果可能取决于布局和遍历顺序;实现无法可靠地满足该协定。
采用 System.Array 的构造函数没有一致地验证数组的元素类型是否兼容 T。
新行为
该示例在复制 ArgumentException 之前抛出异常。 当形状和容量检查成功时,相同的不支持重叠也会从 TryCopyTo 和 TryFlattenTo 抛出。
支持的重叠仍因具体操作而异:
| 运算 | 支持的重叠 |
|---|---|
CopyTo 和 TryCopyTo |
具有相等元素计数的密集源和目标,或完全相同的视图。 |
FlattenTo 和 TryFlattenTo |
密集源和目标跨度。 |
| 带目标参数的按元素操作 | 没有重复逻辑存储位置的相同输入/输出视图。 移位重叠和重叠的广播输入将被拒绝。 |
Tensor.ResizeTo |
密集源和目标。 不支持的跨步重叠被拒绝。 |
| 反转到同一视图 | 密集就地反转,或无操作反转。 |
当目标过短时,这些 Try 复制方法仍返回 false,而不复制。
TryCopyTo 还对于不兼容的形状返回 false。 不支持的重叠是无效的布局,而不是容量失败。
Tensor.ResizeTo 和连接到现有目标这两种情况都会拒绝包含多个逻辑元素的零步幅维度。 仍允许单例维度中的空目标和零步幅。
接受ArrayTypeMismatchException的TensorSpan<T>和ReadOnlyTensorSpan<T>构造函数会针对不兼容的数组元素类型引发System.Array。 可写张量跨度也拒绝协变数组;只读张量跨度允许兼容的引用类型协变。
破坏性变更的类型
这是行为 变化。
更改原因
在任意重叠的跨步张量之间进行正确复制可能需要与整个张量成正比的临时存储。 显式拒绝可避免遍历依赖的损坏,而不会悄然分配完整张量快照。
重复的输出存储位置不能表示不同的逻辑结果。 数组元素类型验证可防止将不兼容的存储解释为 T,并阻止通过协变数组存储进行写入。
建议的操作
使用不重叠的输出存储,或在重叠复制之前显式地对源数据进行快照。 在上面的示例中:
int[] snapshot = new int[checked((int)source.FlattenedLength)];
source.FlattenTo(snapshot);
ReadOnlyTensorSpan<int> independentSource = new(snapshot, source.Lengths);
independentSource.CopyTo(destination);
快照包含 [1, 2, 4, 5]。 对于采用目标的逐元素操作,请对每个重叠输入进行快照或分配单独的结果。 将广播目标替换为独立可寻址的输出存储。
对于张量跨度 System.Array,请提供兼容的元素存储。 对于可写视图,请使用不协变的数组,或将元素复制到新的 T[] 中。
不要假定 Try 复制方法不会引发异常。
false 结果处理容量不足,或对于 TryCopyTo,处理不兼容的形状。 无兼容性开关可还原任意重叠行为。
受影响的 API
- System.Numerics.Tensors.IReadOnlyTensor<TSelf,T>.CopyTo。
- System.Numerics.Tensors.IReadOnlyTensor<TSelf,T>.FlattenTo。
- System.Numerics.Tensors.IReadOnlyTensor<TSelf,T>.TryCopyTo。
- System.Numerics.Tensors.IReadOnlyTensor<TSelf,T>.TryFlattenTo。
- Tensor<T>、TensorSpan<T> 和 ReadOnlyTensorSpan<T> 上的相应复制和展平方法。
- 在 Tensor 上采用目标参数的逐元素方法,包括一元、二元和张量/标量运算。
- System.Numerics.Tensors.Tensor.ResizeTo (所有重载)。
- System.Numerics.Tensors.Tensor.Reverse 和 System.Numerics.Tensors.Tensor.ReverseDimension(接受目标参数的重载)。
- System.Numerics.Tensors.Tensor.Concatenate(接受目标参数的重载)。
-
TensorSpan<T> 和 ReadOnlyTensorSpan<T>(每种类型上采用
System.Array的两个重载)。