[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
BLANK()
Creates a blank value for each data type
------------------------------------------------------------------------------
Syntax
BLANK([<expValue>], [<lMode>]) --> xBlank
Arguments
<expValue>[@] Designates any valid expression; the type is not
important.
<lMode> Designates whether or not the length of the <expValue> is
to change in the event that <expValue> is a string. If .T. is
designated, the length is retained. The default value is Change Length
(.F.).
Returns
BLANK() returns a blank value with the same data type as the <expValue>
parameter.
Description
BLANK() clears desired data fields with the variables. BLANK() returns
the following results:
Table 13-1: Data Type Blank Values
------------------------------------------------------------------------
Argument Returned Value
------------------------------------------------------------------------
Character string Null string or blank string
Numeric Value of 0
Logical .F.
Date A blank date
------------------------------------------------------------------------
The default for <lMode> is .F. and produces a null string when a
character string is input. However, if this parameter is designated as
.T.., the string length is not changed.
Notes
. SET DATE has no affect on how BLANK() handles a date. The
blank date display is created in the format you select.
. You can suppress the value this function returns by
manipulating strings through CSETREF() implementation. To save room
in the working memory, designate <lMode> as .T..
Example
Display blank values for data-type values:
SET DATE AMERICAN
? BLANK(DATE()) // " / / "
? BLANK() // .F.
? BLANK(.T.) // .F.
? BLANK(99) // 0
? BLANK("abc") // ""
? BLANK("11:59:59") // ""
? BLANK("abc", .T.) // " " Blank string
See Also:
CSETREF()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson