BinarySizeParse(ReadOnlySpanChar, IFormatProvider) Method

Parses a span of characters into a BinarySize structure.

Definition

Namespace: Ookii
Assembly: Ookii.BinarySize (in Ookii.BinarySize.dll) Version: 1.0.0+877c9712c6435bf9adfdb0683d7a434c5604a8f2
C#
public static BinarySize Parse(
	ReadOnlySpan<char> s,
	IFormatProvider? provider
)

Parameters

s  ReadOnlySpanChar
The span of characters to parse.
provider  IFormatProvider
An object that provides culture-specific formatting information about s.

Return Value

BinarySize
The result of parsing s.

Implements

ISpanParsableTSelfParse(ReadOnlySpanChar, IFormatProvider)

Remarks

The input must contain a number, followed by one of the following units: "B", "KB", "KiB", "MB", "MiB", "GB", "GiB", "TB", "TiB", "PB", "PiB", "EB", or "EiB". The "B" may be omitted, and the casing of the unit and any surrounding whitespace is ignored.

This method uses the definition that "1 KB" == 1024 bytes, identical to "1 KiB", and "1 MB" == "1 MiB" == 1048576 bytes, and so on. To use the IEC standard where SI prefixes are treated as powers of ten, use the Parse(ReadOnlySpanChar, BinarySizeOptions, NumberStyles, IFormatProvider) method.

Exceptions

FormatExceptions is not in the correct format.
OverflowExceptions is not representable as a BinarySize.

See Also