Reads a new value from a network-published shared variable. Instead of returning the latest data value, which might have been read already, this function performs a blocking read, which means the function does not finish executing until a new value arrives or the timeout you specify expires.

Use this function to avoid reading data values that you already have read. If you need to read the current value regardless of whether the value changes, use the Read Variable function.


icon

Inputs/Outputs

  • cgenclassrntag.png shared variable refnum in —

    shared variable refnum in is the reference to the shared variable or I/O variable container.

    You can right-click this input terminal and select Create»Control or Create»Constant to create this reference. You then can click the control or constant and select Browse to display the Browse Variable Objects dialog box. You also can find variable references programmatically. This input terminal accepts string values too. If you know the exact NI-PSP variable address, you can type the address into a string control and directly wire that string control to this input terminal.
  • cpoly.png data type —

    data type specifies the data type of the shared variable or I/O variable container. For I/O variable containers, you must specify an array data type.

    This input is available only if the data type has not been previously specified. You can specify a data type by placing a checkmark in the Specify Data Type checkbox on the Configuration page of the Properties dialog box for the variable refnum. If you specify the data type upon opening the connection, this terminal is unavailable on subsequent read and write functions.
  • ci32.png timeout ms —

    timeout ms specifies the time, in milliseconds, that the function waits before timing out.

    A value of –1 specifies no timeout. The default is 0. Use the timed out? output to detect a timeout.
  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • igenclassrntag.png shared variable refnum out —

    shared variable refnum out is the reference to the shared variable or I/O variable container.

  • ipoly.png data out —

    data out is the data read from the shared variable or I/O variable container.

  • ibool.png timed out? —

    timed out? is TRUE if a new element does not become available within the timeout you specify.

    If the timeout expires, this function returns the last value written to the variable and does not return an error.
  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

  • iatrn.png timestamp —

    timestamp is the timestamp indicating when the current data was written to the shared variable.

    This output is available only if you place a checkmark in the Read Timestamp checkbox on the Configuration page of the Properties dialog box for the variable refnum. I/O variable containers do not support timestamps.

    • Each variable connection treats a value as new only once. If multiple Read Variable with Timeout functions share the same variable connection, each instance of the function returns a different value depending on the order in which the instances execute.

    Caution If you use this function to access a shared variable without first opening a connection to the variable, LabVIEW automatically opens a connection to the variable. However, this implicit open operation can add jitter to the application. Therefore, National Instruments recommends that you open all variable connections with the Open Variable Connection function before accessing the variables.