MakeText Function

Format:

s = maketext(string-exp[,p1[,p2[,...,pn]]]);

 [ ] indicates that this part is optional.

Description:

The maketext function formats a text string with inserted values. Each argument (e.g., "p1") is sequentially inserted into the text string. Arguments can be numeric or alphanumeric expressions, but the type of the argument must match the type of the receiving field in the string expression.

In the "string expression",

%[n]d = Insert a number and display it as an integer

%[n.d]f = Insert a number and display it as a decimal value

%[n.d]s = Insert a text string

where "n" is the size of the field and "d" is the number of decimal places to show for a number.

Numbers are never truncated. Text strings are truncated only if ".d" is used. If "n" is positive, the insert is right justified in the size of the field. If "n" is negative, the insert is left-justified in the size of the field. If "n" is a positive number with a leading zero, the insert is right-justified in the size of the field and zero-filled to the left. When inserting a number, if "n" is preceded by a "+", the sign of the number is always displayed.

Return Value:

The function returns the formatted string.

Example 1:

TEXT = maketext("Sex = %d", SEX);

Example 2::