Edit

ReadOnlySpan<T> Constructors

  • Reference

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Overloads

ReadOnlySpan<T>(T)

Creates a new ReadOnlySpan<T> of length 1 around the specified reference.
ReadOnlySpan<T>(T[])

Creates a new ReadOnlySpan<T> over the entirety of a specified array.
ReadOnlySpan<T>(Void*, Int32)

Creates a new ReadOnlySpan<T> from a specified number of T elements starting at a specified memory address.
ReadOnlySpan<T>(T[], Int32, Int32)

Creates a new ReadOnlySpan<T> that includes a specified number of elements of an array starting at a specified index.

ReadOnlySpan<T>(T)

Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs

Creates a new ReadOnlySpan<T> of length 1 around the specified reference.

public:
 ReadOnlySpan(T % reference);
public ReadOnlySpan (in T reference);
public ReadOnlySpan (ref T reference);
new ReadOnlySpan<'T> : 'T -> ReadOnlySpan<'T>
Public Sub New (ByRef reference As T)

Parameters

reference
T

A reference to data.

Applies to

ReadOnlySpan<T>(T[])

Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs

Creates a new ReadOnlySpan<T> over the entirety of a specified array.

public:
 ReadOnlySpan(cli::array <T> ^ array);
public ReadOnlySpan (T[]? array);
public ReadOnlySpan (T[] array);
new ReadOnlySpan<'T> : 'T[] -> ReadOnlySpan<'T>
Public Sub New (array As T())

Parameters

array
T[]

The array from which to create the ReadOnlySpan<T>.

Remarks

If the array is null, this constructor returns a null ReadOnlySpan<T>.

Applies to

ReadOnlySpan<T>(Void*, Int32)

Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs

Important

This API is not CLS-compliant.

Creates a new ReadOnlySpan<T> from a specified number of T elements starting at a specified memory address.

public:
 ReadOnlySpan(void* pointer, int length);
[System.CLSCompliant(false)]
public ReadOnlySpan (void* pointer, int length);
[<System.CLSCompliant(false)>]
new ReadOnlySpan<'T> : nativeptr<unit> * int -> ReadOnlySpan<'T>

Parameters

pointer
Void*

A pointer to the starting address of a specified number of T elements in memory.

length
Int32

The number of T elements to be included in the ReadOnlySpan<T>.

Attributes
CLSCompliantAttribute

Exceptions

ArgumentException

T is a reference type or contains references and therefore cannot be stored in unmanaged memory.

ArgumentOutOfRangeException

length is negative.

Remarks

This constructor should be used with care, since it creates arbitrarily typed Ts from a void*-typed block of memory, and neither pointer nor length are validated by the constructor.

Applies to

ReadOnlySpan<T>(T[], Int32, Int32)

Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs
Source:
ReadOnlySpan.cs

Creates a new ReadOnlySpan<T> that includes a specified number of elements of an array starting at a specified index.

public:
 ReadOnlySpan(cli::array <T> ^ array, int start, int length);
public ReadOnlySpan (T[]? array, int start, int length);
public ReadOnlySpan (T[] array, int start, int length);
new ReadOnlySpan<'T> : 'T[] * int * int -> ReadOnlySpan<'T>
Public Sub New (array As T(), start As Integer, length As Integer)

Parameters

array
T[]

The array from which to create the ReadOnlySpan<T>.

start
Int32

The index of the first element to include.

length
Int32

The number of elements to include.

Exceptions

ArgumentOutOfRangeException

array is null, but start or length is non-zero.

-or-

start is outside the bounds of the array.

-or-

start and length exceeds the number of elements in the array.

Remarks

This method returns default when array is null.

Applies to