Breyta

Deila með


PipeWriter.GetSpan(Int32) Method

Definition

Returns a Span<T> to write to that is at least the requested size, as specified by the sizeHint parameter.

public abstract Span<byte> GetSpan (int sizeHint = 0);
abstract member GetSpan : int -> Span<byte>
Public MustOverride Function GetSpan (Optional sizeHint As Integer = 0) As Span(Of Byte)

Parameters

sizeHint
Int32

The minimum length of the returned Span<T>. If 0, a non-empty buffer of arbitrary size is returned.

Returns

A buffer of at least sizeHint bytes. If sizeHint is 0, returns a non-empty buffer of arbitrary size.

Implements

Exceptions

The requested buffer size is not available.

Remarks

There is no guarantee that successive calls will return the same buffer or the same-sized buffer.

This method never returns Span<T>.Empty, but it throws an OutOfMemoryException if the requested buffer size is not available.

You must request a new buffer after calling Advance(Int32) to continue writing more data; you cannot write to a previously acquired buffer.

Applies to