API/nerdamer/structures

Class

Dictionary

src/core/classes/dictionary/Dictionary.ts:28

A key-value container where keys are strings (variable names) and values are any ParserEntity. Supports element-wise arithmetic operations.

remarks

The optional constructor Map is retained rather than copied. set and merge also retain value references, while copy copies every stored parser entity. Arrays returned by keys, values, and entries are new arrays, but their values still refer to the stored entities. Iteration and text output preserve Map insertion order. Replacing an existing key does not move it. each mutates values in place; evaluation and expansion return deep copies. Dictionaries support structural equality by key and value but intentionally define no greater-than or less-than ordering. Syntax: {x => 1, y => 2, z => x+3} Access: d[x] → 1, d[y] → 2 Assign: d[y]: 10

Members

__get__(indices: string | number[]): ParserEntityMethod

Returns the element for the given string key. Used by the parser for bracket indexing: d[x] → d.getter('x')

Parameters

Name	Type	Description
`indices`	`string \| number[]`	—

Returns

__set__(indices: string | number[], value: ParserEntity): voidMethod

Sets the element for the given string key. Used by the parser for bracket assignment: d[x]: 5

Parameters

Name	Type	Description
`indices`	`string \| number[]`	—
`value`	`ParserEntity`	—

Returns

void

abs(): DictionaryMethod

No description is available yet.

Returns

Dictionary(entries?: Map<string, ParserEntity>): DictionaryConstructor

Creates a Dictionary, retaining the supplied Map when present.

Parameters

Name	Type	Description
`entries`	`Map<string, ParserEntity>`	—

Returns

copy(): DictionaryMethod

Copies the Dictionary, including every stored value.

Returns

count(): numberMethod

Number of entries.

Returns

number

dataType: "DIC"Property

No description is available yet.

delete(key: string): booleanMethod

Removes a key-value pair.

Parameters

Name	Type	Description
`key`	`string`	—

Returns

boolean

diff(variable?: ExpressionInput, n?: number | Expression): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`variable`	`ExpressionInput`	—
`n`	`number \| Expression`	—

Returns

dimensions(): number[]Method

No description is available yet.

Returns

number[]

dimensionsMatch(x: ParserEntity): xMethod

No description is available yet.

Parameters

Name	Type	Description
`x`	`ParserEntity`	—

Returns

x

div(x: NerdamerInput): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`x`	`NerdamerInput`	—

Returns

each(callback: (e: ParserEntity, i?: string | number, j?: string | number): ParserEntity): DictionaryMethod

Iterates over all entries. The callback receives the value and the string key. Mutates values in place.

Parameters

Name	Type	Description
`callback`	`(e: ParserEntity, i?: string \| number, j?: string \| number): ParserEntity`	—

Returns

elements(): ParserEntity[]API

Satisfies the StructuredEntity abstract property. Returns the values as an array for compatibility with element-wise operations.

Parameters

Name	Type	Description
`values`	`ParserEntity[]`	—

Returns

ParserEntity[]

entries(): [string, ParserEntity][]Method

Returns all entries in insertion order as a new pair array. Stored value objects are not copied.

Returns

[string, ParserEntity][]

eq(other: ParserEntity): booleanMethod

No description is available yet.

Parameters

Name	Type	Description
`other`	`ParserEntity`	—

Returns

boolean

evaluate(): DictionaryMethod

Evaluates a copied Dictionary, leaving this one unchanged.

Returns

expand(): DictionaryMethod

No description is available yet.

Returns

factor(): DictionaryMethod

No description is available yet.

Returns

get(key: string): ParserEntity | undefinedMethod

Gets the stored value reference by key, or

`undefined`

when absent.

Parameters

Name	Type	Description
`key`	`string`	—

Returns

ParserEntity | undefined

gt(_other: ParserEntity): booleanMethod

No description is available yet.

Parameters

Name	Type	Description
`_other`	`ParserEntity`	—

Returns

boolean

gte(other: ParserEntity): booleanMethod

No description is available yet.

Parameters

Name	Type	Description
`other`	`ParserEntity`	—

Returns

boolean

has(key: string): booleanMethod

Checks if a key exists.

Parameters

Name	Type	Description
`key`	`string`	—

Returns

boolean

integrate(variable?: ExpressionInput): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`variable`	`ExpressionInput`	—

Returns

isDictionary(obj: unknown): objMethod

No description is available yet.

Parameters

Name	Type	Description
`obj`	`unknown`	—

Returns

obj

isEnumerable: booleanProperty

No description is available yet.

keys(): string[]Method

Returns all keys.

Returns

string[]

lt(_other: ParserEntity): booleanMethod

No description is available yet.

Parameters

Name	Type	Description
`_other`	`ParserEntity`	—

Returns

boolean

lte(other: ParserEntity): booleanMethod

No description is available yet.

Parameters

Name	Type	Description
`other`	`ParserEntity`	—

Returns

boolean

merge(other: Dictionary): DictionaryMethod

Merges another Dictionary into this one. Existing keys are overwritten and incoming value references are retained.

Parameters

Name	Type	Description
`other`	`Dictionary`	—

Returns

minus(x: NerdamerInput): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`x`	`NerdamerInput`	—

Returns

plus(x: NerdamerInput): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`x`	`NerdamerInput`	—

Returns

pow(x: NerdamerInput): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`x`	`NerdamerInput`	—

Returns

precision: numberProperty

No description is available yet.

set(key: string, value: ParserEntity): DictionaryMethod

Sets a key-value pair by reference and returns this Dictionary.

Parameters

Name	Type	Description
`key`	`string`	—
`value`	`ParserEntity`	—

Returns

simplify(): DictionaryMethod

No description is available yet.

Returns

subst(value: ExpressionInput, withValue: ExpressionInput): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`value`	`ExpressionInput`	—
`withValue`	`ExpressionInput`	—

Returns

symbolicAccessor: Expression[]Property

Public index expressions retained when bracket access cannot yet be resolved. This state belongs to a copied structured entity, never the stored source value.

symbolicTarget: ExpressionProperty

Original symbolic target used to render and later re-evaluate bracket access.

text(): stringMethod

No description is available yet.

Returns

string

times(x: NerdamerInput): DictionaryMethod

No description is available yet.

Parameters

Name	Type	Description
`x`	`NerdamerInput`	—

Returns

toString(): stringMethod

No description is available yet.

Returns

string

values(): ParserEntity[]Method

Returns stored value references in insertion order in a new array.

Returns

ParserEntity[]

withSymbolicAccessor(target: Expression, indices: Expression[]): DictionaryMethod

Returns a copied structured entity carrying an unresolved bracket access. Existing accessor state is retained so chained symbolic access can be extended.

Parameters

Name	Type	Description
`target`	`Expression`	—
`indices`	`Expression[]`	—

Returns