Returns TRUE if number/path/refnum is not a number (NaN), <Not a Path>, or not a refnum. Otherwise, this function returns FALSE.

Use this function to make sure a reference to an object, such as a VI, application, or control, still resides in system memory and was not closed.

The connector pane displays the default data types for this polymorphic function.


icon

Inputs/Outputs

  • cdbl.png number/path/refnum —

    number/path/refnum can be a scalar number, path, or refnum, or it can be a cluster or array of numbers, paths, or refnums.

  • ibool.png NaN/Path/Refnum? —

    NaN/Path/Refnum? is a Boolean value of the same data type structure as number/path/refnum.

    • This function works only on references generated by LabVIEW functions. Do not use this function to determine the validity of a rendezvous refnum, semaphore refnum, or any refnum created by the GOOP wizard, LabVIEW Database Connectivity Toolkit, or LabVIEW Internet Toolkit. For rendezvous refnums, use the Not A Rendezvous VI. For semaphore refnums, use the Not A Semaphore VI. For all other GOOP refnums or toolkit refnums, use the Vis defined by the refnum creator.

    To avoid race conditions when evaluating the refnum status, National Instruments recommends limiting the usage of this function in the following ways:

    • Do not use this function to evaluate whether a refnum is invalid before using the refnum.
    • Use this function in custom probes to get the refnum status.
    • Use this function to evaluate the status of an existing invalid refnum before evaluating a new refnum.
    • Use this function to evaluate the status of a refnum before using another refnum.
    • Consider using semaphores to protect code that the function executes conditionally.

    FPGA Module Details

    The following details apply when you use this object in an FPGA VI.

    Note The following details are subject to change with each version of the LabVIEW FPGA Module.
    Single-Cycle Timed Loop Supported.
    Usage The FPGA Module supports only the Not A Number functionality.
    Timing This function requires no clock cycles to execute because it does not include an internal register.
    Resources This function consumes FPGA resources only when the input is single-precision floating-point (SGL). When the input is anything other than a SGL, the function returns a FALSE constant and is optimized out if not connected to other logic.