Tests if a character string contains only letters and digits.
Syntax
$isalphanumeric(string)
Parameters
string | a character string or an expression that evaluates to a character string |
Return Value
1-character binary string. Evaluates to 1 ($True) if string meets the validation test; otherwise, evaluates to 0 ($False).
Comments
This function tests if a particular character string is alphanumeric.
Example
$isalphanumeric("abc1")
Evaluates to $True.
$isalphanumeric("abc ")
Evaluates to $False.
See Also
$isalphabetic
$isdate
$isdigit
$isdigit
$isnumber
$isupper
$iszimname
$trim
Character Literals
Functional Expressions
Left-justifies a character string.
Syntax
$leftjustify(string)
Parameters
string | a character string or an expression that evaluates to a character string |
Return Value
Character string.
Comments
String is left-justified in a space that is $length(string) characters long. Leading spaces in string are ignored.
Example
$leftjustify(" abcde")
Evaluates to “abcde “.
$leftjustify(var1)
Evaluates to “3 ” if var1 is a LONGINT variable whose value is 3 (occupies 12 character spaces when converted to a string).
See Also
$center
$rightjustify
About Character Literals
About Functional Expressions
Conversion Between Data Types
Returns the absolute value of a number.
Syntax
$absolute(number)
where
number | a number, or an expression that evaluates to a number |
Return Value
Number, positive, with the same number of decimal places as number.
Comments
Use $absolute to ensure that a number is positive (for functions such as $sqrt, for example). $absolute returns the absolute (unsigned) value of a number. The absolute value is always treated as positive.
Example
Certain functions – for example, $sqrt – accept only positive arguments. You can use $absolute to ensure that all arguments to these functions are positive.
$sqrt($absolute(-0.98))
evaluates as if it were:
$sqrt(0.98)
See Also
About Functional Expressions
Converts alphabetic characters to lower case.
Syntax
$tolower(source)
Parameters
source | any value, or an expression that yields any value |
Return Value
Character string.
Comments
Returns a character string in which all letters are lower case. If source is not of a character data type, it is converted to a character data type before the function is applied.
Example
$tolower("the QUICK BROWN fox is 30 years oLD")
Evaluates to “the quick brown fox is 30 years old”.
output "Do you want output to go to the printer? (y/n)"
input <1>
if $tolower("#<1>") = "y" % makes user response case insensitive
set output printer
endif
Ensures that the user response is case-insensitive.
See Also
$toupper
About Character Literals
About Functional Expressions
Determines the month name associated with a specified date value.
Syntax
$monthname(date)
Parameters
date | a data, or an expression that evaluates to a date, in the form YYYYMMDD |
Return Value
Character string.
Comments
This function extracts month information from standard date values. Date is often the system variable $Date.
The values returned by the $monthname function can be changed with the Language Customizer utility, ZIMLANG.
Example
$monthname(19981225)
Evaluates to “December”.
$monthname($date+7)
Evaluates to “January” when $Date is 19981225.
See Also
$Date
$day
$dayname
$month
$weekday
$year
About Data Types
About Functional Expressions
Tests if a character string is a valid date.
Syntax
$isdate(string)
Parameters
string | a character string or an expression that evaluates to a character string |
Return Value
1-character binary string. Evaluates to 1 ($True) if string meets the validation test; otherwise, evaluates to 0 ($False).
Comments
This function tests if a particular character string is a valid date.
Example
$isdate("19980606")
Evaluates to $True.
$isdate("19980229")
Evaluates to $False.
$isdate($date)
Evaluates to $True.
$isdate($date+30)
Evaluates to $True.
See Also
$isalphabetic
$isalphanumeric
$isdigit
$islower
$isnumber
$isupper
$iszimname
Character Literals
Functional Expressions
Calculates the sine of a number.
Syntax
$sin(number)
Parameters
number | a number, or an expression that evaluates to a number |
Return Value
Number, with the same number of decimal places as number.
Comments
The value returned by this function has the same number of decimal places as number. Ensure that you specify enough decimal places in your equation to ensure a sufficiently granular result. Unusual results such as
-0 are an indication that the number of decimal places needs to be increased. For example, if you enter
$sin(4)
without any decimal points, you receive the result
-1
However, if you enter
$sin(4.0000)
you receive the result
-0.7568
Example
let var1 = $sin(0)
Evaluates to 0.
See Also
$asin
$cos
$sinh
$tan
About Functional Expressions
Right-justifies a character string.
Syntax
$rightjustify(string)
Parameters
string | a character string, or an expression that evaluates to a character string |
Return Value
Character string, consisting of string right-justified in a space $length(string) characters long. Trailing blanks in string are ignored.
Example
$rightjustify("abcde ")
Evaluates to ” abcde”.
$rightjustify(var1)
Evaluates to ” 3″ if var1 is a LONGINT variable whose value is 3 (occupies 12 character spaces).
See Also
$center
$leftjustify
About Character Literals
About Functional Expressions
Conversion Between Data Types
Sums a set of values, excluding those in which the expression is $Null.
Syntax
$total(expression)
Parameters
Return Value
Number.
Comments
Expression is often a WHERE expression that includes only selected values in the totalling operation. If the WHERE expression (expr1 WHERE expr2) is true, the expr1 value is included in the operation; otherwise, expression is considered $Null and is not included.
Example
compute Employees where DeptName="Sales"
evaluate(let TotSal = $total(Salary))
(let TotSalF = $total(Salary where Sex = "F"))
Finds the total of all employees’ salaries, and the total of the salaries of all female employees, in the Sales department.
See Also
$average
$count
$max
$min
About Functional Expressions
Number Literals
Calculates the hyperbolic cosine of a number.
Syntax
$cosh(number)
Parameters
number | a number, or an expression that evaluates to a number, representing an angle (in radians) |
Return Value
Number, with the same number of decimal places as number. Ensure that you specify enough decimal places in your equation to ensure a sufficiently granular result. Unusual results such as -0 are an indication that the number of decimal places needs to be increased. For example, if you enter
$cosh(5)
without any decimal points, you receive the result
74
However, if you enter
$cosh(5.0000)
you receive the result
74.2099
Comments
This function calculates the hyperbolic cosine of a number.
Example
let vAngle = $cosh(3.000)
Variable vAngle is set to 10.068.
See Also
$acos
$cos
$sinh
$tanh