将客户端缓冲区（与连接输入中指定的连接相关）的下一个可用数据移出队列并返回该数据。

注： 客户端缓冲也适用于其它协议，比如opc和file协议。但是，在某些情况下服务器可能丢失数据。


icon

输入/输出

  • cstr.png 连接输入 —

    连接输入指定要读取的数据源。

    connection in 可以是描述 url的字符串、 共享变量控件、 数据套接字打开 函数输出的 连接 id 引用参数或 数据套接字写入 函数输出的 连接 输出参数。

  • cfxdt.png 类型（变体） —

    类型（变体）指定要读取数据的类型，并定义数据输出接线端的类型。默认的类型为变体，任意类型。

    连线任意数据类型至输入端可定义输出数据类型。LabVIEW忽略输入数据的值。

  • ci32.png 毫秒超时(10000) —

    超时毫秒指定用于等待连接缓冲区中可用更新值的时间。

    如等待更新值的值为FALSE且初始值已到达，函数忽略该输入并并取消等待。默认值为10000毫秒（10秒）。

  • cerrcodeclst.png 错误输入（无错误） —

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

  • cbool.png 等待更新值(T) —

    等待更新值如设置为TRUE，函数可等待新值。

    如连接缓冲区包含未处理的数据，函数可立即返回下一个可用值。否则，函数可等待毫秒超时以获取更新。如在超时周期内未出现新的值，函数可返回当前值并设置超时为TRUE。如等待更新值的值为FALSE，函数可返回连接缓冲区中的下一个可用值，如无可用值，可返回前一个值。

  • iu32.png 状态 —

    状态报告来自PSP服务器或FieldPoint控制器的警报或错误。如果第 31 位为 1，则 状态 表示出错。否则，状态是状态代码。

  • iu64.png 质量 —

    质量是从共享变量或NI发布-订阅协议(NI-PSP)数据项读取的数据的数据质量。质量的值可用于调试VI。

    下表列出了可能的质量值。

    位 说明
    1 该共享变量的值可能不是来自数据源的当前值。
    2 传感器失败。
    3 常规设备出错响应。
    4 服务器错误。
    5 常规通信失败。
    6 无法在共享变量引擎中定位变量。变量部署可能失败。
    7 共享变量含有未知值。
    8 共享变量处于非活动状态。
    10 下限。
    11 上限。
    12 常量。
    13 传感器不精确。
    14 超出工程单位范围。
    15 一般OPC错误。
    16 数学错误。
    17 通信链接失败。
    18 NI-PSP尚未连接到服务器。
    19 服务器DNS查找失败。
    20 无法连接服务器。
    21 服务器服务查找失败。
    22 服务器连接被断开。
    23 进程未找到或未响应。
    24 无法解析共享变量的URL。
    25 共享变量的读权限被禁止。
    26 共享变量的URL无效。
    30 该点存在活动预警。
    31 订阅失败。
    32 大于32的质量位被置位或存在错误/状态报告。
    33 共享变量客户端的“读取缓存”已满。
    34 共享变量客户端的“读取缓存”溢出。
    35 共享变量服务端的“写入缓存”已满。
    36 共享变量服务端的写入缓存溢出。
  • istr.png 连接输出 —

    连接输出是指定数据连接的数据源。

  • ifxdt.png 数据 —

    数据是读取的数据。如函数超时，数据返回函数最后读取的值。如函数在尚未读取数据前就已经超时，或数据类型不兼容，数据可返回0、空或等同的值。

  • ibool.png 超时 —

    超时如函数等待更新值或初始值时超时，则值为TRUE。

  • ierrcodeclst.png 错误输出 —

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

  • iatrn.png 时间标识 —

    时间标识返回共享变量和NI-PSP协议数据项的时间标识数据。

    • 范例

    请参考LabVIEW附带的下列范例文件。

    • labview\examples\Data Communication\DataSocket\Simple DataSocket\Simple DataSocket.lvproj