CastArray3DTFrom, TToItem(Int32, Int32, Int32) Property

Gets or sets the element at the specified indices. Parameter order is the same as in case of a regular three-dimensional array.

Definition

Namespace: KGySoft.Collections
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 10.5.0

C#

public TTo this[
	int z,
	int y,
	int x
] { get; set; }

VB

Public Default Property Item ( 
	z As Integer,
	y As Integer,
	x As Integer
) As TTo
	Get
	Set

C++

public:
property TTo default[int z, int y, int x] {
	TTo get (int z, int y, int x);
	void set (int z, int y, int x, TTo value);
}

F#

member Item : 'TTo with get, set

Parameters

z Int32: The Z-coordinate (depth index) of the item to get or set.
y Int32: The Y-coordinate (row index) of the item to get or set.
x Int32: The X-coordinate (column index) of the item to get or set.

Return Value

TTo
The element at the specified indices.

Remarks

Though this member does not validate the coordinates separately, it does not allow indexing beyond the Length of the underlying Buffer. To omit also the length check use the GetElementUnsafe/SetElementUnsafe methods instead.

If the compiler you use supports members that return a value by reference, you can also use the GetElementReference method.

Tip

If TTo is a primitive type of size larger than 1 byte, and unaligned memory access is not supported by the executing architecture (e.g. ARM), consider to use the GetElementUnaligned/SetElementUnaligned methods to avoid a possible DataMisalignedException.

Exceptions

IndexOutOfRangeException	The specified indices refer to an item outside the bounds of the underlying Buffer.
NotSupportedException	.NET Framework only: you access this member in a partially trusted AppDomain that does not allow executing unverifiable code.
DataMisalignedException	TTo is a primitive type of size larger than 1 byte, the address of the result is not properly aligned at the specified indices, and the executing architecture does not support misaligned memory access (e.g. ARM).