TcNumericSymbol | tc-context

Class representing an instance of a PLC Symbol of Numeric Type.

Hierarchy

TcSymbol
- TcNumericSymbol

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.

Index

Constructors

constructor

Events

Accessors

Methods

Constructors

constructor

new TcNumericSymbol(path: string, parent: TcSymbol, pointer: TcSymbolPointer, params: TcNumericType, debug?: boolean): TcNumericSymbol

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

Parameters
- path: string
  
  The Path of this Symbol, relative to its origin point
- parent: TcSymbol
  
  Potential parent of this TcSymbol and to whom events will propagate to
- pointer: TcSymbolPointer
  
  The memory location of the Target PLC Symbol
- params: TcNumericType
  
  The Type parameters of this Symbol
- Default value debug: boolean = false
  
  If enabled, will produce debug information
Returns TcNumericSymbol

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(): TcNumericBinding

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

Returns TcNumericBinding

$get

get $get(): Promise<number>

Overrides TcSymbol.$get
- Defined in src/tc-symbol.ts:490
Returns the numeric value of this TcSymbol from the Target PLC Numeric 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<number>
- The value of the Target PLC Symbol

$lowerBorder

get $lowerBorder(): number | bigint

- Defined in src/tc-symbol.ts:475
Access the minimum value that can be written to this symbol

Returns number | bigint

$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

$upperBorder

get $upperBorder(): number | bigint

- Defined in src/tc-symbol.ts:469
Access the maximum value that can be written to this symbol

Returns number | bigint

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>

$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: number): Promise<number>

Overrides TcSymbol.$set
- Defined in src/tc-symbol.ts:519
Writes the provided numeric 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 numeric type

throws

TcBindingInvalidTypeException - Type-mismatch occurred when parsing Values to Data

throws

TcBindingReadOnlyException - Attempted to write to a ReadOnly Symbol

Parameters
- value: number
  
  The numeric value that is to be written to the Target PLC Symbol
Returns Promise<number>
- 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>

Protected __invalidate

__invalidate(): void

Inherited from TcSymbol.__invalidate
- Defined in src/tc-symbol.ts:310
Invalidates the TcBindingof this symbol, as well as, if a callback as provided in case of invalidation - will invoke it

Returns void

Hierarchy

Indexable

Index

Constructors

Events

Accessors

Methods

Constructors

constructor

Parameters

path: string

parent: TcSymbol

pointer: TcSymbolPointer

params: TcNumericType

Default value debug: boolean = false

Returns TcNumericSymbol

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 TcNumericBinding

$get

Returns Promise<number>

$lowerBorder

Returns number | bigint

$parent

Returns TcSymbol | undefined

$path

Returns string

$readOnly

Returns boolean

$upperBorder

Returns number | bigint

Methods

$clear

Returns Promise<void>

$off

Parameters

eventName: string

listener: (e: any) => void

Parameters

e: any

Returns void

Returns TcSymbol

$onInvalidated

Parameters

callback: (symbol: TcSymbol) => void

Parameters

symbol: TcSymbol

Returns void

Returns void

$once