Class ParserLabeledRuleCallResultStore

Namespace

Utils.Parser.Runtime

Assembly

Utils.Parser.dll

Stores immutable snapshots of successful labeled child parser-rule call results for one invocation frame. Assignment labels and list labels use separate namespaces because grammar ingestion currently permits the same lexical label with both operators; callers must use the helper matching the call-site label kind.

public sealed class ParserLabeledRuleCallResultStore : ICloneable, IParserExecutionStateHashable

Inheritance

object

ParserLabeledRuleCallResultStore

Implements

ICloneable

IParserExecutionStateHashable

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

DataUtils.ToDbValue(object?)

MathEx.Clamp<T>(T, T, T, IComparer<T>)

FluentExtensions.Failure<T>(T)

FluentExtensions.IsEqualTo<T, CT>(T, CT)

FluentExtensions.IsGreaterOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsGreaterThan<T, CT>(T, CT)

FluentExtensions.IsIn<T>(T, params T[])

FluentExtensions.IsLowerOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsLowerThan<T, CT>(T, CT)

FluentExtensions.IsNotIn<T>(T, params T[])

FluentExtensions.IsNotNull<T>(T)

FluentExtensions.IsNull<T>(T)

FluentExtensions.Success<T>(T)

FluentExtensions.Test<T>(T, Func<T, bool>)

ObjectUtils.Between<T>(T, IComparer<T>, T, T)

ObjectUtils.Between<T>(T, IComparer<T>, T, T, bool, bool)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Func<Task<Result>>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Result)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.In<T>(T, params T[])

ObjectUtils.NotIn<T>(T, params T[])

Validations.ArgMustBe<T>(T, Func<T, bool>, string, string)

Validations.ArgMustNotBe<T>(T, Func<T, bool>, string, string)

Validations.Arg<T>(T, string)

Validations.ValueMustNotBeNull<T>(T, string)

Validations.Variable<T>(T, string)

Properties

Empty

Gets the shared empty labeled-result store.

public static ParserLabeledRuleCallResultStore Empty { get; }

Property Value

ParserLabeledRuleCallResultStore

Methods

AppendList(string, ParserRuleCallResult)

Returns a new store with the supplied successful result appended to a list label.

public ParserLabeledRuleCallResultStore AppendList(string labelName, ParserRuleCallResult result)

Parameters

labelName string

List label name.

result ParserRuleCallResult

Successful completed call result.

Returns

ParserLabeledRuleCallResultStore

A new immutable store snapshot.

Clone()

Returns this immutable store instance.

public object Clone()

Returns

object

The current immutable store.

GetList(string)

Gets the successful results retained for a list label in execution order.

public IReadOnlyList<ParserRuleCallResult> GetList(string labelName)

Parameters

labelName string

List label name.

Returns

IReadOnlyList<ParserRuleCallResult>

An immutable ordered result list, or a shared empty list when absent.

GetParserExecutionStateHash()

Computes a deterministic state hash for assignment labels, list labels, and ordered call results. Call results conservatively produce volatile hashes when they contain unsupported arbitrary return objects.

public ulong GetParserExecutionStateHash()

Returns

ulong

The managed execution-state hash.

SetAssignment(string, ParserRuleCallResult)

Returns a new store whose assignment label contains the supplied successful result. A repeated assignment label uses last-successful-result-wins semantics.

public ParserLabeledRuleCallResultStore SetAssignment(string labelName, ParserRuleCallResult result)

Parameters

labelName string

Assignment label name.

result ParserRuleCallResult

Successful completed call result.

Returns

ParserLabeledRuleCallResultStore

A new immutable store snapshot.

TryGetAssignment(string, out ParserRuleCallResult)

Attempts to retrieve the last successful result retained for an assignment label.

public bool TryGetAssignment(string labelName, out ParserRuleCallResult result)

Parameters

labelName string

Assignment label name.

result ParserRuleCallResult

Receives the retained result when present.

Returns

bool

true when an assignment result is present; otherwise, false.