tan

tanh

Get the hyperbolic tangent of an angle in radians.

TimeHour

TimeHundredth

Number if successful, or DateAndTime.Error! if not.

TimeMinute

TimeSecond

Return a number representing the second.

Number if successful, or DateAndTime.Error! if not.

TimeString

Return the time in a string.

vCurrentTime := TimeString (; "h:m:ss tt")

MessageBox (x; "TimeString"; vCurrentTime)

Result (format): 3:52:34 PM

TimeZoneInfo

ToInitialCaps

ToLower

Convert uppercase letters to lowercase.

The value returned by ToLower can be assigned to a variable or used directly by a statement such as If.

vAnswer := "YES"
vAnswer := ToLower(vAnswer)

Result: vAnswer equals lowercase yes

If(ToLower(vAnswer) = "yes")
 Beep
Else
 Quit
EndIf

Explanation: Beep if vAnswer equals lowercase yes.

ToUpper

Convert lowercase letters to uppercase.

The value returned by ToUpper can be assigned to a variable or used directly by a statement such as If.

vAnswer := "yes"
vAnswer := ToUpper(vAnswer)

Result: vAnswer equals uppercase YES

If(ToUpper(vAnswer) = "YES")
 Beep
Else
 Quit
EndIf

Explanation: Beep if vAnswer equals uppercase YES.

True

The constant boolean value TRUE.

UnitStr

Convert a measurement to a character string.

If a unit of measure is not specified, the default is WordPerfect (WP) units. To change the default, use DefaultUnits. The following example converts WP units to centimeters and returns the result as a string:

Units := UnitStr(1200; Centimeters!)

Result: vUnits equals "2.540000C"

The next example converts centimeters to millimeters and returns the result as a string:

DefaultUnits(Centimeters!)

vUnits := UnitStr(1.0; Millimeters!)

Result: vUnits equals "10.000000M"

The next example converts inches to centimeters and returns the result as a string:

vUnits := UnitStr(2.0i; Centimeters!)

Result: vUnits equals "5.080000C"

See StrUnit to convert a string of numbers to a measurement expression.

Until

Use

Specify a macro file with functions and/or procedures that can be called from another macro.

Use is a non-executable statement that can occur anywhere in a macro. A macro with a calling statement to a function or procedure in another macro file must include a Use statement that identifies the file.

A Use macro file that includes only function and/or procedure statements must be compiled like any macro file (see Macro File Libraries in Chapter 5: Conditional, Loop, and Calling Statements). Corel PerfectScript automatically compiles uncompiled Use macros. Macro execution stops if the macro will not compile.

Macro files identified by multiple Use statements are searched from first to last. Thus a parent macro always calls the first occurrence of a function or procedure with the same name in different Use files.

Value

Notes

If specifying a product command name, do not enclose the command in quotes. For example, x := Value(MessageBox).

If specifying a product command parameter enumeration, use the product command name, a period, the parameter name, a period, and the enumeration. For example, x := Value(MessageBox.Style.OKCancel!).

If using this command to obtain the value of a product command return enumeration value, specify the product command name, a period, and the return enumeration name. For example, x := Value(PersistAll.On!).

Using Value to obtain enumeration values is optional. The following syntax is also correct: x := MessageBox.Style.OKCancel! or x := PersistAll.On!

ValueType

Declare vNmbr = 10.0
If (ValueType.Type.Float!)
 MessageBox (x; "ValueType"; ValueType (vNmbr; Float!)
Endif

Result: MessageBox displays True

If (ValueType(vNmbr) = ValueType.Type.Integer!)
 Beep
Else
 MessageBox (x; "ValueType"; "vNmbr is not an integer value")
Endif

Result: MessageBox displays "vNmbr is not an integer value"

VarErrChk

VersionInfo

Return Value

Wait

While

A loop statement that executes while the expression at the top of the loop is true (see Loop Statements in Chapter 5: Conditional, Loop, and Calling Statements).

The loop does not execute the first time unless Test is true. When Test is false, the first statement after EndWhile is executed.

The general form of a While statement is:

While (<Test> boolean)
 ...statement block...
EndWhile

With

WordCount

The number of words in a string.

WPString

ReturnValue

XOR