FractionJsonConverter<T> Class

Definition

Namespace

Bodu.Numerics.Serialization.Json

Assembly

Bodu.Numerics.Serialization.Json.dll

Package

Bodu.Numerics.Serialization.Json 1.0.0

Source

FractionJsonConverter{T}.cs

Converts a Fraction<T> to and from JSON using the policy supplied at construction.

public sealed class FractionJsonConverter<T> : JsonConverter<Fraction<T>> where T : IBinaryInteger<T>

Type Parameters

T

The backing integer type of the fraction.

Inheritance

object

JsonConverter

JsonConverter<Fraction<T>>

FractionJsonConverter<T>

Inherited Members

JsonConverter<Fraction<T>>.CanConvert(Type)

JsonConverter<Fraction<T>>.ReadAsPropertyName(ref Utf8JsonReader, Type, JsonSerializerOptions)

JsonConverter<Fraction<T>>.WriteAsPropertyName(Utf8JsonWriter, Fraction<T>, JsonSerializerOptions)

JsonConverter<Fraction<T>>.HandleNull

JsonConverter<Fraction<T>>.Type

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

ComparableExtensions.AtLeast<T>(T, T, IComparer<T>)

ComparableExtensions.AtMost<T>(T, T, IComparer<T>)

ComparableExtensions.IsEqualTo<T>(T, T, IComparer<T>)

ComparableExtensions.Max<T>(T, T, IComparer<T>)

ComparableExtensions.Min<T>(T, T, IComparer<T>)

Remarks

The converter shape is selected by NumericsJsonPolicy:

• Strict - canonical object form { "numerator": 3, "denominator": 4 }; rejects duplicate properties and non-object tokens. Property values may be either JSON numbers or numeric strings, so BigInteger-backed values survive without precision loss.
• Lenient - same object shape as Strict, but a top-level JSON string token is accepted and routed through Parse(ReadOnlySpan<char>, IFormatProvider?) as a tolerant fallback.
• Compact - string form "3/4"; reads delegate to TryParse(ReadOnlySpan<char>, IFormatProvider?, out Fraction<T>) and writes call ToString(string?, IFormatProvider?) with the invariant culture.

Constructors

FractionJsonConverter()

Initializes a new instance of the FractionJsonConverter<T> class configured for the Strict shape.

public FractionJsonConverter()

FractionJsonConverter(NumericsJsonPolicy)

Initializes a new instance of the FractionJsonConverter<T> class configured for the supplied policy.

public FractionJsonConverter(NumericsJsonPolicy policy)

Parameters

policy NumericsJsonPolicy

The serialization policy.

Exceptions

ArgumentOutOfRangeException

policy is not a defined NumericsJsonPolicy value.

Methods

Read(ref Utf8JsonReader, Type, JsonSerializerOptions)

Reads and converts the JSON to type Bodu.Numerics.Fraction{`0}.

public override Fraction<T> Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)

Parameters

reader Utf8JsonReader

The reader.

typeToConvert Type

The type to convert.

options JsonSerializerOptions

An object that specifies serialization options to use.

Returns

Fraction<T>

The converted value.

Write(Utf8JsonWriter, Fraction<T>, JsonSerializerOptions)

Writes a specified value as JSON.

public override void Write(Utf8JsonWriter writer, Fraction<T> value, JsonSerializerOptions options)

Parameters

writer Utf8JsonWriter

The writer to write to.

value Fraction<T>

The value to convert to JSON.

options JsonSerializerOptions

An object that specifies serialization options to use.

Applies to

Product	Versions
.NET	8, 10