# 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``
``public readonly 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 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. The following table shows which primitive numeric data type and operation combination uses intrinsic instructions for faster execution:

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

 Constructs a vector from the given read-only span of bytes. Constructs a vector from the given ReadOnlySpan. Constructs a vector from the given Span. Creates a vector whose components are of a specified type. Creates a vector from a specified array. Creates a vector from a specified array starting at a specified index position.

## Properties

 Returns the number of elements stored in the vector. Gets a value that indicates whether `T` is supported. Gets the element at a specified index. Returns a vector containing all ones. Returns a vector containing all zeroes.

## Methods

 Copies the vector to the given Span. Copies the vector to the given span. . Copies the vector instance to a specified destination array. Copies the vector instance to a specified destination array starting at a specified index position. Returns a value that indicates whether this instance is equal to a specified object. Returns a value that indicates whether this instance is equal to a specified vector. Returns the hash code for this instance. Returns the string representation of this vector using default formatting. Returns the string representation of this vector using the specified format string to format individual elements. 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. Attempts to copy the vector to the given byte span. Attempts to copy the vector to the given Span.

## Operators

 Adds two vectors together. Returns a new vector by performing a bitwise `And` operation on each of the elements in two vectors. Returns a new vector by performing a bitwise `Or` operation on each of the elements in two vectors. Divides the first vector by the second. Returns a value that indicates whether each pair of elements in two specified vectors are equal. Returns a new vector by performing a bitwise `XOr` operation on each of the elements in two vectors. Reinterprets the bits of the specified vector into a vector of type Byte. Reinterprets the bits of the specified vector into a vector of type Double. Reinterprets the bits of the specified vector into a vector of type Int16. Reinterprets the bits of the specified vector into a vector of type Int32. Reinterprets the bits of the specified vector into a vector of type Int64. Reinterprets the bits of a source vector into a vector of native-sized integers. Reinterprets the bits of the specified vector into a vector of type SByte. Reinterprets the bits of the specified vector into a vector of type Single. Reinterprets the bits of the specified vector into a vector of type UInt16. Reinterprets the bits of the specified vector into a vector of type UInt32. Reinterprets the bits of the specified vector into a vector of type UInt64. Reinterprets the bits of a source vector into a vector of native-sized, unsigned integers. Returns a value that indicates whether any single pair of elements in the specified vectors is equal. Multiplies a vector by a specified scalar value. Multiplies a vector by a specified scalar value. Returns a new vector whose values are the product of each pair of elements in two specified vectors. Returns a new vector whose elements are obtained by taking the one's complement of a specified vector's elements. Subtracts the second vector from the first. Negates a given vector.

## Extension Methods

 Reinterprets a Vector as a new Vector. Reinterprets a Vector as a new Vector128. Reinterprets a Vector as a new Vector256.