JsonValue

Description

sealed class Tinman.Core.Formatting.JsonValue

Derived from: IJsonValue
ISerializable

Represents a mutable JSON value.

A formatted JSON value must be written in the following Grammar:

json     := value ;

array    := '[' (value .. ',')? ']' ;
member   := string ':' value ;
object   := '{' (comment* member .. ',')? '}' ;
value    := 'false' | 'null' | 'true' | object | array | number | string ;

string   := '"' (]"\\[ \ '\0'..'\x001F' | escape)* '"' ;

escape   := '\\' ([/tfbn"r\\] | 'u' hexdigit[4]) ;

hexdigit := 'a'..'f' | 'A'..'F' | digit ;
number   := '-'? ('0' | '1'..'9' digit*) ('.' digit+)? (('e' | 'E') ('+' | '-')? digit+)? ;

comment  := '// ' ]\r\n[* '\r'? '\n' ;
digit    := '0'..'9' ;

The following methods may be used to set the value, changing the value type:

Set : null
Set² : boolean
Set³ : integer
Set⁴ : integer
Set⁵ : number
Set⁶ : string

The following methods may be used to build array values, changing the value type to array:

Element¹
Element²
Element³
Element⁴
Element⁵
Element⁶
ElementAdd
ElementPrepare

The following methods may be used to build object values, changing the value type to object:

Member¹
Member²
Member³
Member⁴
Member⁵
Member⁶
MemberAdd
MemberPrepare

The IJsonValue interface may be used to pass around read-only references to JsonValue objects.

Public / Constants

Empty

[ShutdownSurvive]
public static readonly attribute Empty → (IJsonValue)

The JSON value for the empty string.

This is not a singleton value, there may be other JsonValue objects that are equal to this one.

See also: IJsonValue.IsString

False

[ShutdownSurvive]
public static readonly attribute False → (IJsonValue)

The false JSON value.

This is not a singleton value, there may be other JsonValue objects that are equal to this one.

See also: IJsonValue.IsBoolean

Null

[ShutdownSurvive]
public static readonly attribute Null → (IJsonValue)

The null JSON value.

This is not a singleton value, there may be other JsonValue objects that are equal to this one.

See also: IJsonValue.IsNull

True

[ShutdownSurvive]
public static readonly attribute True → (IJsonValue)

The true JSON value.

This is not a singleton value, there may be other JsonValue objects that are equal to this one.

See also: IJsonValue.IsBoolean

Public / Constructors

From

public static method From → (1)

text ⁱⁿ : string: [not-null]
The JSON code.
returns → JsonValue: The JsonValue object.

Creates a JsonValue from the given text.

ValidatingException: If the given source code text ⁱⁿ is malformed.

See also: IJsonValue.ToString

FromFile

public static method FromFile → (1)

file ⁱⁿ : Path: [not-null]
The file path.
returns → JsonValue: The JsonValue object or Null if the file does not exist.

Creates a JsonValue from the given file.

IOException: If an I/O error has occurred.

ValidatingException: If the given file ⁱⁿ contains malformed source code.

See also: IJsonValue.ToFile

JsonValue

public constructor JsonValue → ()

Creates a new instance of JsonValue.

See also: IJsonValue.IsNull

Public / Methods