KURZBESCHREIBUNG VERIFIER - Ct-pen.com

CT-PEN Technische Dokumentation FormVerifier © 2012 Rudolf Reinthaler Seite 44
Characters for a PICTURE mask can follow the characters for the PICTURE function. When a
mask is also specified, the PICTURE function and mask must be separated from one another by
a single blank space.
PICTURE mask
A PICTURE mask contains formatting rules for each individual character of the transformed
value. As with the PICTURE function, formatting characters are specified which define a specific
formatting rule. Each character in the PICTURE mask corresponds to a character in the
return character string. The possible formatting characters for a PICTURE mask are listed in
the following table:
Characters for the PICTURE mask
Character Formatting rule
A,N,X,9,# Displays characters for each data type
L Displays logical values as "T" or "F"
Y *) Displays logical values as "Y", "J" or "N"
! Transforms alphabetical characters to upper case
$ Replaces leading blank spaces in numbers
with a dollar sign ($)
* Replaces leading blank spaces in numbers
with a star (*)
. Marks position for a decimal point
, Marks position for a comma
*) Display is country-specific, see SetLocale()
Any characters in the PICTURE mask which are not listed in this table are copied into the
return character string. When the PICTURE function @R is used, these characters are inserted
into the return character string, otherwise they replace characters in the return character
string.
Country-specific formatting of numbers
When transforming numbers to character strings, Transform() uses the number format set by
the system configuration which results in a decimal point or comma after each setting. When
converting a numeric to a string and a decimal point is desired instead of a decimal comma
regardless of the system configuration, the numeric value should be transformed by the function
Str() instead of Transform(). Example:
nNumber := 12.345
cStringA := Transform( nNumber, "@N" ) // may result in
// "12,345" or "12.345"
cStringB := Str( nNumber, 6, 3 ) // is always "12.345"
nNumberA := Val( cStringA ) * 10 // may result in
// 120 or 123.45
nNumberB := Val( cStringB ) * 10 // is always 123.45
When using Transform() to perform conversions and the comma is defined as the delimiter for
decimal places in the system settings, a comma is inserted into the formatted result string.
Changing the character string back to a numeric value using the function Val() may then lead
to erroneous results since Val() only works with a decimal point and not with a decimal
comma.
Example
// Transform()
// The example demonstrates how various values can be
// formatted by Transform().
PROCEDURE Main
LOCAL xValue
© b y R u d o l f R e i n t h a l e r S o f t w a r e e n t w i c k l u n g • A l t e r b a c h s t r a s s e 6 • A - 5 0 2 0 S a l z b u r g
w w w . c t - p e n . c o m • K O N T A K T : r . r e i n t h a l e r @ c t - p e n . c o m