(Filename: Actor Framework.lvlib:Message Enqueuer.lvclass:Equals Not A Refnum.vi)

Checks whether a message enqueuer reference is equal to Not a Refnum. Unlike the Not a Number/Path/Refnum? function, this function does not check whether a non-zero reference still is valid. Refer to the detailed help for more information.


icon

Inputs/Outputs

  • cActor_Framework_lvlib_Message_Enqueuerlvclass.png Message Enqueuer —

    Message Enqueuer specifies a message enqueuer to check.

  • ibool.png Not a refnum? —

    Not a refnum? returns TRUE if Message Enqueuer is equal to Not a Refnum, in which case you should not attempt to use this reference to send a message.

    This output returns FALSE in all other situations, including when Message Enqueuer is a non-zero refnum that has been released already. In these situations, send the message and then check for an error on that operation.

    • This function only checks whether Message Enqueuer is equal to Not a Refnum. It does not check whether Message Enqueuer still is valid because doing so can introduce a race condition into the application. It is possible for a refnum to become invalid after being declared valid but before a message is sent to it.