Vector<T> Struct

Definition

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
public struct Vector<T> : IEquatable<System.Numerics.Vector<T>>, IFormattable where T : struct
type Vector<'T (requires 'T : struct)> = struct
    interface IFormattable
Public Structure Vector(Of T)
Implements IEquatable(Of Vector(Of T)), IFormattable

Type Parameters

T

The vector type. T can be any primitive numeric type.

Inheritance
Vector<T>
Implements

Remarks

Vector<T> is an immutable structure that represents a single vector of a specified numeric type. The count of a Vector<T> instance is fixed, but its upper limit is CPU-register dependent. It is intended to be used as a building block for vectorizing large algorithms.

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

The following table shows which primitive numeric data type and operation combination uses intrinsic instructions for faster executions:

Primitive type + - * /
sbyte Yes Yes No No
byte Yes Yes No No
short Yes Yes Yes No
ushort Yes Yes No No
int Yes Yes Yes No
uint Yes Yes No No
long Yes Yes No No
ulong Yes Yes No No
float Yes Yes Yes Yes
double Yes Yes Yes Yes

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[])

Creates a vector from a specified array.

Vector<T>(T[], Int32)

Creates a vector from a specified array starting at a specified index position.

Properties

Count

Returns the number of elements stored in the vector.

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[])

Copies the vector instance to a specified destination array.

CopyTo(T[], Int32)

Copies the vector instance to a specified destination array starting at a specified index position.

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)

Returns the string representation of this vector using the specified format string to format individual elements.

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.

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>, 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<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.

Inequality(Vector<T>, Vector<T>)

Returns a value that indicates whether any single pair of elements in the specified vectors is equal.

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.

Subtraction(Vector<T>, Vector<T>)

Subtracts the second vector from the first.

UnaryNegation(Vector<T>)

Negates a given vector.

Applies to