读取网络发布共享变量的新值。新值到达或超时前，函数可阻止读取操作并继续执行，而非返回最新的数据值（可能已读取）。

使用该函数可避免读取已经读取的数据。如只需读取当前值，忽略数值更改，可使用读取变量函数。


icon

输入/输出

  • cgenclassrntag.png 共享变量引用句柄输入 —

    共享变量引用句柄输入是共享变量或I/O变量容器的引用。

    右键单击输入端，在快捷菜单中选择创建»输入控件或创建»常量，可创建该引用。单击控件，选择浏览，可显示浏览变量对象对话框。也可通过编程查找变量引用。该输入接线端也接受字符串值。如知道确切的NI-PSP变量地址，则可将地址输入到字符串控件中，并直接将字符串控件连接至该输入接线端。
  • cpoly.png 数据类型 —

    数据类型 指定共享变量或 I/O 变量容器的 数据类型 。对于I/O变量容器，必须指定数组数据类型。

    只有此前未指定数据类型时该输入才可用。勾选变量引用句柄属性对话框配置页的指定数据类型复选框，可指定数据类型。如通过打开连接指定数据类型，该接线端对后续的读写函数不可用。
  • ci32.png 超时时间(ms) —

    超时 (ms)指定函数在超时前等待的时间，以毫秒为单位。

    值-1表明永不超时。默认值为0。通过超时？输出可检测超时。
  • cerrcodeclst.png 错误输入（无错误） —

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • igenclassrntag.png 共享变量引用句柄输出 —

    共享变量引用句柄输出时共享变量或I/O变量的容器。

  • ipoly.png 数据输出 —

    数据输出是从共享变量或I/O变量容器读取的数据。

  • ibool.png 超时？ —

    超时？如在指定时间内无可用的新元素，将返回TRUE。

    如发生超时，函数将返回最后写入变量的值，不返回错误。
  • ierrcodeclst.png 错误输出 —

    错误输出包含错误信息。该输出提供标准错误输出功能。

  • iatrn.png 时间标识 —

    时间标识是表明当前数据写入共享变量时刻的时间标识。

    只有勾选变量引用句柄属性对话框配置页的读取时间标识复选框后，该输出才可用。I/O变量容器不支持时间标识。

    • 对于每个变量连接，第一次出现的值为新值。如多个函数共享相同的变量连接，函数的每个实例都可依据实例的执行顺序返回不同的值。

    注意 如使用该函数在打开变量连接之前访问共享变量，LabVIEW会自动打开变量的连接。但是，隐式打开连接会增加应用程序的抖动。访问变量之前，使用打开变量连接函数打开所有变量连接。