HPlogo System Debug Reference Manual > Chapter 10 System Debug Standard Functions

func civar

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

Returns the current value of a CI (MPE XL Command Interpreter) variable.

Syntax



   civar (civarname [stropt])

This function is implemented by calling the HPCIGETVAR intrinsic.

Formal Declaration



   civar:any (civarname:str [stropt:str="NOEV"])

Parameters


civarname

The name of the CI variable.

stropt

A string that determines whether the CI should attempt to evaluate the named variable.

EVALUATE

Evaluate the CI variable

NOEVALUATE

Do not evaluate the CI variable (Default)

This string parameter can be abbreviated.

Examples



   $nmdebug > wl civar ("hpgroup");
   DEMO

   $nmdebug > wl civar ("hpaccount");
   TELESUP

Display the current value of the CI variables named HPGROUP and HPACCOUNT.

   $nmdebug > wl civar( "hpusercapf" )
   SM,AM,AL,GL,DI,OP,CU,UV,LG,PS,NA,NM,CS,ND,SF,BA,IA,PM,MR,DS,PH

Display the current value of the CI variable HPUSERCAPF.

   $nmdat >: :showvar one
   ONE = !TWO
   $nmdat > :showvar two
   TWO = 2

   $nmdat > wl civar("one")
   !TWO
   $nmdat > wl civar("one" "EVAL")
   2

Two CI variables have already been defined. Variable one references variable two which is assigned the value of 2.

The first use of the function CIVAR defaults to NOEVALUATE, and as a result the value of one is returned as !TWO.

In the second use of the function CIVAR, the stropt is explicitly specified as EVALUATE, and so the MPE XL CI evaluates the value of one, which indirectly references the variable two, and the final result of 2 is returned.

Limitations, Restrictions


none




func cisetvar


func cmaddr