CastArrayTFrom, TToGetElementUnsafe Method

Gets the element at the specified index without any range check or validation. This method can even throw a NullReferenceException if the IsNull property returns . To validate index against Length use the indexer instead. If TTo is a primitive type with misalignment, consider to use the GetElementUnaligned method instead.

Definition

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

C#

[SecurityCriticalAttribute]
public TTo GetElementUnsafe(
	int index
)

VB

<SecurityCriticalAttribute>
Public Function GetElementUnsafe ( 
	index As Integer
) As TTo

C++

public:
[SecurityCriticalAttribute]
TTo GetElementUnsafe(
	int index
)

F#

[<SecurityCriticalAttribute>]
member GetElementUnsafe : 
        index : int -> 'TTo

Parameters

index Int32: The index of the element to get.

Return Value

TTo
The element at the specified index.

Remarks

Caution

You must ensure that index falls within Length, or at least in the bounds of the actual underlying array. Attempting to access protected memory may crash the runtime.

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

Note

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 call the GetElementUnaligned method instead to avoid a possible DataMisalignedException.

Exceptions

NotSupportedException	.NET Framework only: you execute this method in a partially trusted AppDomain that does not allow executing unverifiable code.
NullReferenceException	The IsNull property returns .
DataMisalignedException	TTo is a primitive type of size larger than 1 byte, the address of the result is not properly aligned at the specified index, and the executing architecture does not support misaligned memory access (e.g. ARM).