meos.js

---

meos.js / TTextInst

Class: TTextInst

Defined in: core/types/basic/ttext/TTextInst.ts:15

Temporal text — Instant subtype.

A single (value, timestamp) pair. Wraps a MEOS TTextInst pointer.

Example

const inst = TTextInst.fromValue('hello', 60_000_000);

Extends

• TText

Constructors

Constructor

new TTextInst(inner): TTextInst;

Defined in: core/types/basic/ttext/TText.ts:63

Parameters

inner

number

Returns

TTextInst

Inherited from

TText.constructor

Accessors

inner

Get Signature

get inner(): number;

Defined in: core/types/temporal/Temporal.ts:173

Raw WASM pointer. Use when passing this value to low-level functions.

Returns

number

Inherited from

TText.inner

Methods

[dispose]()

dispose: void;

Defined in: core/types/temporal/Temporal.ts:191

Explicit Resource Management support. Allows using t = TBool.fromString(...) to free automatically.

Returns

void

Inherited from

TText.[dispose]

---

alwaysEq()

alwaysEq(s): boolean;

Defined in: core/types/basic/ttext/TText.ts:228

Returns true if the value is always equal to s. MEOS: always_eq_ttext_text

Parameters

s

string

Returns

boolean

Inherited from

TText.alwaysEq

---

alwaysLt()

alwaysLt(s): boolean;

Defined in: core/types/basic/ttext/TText.ts:237

Returns true if the value is always less than s. MEOS: always_lt_ttext_text

Parameters

s

string

Returns

boolean

Inherited from

TText.alwaysLt

---

appendInstant()

appendInstant(
   inst, 
   maxdist?, 
   maxt?, 
   expand?): this;

Defined in: core/types/temporal/Temporal.ts:528

Appends an instant to this temporal, returning a new temporal. MEOS: temporal_append_tinstant

Parameters

inst

this

The instant to append (same subtype as this).

maxdist?

number = 0

Maximum distance gap allowed (0 = no limit).

maxt?

number = 0

Maximum time gap as interval pointer (0 = no limit).

expand?

boolean = false

Whether to expand the sequence in-place.

Returns

this

Inherited from

TText.appendInstant

---

appendSequence()

appendSequence(seq, expand?): this;

Defined in: core/types/temporal/Temporal.ts:538

Appends a sequence to this temporal, returning a new temporal. MEOS: temporal_append_tsequence

Parameters

seq

this

expand?

boolean = false

Returns

this

Inherited from

TText.appendSequence

---

asHexWKB()

asHexWKB(): string;

Defined in: core/types/temporal/Temporal.ts:213

Returns the hex-encoded WKB representation.

Uses the hand-written temporal_as_hexwkb_w wrapper which internally passes variant=4 (extended WKB) and discards size_out.

MEOS: temporal_as_hexwkb

Returns

string

Inherited from

TText.asHexWKB

---

asMFJSON()

asMFJSON(
   withBbox?, 
   flags?, 
   precision?, 
   srs?): string;

Defined in: core/types/temporal/Temporal.ts:235

Returns the MF-JSON representation.

The hand-written wrapper converts an empty srs string to C NULL so that callers can omit the SRS without passing a null pointer directly.

MEOS: temporal_as_mfjson

Parameters

withBbox?

boolean = true

Include bounding box in the output (default true)

flags?

number = 3

Output flags (default 3)

precision?

number = 6

Coordinate decimal precision (default 6)

srs?

string | null

Spatial Reference System string, or null to omit

Returns

string

Inherited from

TText.asMFJSON

---

at()

at(s): TText | null;

Defined in: core/types/basic/ttext/TText.ts:206

Restrict to instants where the value equals s. MEOS: ttext_at_value

Parameters

s

string

Returns

TText | null

Inherited from

TText.at

---

atMax()

atMax(): this;

Defined in: core/types/temporal/Temporal.ts:406

Restricts to instants where the value is the maximum. MEOS: temporal_at_max

Returns

this

Inherited from

TText.atMax

---

atMin()

atMin(): this;

Defined in: core/types/temporal/Temporal.ts:401

Restricts to instants where the value is the minimum. MEOS: temporal_at_min

Returns

this

Inherited from

TText.atMin

---

atTsTzSet()

atTsTzSet(s): this;

Defined in: core/types/temporal/Temporal.ts:425

Restricts to the given timestamp set. MEOS: temporal_at_tstzset

Parameters

s

number

Returns

this

Inherited from

TText.atTsTzSet

---

atTsTzSpan()

atTsTzSpan(s): this;

Defined in: core/types/temporal/Temporal.ts:430

Restricts to the given timestamp span. MEOS: temporal_at_tstzspan

Parameters

s

number

Returns

this

Inherited from

TText.atTsTzSpan

---

atTsTzSpanSet()

atTsTzSpanSet(ss): this;

Defined in: core/types/temporal/Temporal.ts:435

Restricts to the given timestamp span set. MEOS: temporal_at_tstzspanset

Parameters

ss

number

Returns

this

Inherited from

TText.atTsTzSpanSet

---

concat()

concat(other): TText;

Defined in: core/types/basic/ttext/TText.ts:184

Concatenates other to this TText. MEOS: textcat_ttext_text / textcat_ttext_ttext

Parameters

other

string | TText

Returns

TText

Inherited from

TText.concat

---

copy()

copy(): this;

Defined in: core/types/temporal/Temporal.ts:199

Returns a deep copy of this temporal value. MEOS: temporal_copy

Returns

this

Inherited from

TText.copy

---

durationMs()

durationMs(ignoreGaps?): number;

Defined in: core/types/temporal/Temporal.ts:385

Returns the total duration as a number of milliseconds.

Uses the hand-written temporal_duration_us_w wrapper which converts the MEOS Interval* return value to a plain int64 (total microseconds). The result is divided by 1000 to return milliseconds.

Pass ignoreGaps=true to sum only sequence durations, ignoring the time gaps between sequences in a SequenceSet.

MEOS: temporal_duration

Parameters

ignoreGaps?

boolean = false

Returns

number

Inherited from

TText.durationMs

---

endInstant()

endInstant(): this;

Defined in: core/types/temporal/Temporal.ts:286

Returns the last instant as a new instance of the same subtype. MEOS: temporal_end_instant

Returns

this

Inherited from

TText.endInstant

---

endTimestamp()

endTimestamp(): number;

Defined in: core/types/temporal/Temporal.ts:362

Returns the last timestamp as microseconds since 2000-01-01 UTC. MEOS: temporal_end_timestamptz

Returns

number

Inherited from

TText.endTimestamp

---

endValue()

endValue(): string;

Defined in: core/types/basic/ttext/TText.ts:122

Ending value. MEOS: ttext_end_value

Returns

string

Inherited from

TText.endValue

---

equals()

equals(other): boolean;

Defined in: core/types/temporal/Temporal.ts:558

Pointer-based identity check. For value equality, use the generated teq_* / temporal_eq functions.

Parameters

other

Temporal<string>

Returns

boolean

Inherited from

TText.equals

---

everEq()

everEq(s): boolean;

Defined in: core/types/basic/ttext/TText.ts:225

Returns true if the value is ever equal to s. MEOS: ever_eq_ttext_text

Parameters

s

string

Returns

boolean

Inherited from

TText.everEq

---

everLt()

everLt(s): boolean;

Defined in: core/types/basic/ttext/TText.ts:234

Returns true if the value is ever less than s. MEOS: ever_lt_ttext_text

Parameters

s

string

Returns

boolean

Inherited from

TText.everLt

---

free()

free(): void;

Defined in: core/types/temporal/Temporal.ts:183

Frees the underlying MEOS allocation.

After calling free(), the instance must not be used. Calls the hand-written meos_free wrapper from res/bindings_c_header.txt.

Returns

void

Inherited from

TText.free

---

initcap()

initcap(): TText;

Defined in: core/types/basic/ttext/TText.ts:176

Returns a new TText with initcap applied (first letter of each word uppercased). MEOS: ttext_initcap

Returns

TText

Inherited from

TText.initcap

---

instantN()

instantN(n): this;

Defined in: core/types/temporal/Temporal.ts:320

Returns the n-th instant (0-based index).

Uses the hand-written temporal_instant_n_w wrapper which converts the 0-based JS index to the 1-based index expected by MEOS internally.

MEOS: temporal_instant_n

Parameters

n

number

Returns

this

Inherited from

TText.instantN

---

interpolation()

interpolation(): TInterpolation;

Defined in: core/types/temporal/Temporal.ts:248

Returns the interpolation mode of this temporal value. MEOS: temporal_interp

Returns

TInterpolation

Inherited from

TText.interpolation

---

lower()

lower(): TText;

Defined in: core/types/basic/ttext/TText.ts:171

Returns a new TText with all characters lowercased. MEOS: ttext_lower

Returns

TText

Inherited from

TText.lower

---

maxInstant()

maxInstant(): this;

Defined in: core/types/temporal/Temporal.ts:306

Returns the instant with the maximum value. MEOS: temporal_max_instant

Returns

this

Inherited from

TText.maxInstant

---

maxValue()

maxValue(): string;

Defined in: core/types/basic/ttext/TText.ts:136

Maximum value (lexicographic). MEOS: ttext_max_value

Returns

string

Inherited from

TText.maxValue

---

merge()

merge(other): this;

Defined in: core/types/temporal/Temporal.ts:546

Merges this temporal with another, returning a new temporal. MEOS: temporal_merge

Parameters

other

this

Returns

this

Inherited from

TText.merge

---

minInstant()

minInstant(): this;

Defined in: core/types/temporal/Temporal.ts:296

Returns the instant with the minimum value. MEOS: temporal_min_instant

Returns

this

Inherited from

TText.minInstant

---

minus()

minus(s): TText | null;

Defined in: core/types/basic/ttext/TText.ts:215

Restrict to instants where the value differs from s. MEOS: ttext_minus_value

Parameters

s

string

Returns

TText | null

Inherited from

TText.minus

---

minusMax()

minusMax(): this;

Defined in: core/types/temporal/Temporal.ts:416

Excludes instants where the value is the maximum. MEOS: temporal_minus_max

Returns

this

Inherited from

TText.minusMax

---

minusMin()

minusMin(): this;

Defined in: core/types/temporal/Temporal.ts:411

Excludes instants where the value is the minimum. MEOS: temporal_minus_min

Returns

this

Inherited from

TText.minusMin

---

minusTsTzSet()

minusTsTzSet(s): this;

Defined in: core/types/temporal/Temporal.ts:440

Excludes the given timestamp set. MEOS: temporal_minus_tstzset

Parameters

s

number

Returns

this

Inherited from

TText.minusTsTzSet

---

minusTsTzSpan()

minusTsTzSpan(s): this;

Defined in: core/types/temporal/Temporal.ts:445

Excludes the given timestamp span. MEOS: temporal_minus_tstzspan

Parameters

s

number

Returns

this

Inherited from

TText.minusTsTzSpan

---

minusTsTzSpanSet()

minusTsTzSpanSet(ss): this;

Defined in: core/types/temporal/Temporal.ts:450

Excludes the given timestamp span set. MEOS: temporal_minus_tstzspanset

Parameters

ss

number

Returns

this

Inherited from

TText.minusTsTzSpanSet

---

minValue()

minValue(): string;

Defined in: core/types/basic/ttext/TText.ts:131

Minimum value (lexicographic). MEOS: ttext_min_value

Returns

string

Inherited from

TText.minValue

---

neverEq()

neverEq(s): boolean;

Defined in: core/types/basic/ttext/TText.ts:231

Returns true if the value is never equal to s.

Parameters

s

string

Returns

boolean

Inherited from

TText.neverEq

---

numInstants()

numInstants(): number;

Defined in: core/types/temporal/Temporal.ts:263

Returns the number of distinct instants in this temporal value. MEOS: temporal_num_instants

Returns

number

Inherited from

TText.numInstants

---

numTimestamps()

numTimestamps(): number;

Defined in: core/types/temporal/Temporal.ts:334

Returns the number of distinct timestamps. MEOS: temporal_num_timestamps

Returns

number

Inherited from

TText.numTimestamps

---

prepend()

prepend(prefix): TText;

Defined in: core/types/basic/ttext/TText.ts:194

Prepends prefix before this TText. MEOS: textcat_text_ttext

Parameters

prefix

string

Returns

TText

Inherited from

TText.prepend

---

scaleTime()

scaleTime(duration): this;

Defined in: core/types/temporal/Temporal.ts:464

Scales the temporal domain to the given duration interval pointer. MEOS: temporal_scale_time

Parameters

duration

number

Returns

this

Inherited from

TText.scaleTime

---

setInterp()

setInterp(interp): this;

Defined in: core/types/temporal/Temporal.ts:478

Returns a new temporal with the interpolation changed to interp. Pass TInterpolation values as numbers: Discrete=0, Stepwise=1, Linear=2. MEOS: temporal_set_interp

Parameters

interp

TInterpolation

Returns

this

Inherited from

TText.setInterp

---

shiftScaleTime()

shiftScaleTime(shift, duration): this;

Defined in: core/types/temporal/Temporal.ts:469

Shifts and scales the temporal domain. MEOS: temporal_shift_scale_time

Parameters

shift

number

duration

number

Returns

this

Inherited from

TText.shiftScaleTime

---

shiftTime()

shiftTime(shift): this;

Defined in: core/types/temporal/Temporal.ts:459

Shifts the temporal domain by the given interval pointer. MEOS: temporal_shift_time

Parameters

shift

number

Returns

this

Inherited from

TText.shiftTime

---

startInstant()

startInstant(): this;

Defined in: core/types/temporal/Temporal.ts:276

Returns the first instant as a new instance of the same subtype. MEOS: temporal_start_instant

Returns

this

Inherited from

TText.startInstant

---

startTimestamp()

startTimestamp(): number;

Defined in: core/types/temporal/Temporal.ts:347

Returns the first timestamp as microseconds since 2000-01-01 UTC. MEOS: temporal_start_timestamptz

Returns

number

Inherited from

TText.startTimestamp

---

startValue()

startValue(): string;

Defined in: core/types/basic/ttext/TText.ts:117

Starting value. MEOS: ttext_start_value

Returns

string

Inherited from

TText.startValue

---

temporalEq()

temporalEq(s): number;

Defined in: core/types/basic/ttext/TText.ts:244

Temporal equality: returns a TBool ptr that is true where this == s. MEOS: teq_ttext_text

Parameters

s

string

Returns

number

Inherited from

TText.temporalEq

---

temporalGe()

temporalGe(s): number;

Defined in: core/types/basic/ttext/TText.ts:259

Temporal greater-than-or-equal. MEOS: tge_ttext_text

Parameters

s

string

Returns

number

Inherited from

TText.temporalGe

---

temporalGt()

temporalGt(s): number;

Defined in: core/types/basic/ttext/TText.ts:256

Temporal greater-than. MEOS: tgt_ttext_text

Parameters

s

string

Returns

number

Inherited from

TText.temporalGt

---

temporalLe()

temporalLe(s): number;

Defined in: core/types/basic/ttext/TText.ts:253

Temporal less-than-or-equal. MEOS: tle_ttext_text

Parameters

s

string

Returns

number

Inherited from

TText.temporalLe

---

temporalLt()

temporalLt(s): number;

Defined in: core/types/basic/ttext/TText.ts:250

Temporal less-than. MEOS: tlt_ttext_text

Parameters

s

string

Returns

number

Inherited from

TText.temporalLt

---

temporalNe()

temporalNe(s): number;

Defined in: core/types/basic/ttext/TText.ts:247

Temporal inequality. MEOS: tne_ttext_text

Parameters

s

string

Returns

number

Inherited from

TText.temporalNe

---

toInstant()

toInstant(): this;

Defined in: core/types/temporal/Temporal.ts:489

Converts to TInstant (must already be an instant). MEOS: temporal_to_tinstant

Returns

this

Inherited from

TText.toInstant

---

toSequence()

toSequence(interp): this;

Defined in: core/types/temporal/Temporal.ts:494

Converts to TSequence with the given interpolation. MEOS: temporal_to_tsequence

Parameters

interp

TInterpolation

Returns

this

Inherited from

TText.toSequence

---

toSequenceSet()

toSequenceSet(interp): this;

Defined in: core/types/temporal/Temporal.ts:505

Converts to TSequenceSet with the given interpolation. MEOS: temporal_to_tsequenceset

Parameters

interp

TInterpolation

Returns

this

Inherited from

TText.toSequenceSet

---

toString()

toString(): string;

Defined in: core/types/basic/ttext/TText.ts:112

WKT string representation. MEOS: ttext_out

Returns

string

Inherited from

TText.toString

---

upper()

upper(): TText;

Defined in: core/types/basic/ttext/TText.ts:166

Returns a new TText with all characters uppercased. MEOS: ttext_upper

Returns

TText

Inherited from

TText.upper

---

valueAtTimestamp()

valueAtTimestamp(t): string | null;

Defined in: core/types/basic/ttext/TText.ts:153

Evaluates the temporal at a specific timestamp. Returns null when the timestamp is outside the temporal's domain. MEOS: temporal_at_timestamptz + ttext_start_value

Parameters

t

number

Returns

string | null

Inherited from

TText.valueAtTimestamp

---

valueN()

valueN(n): string | null;

Defined in: core/types/basic/ttext/TText.ts:144

Returns the n-th distinct value (0-based index), or null if out of range. MEOS: ttext_value_n

Parameters

n

number

Returns

string | null

Inherited from

TText.valueN

---

fromBaseTemporal()

static fromBaseTemporal(s, domain): TText;

Defined in: core/types/basic/ttext/TText.ts:87

Create a TText with constant value s spanning the same domain as domain. MEOS: ttext_from_base_temp

Parameters

s

string

domain

TText

Returns

TText

Inherited from

TText.fromBaseTemporal

---

fromBaseTime()

static fromBaseTime(
   s, 
   time, 
   type): TText;

Defined in: core/types/basic/ttext/TText.ts:95

Create a TText with constant value s over a time object. MEOS: ttextseq_from_base_tstzset / tstzspan / ttextseqset_from_base_tstzspanset

Parameters

s

string

time

number

type

"tstzset" | "tstzspan" | "tstzspanset"

Returns

TText

Inherited from

TText.fromBaseTime

---

fromMFJSON()

static fromMFJSON(mfjson): TText;

Defined in: core/types/basic/ttext/TText.ts:79

Parse a TText from a MF-JSON string. MEOS: ttext_from_mfjson

Parameters

mfjson

string

Returns

TText

Inherited from

TText.fromMFJSON

---

fromString()

static fromString(wkt): TText;

Defined in: core/types/basic/ttext/TText.ts:71

Parse a TText from a WKT string. MEOS: ttext_in

Parameters

wkt

string

Returns

TText

Inherited from

TText.fromString

---

fromValue()

static fromValue(value, timestamp): TTextInst;

Defined in: core/types/basic/ttext/TTextInst.ts:26

Constructs a TTextInst from a string value and a timestamp.

Parameters

value

string

String value.

timestamp

number

Microseconds since 2000-01-01 UTC. MEOS: ttextinst_make

Returns

TTextInst