PointGet (function)

Syntax

PointGet(pointId$)

Description

To read a particular point and return the value.

Comments

Parameter

Description

 

pointId$

String. The Point ID to get the value from.

Example

' Prompt user for point id, get the point value and display

' it into a message box.

sub main()

   MsgBox "Value is " & PointGet(InputBox$("Enter Point Id") )

end sub

See Also

PointGetMultiple (function)

Important: For CIMPLICITY Machine Edition's array point names

Enclose CIMPLICITY Machine Edition array point names (that are passed through CIMPLICITY Plant Edition Basic) in the the ASCII encoding for single quotes Chr$(39).

The reason is as follows:

CIMPLICITY Machine Edition returns array points as single values using the form name[index].

When a CIMPLICITY Machine Edition's array point name:

Is not enclosed in Chr$(39), BASIC will parse this out as a reference to an array element. You will receive an error indicating a bad point name.

Is enclosed in Chr$(39) the point will not be parsed in the PointSet and PointGet BASIC procedures. The name will be passed straight through to Machine Edition.

Note: You cannot directly put a single quote (') on an argument line because the single quote in Basic denotes that the remainder of the line is a comment.

Examples

val = PointGet("MyPointName")

Result

PointGet receives. MyPointName

val = PointGet(Chr$(39) & "MyPointName[10]" & Chr$(39))

Result

PointGet receives 'MyPointName[10]'

More information

CIMPLICITY Extensions to Basic