[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NUL()
 Converts the value returned by a function into a null string
------------------------------------------------------------------------------
 Syntax

     NUL(<expValue>) --> cNull

 Argument

     <expValue>  Designates an expression or function that has a return
     value you want to suppress.

 Returns

     NUL() always returns a null string as a value.

 Description

     NUL() converts a function that returns a value into a function that
     returns a null string.  This suppresses the returned value for every
     function.

 Note

     .  The function is not VOID.  It returns a value of a specific
        data type -- a (null) string.  Therefore, you cannot use this
        function to compare with other data types (see Examples).

 Examples

     .  Wait for a key stroke:

        ? "Please press a key  :" + NUL(INKEY(0))

     .  Show output that uses LIST and waits for a key stroke after 20
        lines:

        LIST Name, IF(RECNO() %20 = 0, NUL(INKEY(0)), "")

     .  This leads to a TYPE MISMATCH:

        ? 3 = NUL(INKEY(5))         //  Error after 5 seconds
        ? 7 + NUL(INKEY())          //  Leads to error, like saying 7+""


This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson