TcNamespaceSymbol | tc-context

Class representing an instance of a PLC Symbol, which is the initial entry point to the TcSymbol map. These namespaces are usually PROGRAMS and different Variable Lists.

This TcSymbol deduces its IndexOffset, IndexGroup and Size, based on the provided children

Hierarchy

TcSymbol
- TcNamespaceSymbol

Indexable

[key: string]: TcSymbol | TcSymbolMethod

TcSymbols are indexable, in case they are structured types, and can nest children TcSymbols. Alternatively, if a TcSymbol has Rpc Methods enabled, this methods can be also invoked over the index.

This TcSymbol deduces its IndexOffset, IndexGroup and Size, based on the provided children

Index

Constructors

constructor

Events

Accessors

Methods

Constructors

constructor

new TcNamespaceSymbol(path: string, context: TcContext, parent: TcEmitter, debug?: boolean): TcNamespaceSymbol

Overrides TcSymbol.constructor
- Defined in src/tc-symbol.ts:1094
Constructs a TcSymbol, which is designed to interface a namespace Symbol on the Target PLC.

Parameters
- path: string
  
  The Path of this Symbol, relative to its origin point
- context: TcContext
  
  The TcContext, that this namespace is apart of
- parent: TcEmitter
  
  Parent Emitter, to whom errors are propagated to
- Default value debug: boolean = false
  
  If enabled, will produce debug information
Returns TcNamespaceSymbol

Events

$on

$on(event: "set", listener: (e: TcSymbolSetEvent) => void): TcSymbol
$on(event: "get", listener: (e: TcSymbolGetEvent) => void): TcSymbol
$on(event: "cleared", listener: (e: TcSymbolClearedEvent) => void): TcSymbol
$on(event: "changed", listener: (e: TcSymbolChangedEvent) => void): TcSymbol

Inherited from TcSymbol.$on
- Defined in src/tc-symbol.ts:238
Emitted from TcBinding of a TcSymbol when TcSymbol.$set() has completed

Parameters
- event: "set"
- listener: (e: TcSymbolSetEvent) => void
  - - (e: TcSymbolSetEvent): void
    - Parameters
      - e: TcSymbolSetEvent
      Returns void
Returns TcSymbol
Inherited from TcSymbol.$on
- Defined in src/tc-symbol.ts:245
Emitted from TcBinding of a TcSymbol when TcSymbol.$get has completed

Parameters
- event: "get"
- listener: (e: TcSymbolGetEvent) => void
  - - (e: TcSymbolGetEvent): void
    - Parameters
      - e: TcSymbolGetEvent
      Returns void
Returns TcSymbol
Inherited from TcSymbol.$on
- Defined in src/tc-symbol.ts:252
Emitted from TcBinding of a TcSymbol when TcSymbol.$clear() has completed

Parameters
- event: "cleared"
- listener: (e: TcSymbolClearedEvent) => void
  - - (e: TcSymbolClearedEvent): void
    - Parameters
      - e: TcSymbolClearedEvent
      Returns void
Returns TcSymbol
Inherited from TcSymbol.$on
- Defined in src/tc-symbol.ts:259
Emitted from TcBinding of a TcSymbol when TcSymbol detects a change in the PLC Symbol

Parameters
- event: "changed"
- listener: (e: TcSymbolChangedEvent) => void
  - - (e: TcSymbolChangedEvent): void
    - Parameters
      - e: TcSymbolChangedEvent
      Returns void
Returns TcSymbol

Accessors

$binding

get $binding(): TcNamespaceBinding

Overrides TcSymbol.$binding
- Defined in src/tc-symbol.ts:1114
Access the TcBinding of this TcSymbol

Returns TcNamespaceBinding

$get

get $get(): Promise<{}>

Overrides TcSymbol.$get
- Defined in src/tc-symbol.ts:1140
Returns the structured value of this TcSymbol from the Target PLC namespace Symbol, which the TcSymbol.$binding is linked to.

throws

TcBindingIsInvalidException - Attempting operation on an invalidated TcBinding

throws

TcComIsInvalidException - Attempting operation on an invalidated TcCom Object

throws

TcComDataReadException - An error occurred when fetching the Symbol Data

throws

TcComFromRawException - An error occurred when parsing Data to values

throws

TcBindingOutOfRangeException - Error occurred when parsing returned Data from the Target PLC Symbol

Returns Promise<{}>
- The value of the Target PLC Symbol

$parent

get $parent(): TcSymbol | undefined

Inherited from TcSymbol.$parent
- Defined in src/tc-symbol.ts:91
Access the potential parent of this TcSymbol

Returns TcSymbol | undefined

$path

get $path(): string

Inherited from TcSymbol.$path
- Defined in src/tc-symbol.ts:97
Access the path of this TcSymbol from its origin point

Returns string

$readOnly

get $readOnly(): boolean

Inherited from TcSymbol.$readOnly
- Defined in src/tc-symbol.ts:109
Returns true if this TcSymbol is ReadOnly

Returns boolean

Methods

$clear

$clear(): Promise<void>

Inherited from TcSymbol.$clear
- Defined in src/tc-symbol.ts:174
Clears the data of the Target PLC Symbol to their implicit default values, or the explicitly specified ones

throws

TcBindingIsInvalidException - Attempting operation on an invalidated TcBinding

throws

TcComIsInvalidException - Attempting operation on an invalidated TcCom Object

throws

TcComDataWriteException - An error occurred when writing the Symbol Data

throws

TcBindingReadOnlyException - Attempted to clear a ReadOnly Symbol

Returns Promise<void>

$each

$each(callback: (symbol: TcSymbol, key: string, parent: TcSymbol) => void): void

- Defined in src/tc-symbol.ts:1123
Iterates over all the TcSymbol Children of this `TcSymbol, and passes each of them to the provided callback

Parameters
- callback: (symbol: TcSymbol, key: string, parent: TcSymbol) => void
  
  Callback, to which each TcSymbol Child is passed
  - - (symbol: TcSymbol, key: string, parent: TcSymbol): void
    - Parameters
      - symbol: TcSymbol
      - key: string
      - parent: TcSymbol
      Returns void
Returns void

$off

$off(eventName: string, listener: (e: any) => void): TcSymbol

Inherited from TcSymbol.$off
- Defined in src/tc-symbol.ts:275
Removes a listener from the specified event

Parameters
- eventName: string
  
  The event name, from which the listener is to be removed
- listener: (e: any) => void
  
  The listener, which is to be removed from the specified event
  - - (e: any): void
    - Parameters
      - e: any
      Returns void
Returns TcSymbol

$onInvalidated

$onInvalidated(callback: (symbol: TcSymbol) => void): void

Inherited from TcSymbol.$onInvalidated
- Defined in src/tc-symbol.ts:227
Attached the provided callback, which will be called when the `TcSymbol becomes invalidated

Parameters
- callback: (symbol: TcSymbol) => void
  
  The function, which is to be called upon invalidation
  - - (symbol: TcSymbol): void
    - Parameters
      - symbol: TcSymbol
      Returns void
Returns void

$once

$once(eventName: string, listener: (e: any) => void): TcSymbol

Inherited from TcSymbol.$once
- Defined in src/tc-symbol.ts:289
Attached a listener to an event, which is only invoked once. For the full list of events, see TcSymbol.$on()

Parameters
- eventName: string
  
  The event name, which the listener will listen for
- listener: (e: any) => void
  
  The listener, which is called when the event is emitted
  - - (e: any): void
    - Parameters
      - e: any
      Returns void
Returns TcSymbol

$set

$set(value: {}): Promise<{}>

Overrides TcSymbol.$set
- Defined in src/tc-symbol.ts:1169
Writes the provided structured value to the Target PLC Symbol, and when completed returns what was written to the Target PLC Symbol

throws

TcBindingIsInvalidException - Attempting operation on an invalidated TcBinding

throws

TcComIsInvalidException - Attempting operation on an invalidated TcCom Object

throws

TcComToRawException - An error occurred when parsing values to Data

throws

TcComDataWriteException - An error occurred when writing the Symbol Data

throws

TcBindingOutOfRangeException - Attempted to write a value which is out of range of this type

throws

TcBindingInvalidTypeException - Type-mismatch occurred when parsing Values to Data

throws

TcBindingReadOnlyException - Attempted to write to a ReadOnly Symbol

Parameters
- value: {}
  
  The structured value that is to be written to the Target PLC Symbol
  - [key: string]: any
Returns Promise<{}>
- The value which was written to the Target PLC Symbol

$subscribe

$subscribe(sampling?: number): Promise<void>

Inherited from TcSymbol.$subscribe
- Defined in src/tc-symbol.ts:197
Activates value change detection of the Target PLC Symbol. The sampling rate can be explicitly set, in case the value changes uneseceraly too fast.

throws

TcBindingIsInvalidException - Attempting operation on an invalidated TcBinding

throws

TcComIsInvalidException - Attempting operation on an invalidated TcCom Object

throws

TcComSubscribeException - An error occurred when subscribing to the Symbol

Parameters
- Default value sampling: number = 10
  
  The speed at which change in the Target PLC Symbol value is detected
Returns Promise<void>

$unsubscribe

$unsubscribe(): Promise<void>

Inherited from TcSymbol.$unsubscribe
- Defined in src/tc-symbol.ts:215
Deactivated value change detection of the Target PLC Symbol. Does not remove the event handlers though, they simply will not be invoked.

throws

TcBindingIsInvalidException - Attempting operation on an invalidated TcBinding

throws

TcComIsInvalidException - Attempting operation on an invalidated TcCom Object

throws

TcComUnsubscribeException - An error occurred when unsubscribing for a Symbol

Returns Promise<void>

Private __addChild

__addChild(child: { key: string; symbol: TcSymbol }): void

- Defined in src/tc-symbol.ts:1185
Internal use function, which registers a TcSymbol Child as part of this `TcSymbol

Parameters
- child: { key: string; symbol: TcSymbol }
  
  The Child that is to be registered
  - key: string
  - symbol: TcSymbol
Returns void

Protected __invalidate

__invalidate(): void

Overrides TcSymbol.__invalidate
- Defined in src/tc-symbol.ts:1208
Invalidates all the TcSymbol Children, before invalidating itself

Returns void

Hierarchy

Indexable

Index

Constructors

Events

Accessors

Methods

Constructors

constructor

Parameters

path: string

context: TcContext

parent: TcEmitter

Default value debug: boolean = false

Returns TcNamespaceSymbol

Events

$on

Parameters

event: "set"

listener: (e: TcSymbolSetEvent) => void

Parameters

e: TcSymbolSetEvent

Returns void

Returns TcSymbol

Parameters

event: "get"

listener: (e: TcSymbolGetEvent) => void

Parameters

e: TcSymbolGetEvent

Returns void

Returns TcSymbol

Parameters

event: "cleared"

listener: (e: TcSymbolClearedEvent) => void

Parameters

e: TcSymbolClearedEvent

Returns void

Returns TcSymbol

Parameters

event: "changed"

listener: (e: TcSymbolChangedEvent) => void

Parameters

e: TcSymbolChangedEvent

Returns void

Returns TcSymbol

Accessors

$binding

Returns TcNamespaceBinding

$get

Returns Promise<{}>

$parent

Returns TcSymbol | undefined

$path

Returns string

$readOnly

Returns boolean

Methods

$clear

Returns Promise<void>

$each

Parameters

callback: (symbol: TcSymbol, key: string, parent: TcSymbol) => void

Parameters

symbol: TcSymbol

key: string

parent: TcSymbol

Returns void

Returns void

$off

Parameters

eventName: string

listener: (e: any) => void

Parameters

e: any

Returns void

Returns TcSymbol

$onInvalidated

Parameters

callback: (symbol: TcSymbol) => void

Parameters