Vector<T> Struct

Reference

Definition

Namespace:: System.Numerics

Assembly:: System.Numerics.Vectors.dll

Assembly:: netstandard.dll

Package:: System.Numerics.Vectors v4.6.0

Source:: Vector_1.cs

Source:: Vector_1.cs

Source:: Vector_1.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Represents a single vector of a specified numeric type that is suitable for low-level optimization of parallel algorithms.

generic <typename T>
 where T : value classpublic value class Vector : IEquatable<System::Numerics::Vector<T>>, IFormattable

generic <typename T>
public value class Vector : IEquatable<System::Numerics::Vector<T>>, IFormattable

public struct Vector<T> : IEquatable<System.Numerics.Vector<T>>, IFormattable where T : struct

public readonly struct Vector<T> : IEquatable<System.Numerics.Vector<T>>, IFormattable where T : struct

public readonly struct Vector<T> : IEquatable<System.Numerics.Vector<T>>, IFormattable

type Vector<'T (requires 'T : struct)> = struct
    interface IFormattable

type Vector<'T> = struct
    interface IFormattable

Public Structure Vector(Of T)
Implements IEquatable(Of Vector(Of T)), IFormattable

Type Parameters

T

The type of the elements in the vector. T can be any primitive numeric type.

Inheritance: Object

ValueType
Vector<T>

Implements: IEquatable<Vector<T>> IFormattable

Remarks

Vector<T> is an immutable structure that represents a single vector of a specified numeric type. The count of Vector<T> instances is fixed, but its upper limit is CPU-register dependent. It's intended to be used as a building block for vectorizing large algorithms, and therefore cannot be used directly as an arbitrary length vector or tensor.

The Vector<T> structure provides support for hardware acceleration.

The term primitive numeric data type in this article refers to numeric data types that are directly supported by the CPU and have instructions that can manipulate those data types.

Constructors

Vector<T>(ReadOnlySpan<Byte>)	Constructs a vector from the given read-only span of bytes.
Vector<T>(ReadOnlySpan<T>)	Constructs a vector from the given ReadOnlySpan<T>.
Vector<T>(Span<T>)	Constructs a vector from the given Span<T>.
Vector<T>(T)	Creates a vector whose components are of a specified type.
Vector<T>(T[], Int32)	Creates a vector from a specified array starting at a specified index position.
Vector<T>(T[])	Creates a vector from a specified array.

Properties

AllBitsSet	Gets a new Vector<T> with all bits set to 1.
Count	Returns the number of elements stored in the vector.
Indices	Gets a new Vector<T> with the elements set to their index.
IsSupported	Gets a value that indicates whether `T` is supported.
Item[Int32]	Gets the element at a specified index.
One	Returns a vector containing all ones.
Zero	Returns a vector containing all zeroes.

Methods

CopyTo(Span<Byte>)	Copies the vector to the given Span<T>.
CopyTo(Span<T>)	Copies the vector to the given span. .
CopyTo(T[], Int32)	Copies the vector instance to a specified destination array starting at a specified index position.
CopyTo(T[])	Copies the vector instance to a specified destination array.
Equals(Object)	Returns a value that indicates whether this instance is equal to a specified object.
Equals(Vector<T>)	Returns a value that indicates whether this instance is equal to a specified vector.
GetHashCode()	Returns the hash code for this instance.
ToString()	Returns the string representation of this vector using default formatting.
ToString(String, IFormatProvider)	Returns the string representation of this vector using the specified format string to format individual elements and the specified format provider to define culture-specific formatting.
ToString(String)	Returns the string representation of this vector using the specified format string to format individual elements.
TryCopyTo(Span<Byte>)	Attempts to copy the vector to the given byte span.
TryCopyTo(Span<T>)	Attempts to copy the vector to the given Span<T>.

Operators

Addition(Vector<T>, Vector<T>)	Adds two vectors together.
BitwiseAnd(Vector<T>, Vector<T>)	Returns a new vector by performing a bitwise `And` operation on each of the elements in two vectors.
BitwiseOr(Vector<T>, Vector<T>)	Returns a new vector by performing a bitwise `Or` operation on each of the elements in two vectors.
Division(Vector<T>, T)	Divides a vector by a scalar to compute the per-element quotient.
Division(Vector<T>, Vector<T>)	Divides the first vector by the second.
Equality(Vector<T>, Vector<T>)	Returns a value that indicates whether each pair of elements in two specified vectors are equal.
ExclusiveOr(Vector<T>, Vector<T>)	Returns a new vector by performing a bitwise `XOr` operation on each of the elements in two vectors.
Explicit(Vector<T> to Vector<Byte>)	Reinterprets the bits of the specified vector into a vector of type Byte.
Explicit(Vector<T> to Vector<Double>)	Reinterprets the bits of the specified vector into a vector of type Double.
Explicit(Vector<T> to Vector<Int16>)	Reinterprets the bits of the specified vector into a vector of type Int16.
Explicit(Vector<T> to Vector<Int32>)	Reinterprets the bits of the specified vector into a vector of type Int32.
Explicit(Vector<T> to Vector<Int64>)	Reinterprets the bits of the specified vector into a vector of type Int64.
Explicit(Vector<T> to Vector<IntPtr>)	Reinterprets the bits of a source vector into a vector of native-sized integers.
Explicit(Vector<T> to Vector<SByte>)	Reinterprets the bits of the specified vector into a vector of type SByte.
Explicit(Vector<T> to Vector<Single>)	Reinterprets the bits of the specified vector into a vector of type Single.
Explicit(Vector<T> to Vector<UInt16>)	Reinterprets the bits of the specified vector into a vector of type UInt16.
Explicit(Vector<T> to Vector<UInt32>)	Reinterprets the bits of the specified vector into a vector of type UInt32.
Explicit(Vector<T> to Vector<UInt64>)	Reinterprets the bits of the specified vector into a vector of type UInt64.
Explicit(Vector<T> to Vector<UIntPtr>)	Reinterprets the bits of a source vector into a vector of native-sized, unsigned integers.
Inequality(Vector<T>, Vector<T>)	Returns a value that indicates whether any single pair of elements in the specified vectors is equal.
LeftShift(Vector<T>, Int32)	Shifts each element of a vector left by the specified amount.
Multiply(T, Vector<T>)	Multiplies a vector by a specified scalar value.
Multiply(Vector<T>, T)	Multiplies a vector by a specified scalar value.
Multiply(Vector<T>, Vector<T>)	Returns a new vector whose values are the product of each pair of elements in two specified vectors.
OnesComplement(Vector<T>)	Returns a new vector whose elements are obtained by taking the one's complement of a specified vector's elements.
RightShift(Vector<T>, Int32)	Shifts (signed) each element of a vector right by the specified amount.
Subtraction(Vector<T>, Vector<T>)	Subtracts the second vector from the first.
UnaryNegation(Vector<T>)	Negates a given vector.
UnaryPlus(Vector<T>)	Returns a given vector unchanged.
UnsignedRightShift(Vector<T>, Int32)	Shifts (unsigned) each element of a vector right by the specified amount.

Extension Methods

As<TFrom,TTo>(Vector<TFrom>)	Reinterprets a Vector<T> as a new Vector<T>.
GetElement<T>(Vector<T>, Int32)	Gets the element at the specified index.
Store<T>(Vector<T>, T*)	Stores a vector at the given destination.
StoreAligned<T>(Vector<T>, T*)	Stores a vector at the given aligned destination.
StoreAlignedNonTemporal<T>(Vector<T>, T*)	Stores a vector at the given aligned destination.
StoreUnsafe<T>(Vector<T>, T, UIntPtr)	Stores a vector at the given destination.
StoreUnsafe<T>(Vector<T>, T)	Stores a vector at the given destination.
ToScalar<T>(Vector<T>)	Converts the given vector to a scalar containing the value of the first element.
WithElement<T>(Vector<T>, Int32, T)	Creates a new Vector<T> with the element at the specified index set to the specified value and the remaining elements set to the same value as that in the given vector.
AsVector128<T>(Vector<T>)	Reinterprets a Vector<T> as a new Vector128<T>.
AsVector256<T>(Vector<T>)	Reinterprets a Vector<T> as a new Vector256<T>.
AsVector512<T>(Vector<T>)	Reinterprets a Vector<T> as a new Vector512<T>.

Applies to

Jaa