使任何数据输入转换为二进制值组成的平化数据字符串。此外,还可使用该函数转换已平化的数据字符串的字节顺序或endian格式。


icon

输入/输出

  • cunclst.png 任何数据

    任何数据中是要转换为UTF-8 JSON字符串的数据。该输入可接受布尔值、浮点数和字符串数组和簇。任何数据也接受这些数据类型的簇数组或数组簇。该输入端不支持其他数据类型。例如,枚举型、引用句柄、文件路径和定点数。

    簇元素可以全都有标签或全都没有标签,不能部分有标签,部分没有标签。如簇元素有名称,每个簇元素的名称必须是唯一的。如连接了不支持的数据类型,将会出现断线。

  • cbool.png 预置数组或字符串大小? (T)

    预置数组或字符串大小?指定当任何数据为数组或字符串时,LabVIEW在数据字符串的开始是否包括数据大小信息。如预置数组或字符串大小?的值为FALSE,LabVIEW将不包含大小信息。默认值为TRUE。

    “平化至字符串”函数创建的字符串是LabVIEW字符串。如预置数组或字符串大小?为TRUE,则LabVIEW字符串的开始位置有一个4字节(I32)的数,表示字符串的长度。可使LabVIEW字符串包括NULL字符[ASCII字符0(0)]。C字符串中的第一个NULL字符可视为字符串截止符,如传递LabVIEW字符串至外部代码并用作C字符串,字符串中的NULL字符可能会引起某些问题。预置数组或字符串大小?仅控制顶层数据大小信息。在层次结构数据类型(例如,簇)中的数组和字符串始终包括大小信息。

  • cenum.png 字节顺序(0:big-endian, network order)

    字节顺序用于设置返回的平化字符串中数据的endian形式。字节顺序,或endiann形式,表明在内存中整数是否按照从最高有效字节到最低有效字节的形式表示,或者相反。

    0big-endian, network order (默认)-最有意义字节占用最低内存地址。
    1native, host order-使用主机的字节顺序格式。
    2little-endian-最低有效字节占据最低的内存地址。
  • cerrcodeclst.png 错误输入(无错误)

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

  • istr.png 数据字符串

    数据字符串是由函数生成的平化数据

    数据字符串可能每个非标量元素前都包含用于描述大小的头信息。该字符串可存储在文件中或通过网络发送。如通过网络发送字符串,接收方必须对其进行解读。通常,LabVIEW使数据存储为非连续、无直接引用的片。函数可复制LabVIEW格式的数据至连续的缓冲区数据字符串。通过从字符串还原函数可使数据字符串转换为任意的数据类型。

  • i1di16.png 类型字符串(仅用于7.x)

    类型字符串(仅限 7.x) 只有在终端已从以前版本的 LabVIEW 布线或右键单击函数并从快捷菜单中选择 转换 7.x 数据 时才可见。 类型字符串(仅限 7. x)是 编码的二进制 数据字符串 描述类型字符串(仅限 7.x)从字符串解平坦化 函数中输入的 类型 不同。

    类型字符串(仅用于7.x)不能表示连线至任何数据的数据类型,函数可返回错误。

  • ierrcodeclst.png 错误输出

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

  • 如要进行不会产生平化数据的简单数据类型转换,可使用“强制类型转换”函数。

    如需使类型描述符数据平化为LabVIEW 7.x或更早版本可读取的字符串,可右键单击函数,在快捷菜单中选择转换7.x数据。在转换7.x数据模式下,该函数显示类型字符串(仅用于7.x)输出端,并在函数上显示红色的7.x标识。LabVIEW 7.x及更早版本将类型描述符保存为16位平化数据。。而LabVIEW 8.0及更高版本将类型描述符保存为32位平化数据。从长远考虑,NI建议重新构建使用转换7.x数据模式的应用程序。

    如需使布尔数据平化为LabVIEW 4.x或前期版本可读取的字符串,可右键单击函数,在快捷菜单中选择转换4.x数据。只有连线布尔数据类型至任何数据接线端,转换4.x数据快捷菜单项才可见。在转换4.x数据模式下,该函数可以LabVIEW 4.x数据存储格式写入数据,并在函数上显示红色的4.x标识。LabVIEW 4.x或更早版本使用两个字节存储布尔数据,但是,如数据位于数组中,LabVIEW使用一个比特存储各布尔元素。LabVIEW 5.0或更高版本中,无论布尔值是否在数组中,都只用一个字节存储布尔值。从长远考虑,NI建议重新构建使用转换4.x数据模式的应用程序。

    如使用该函数处理变体数据,LabVIEW将对变体的所有内容(包括其属性)进行平化处理。但是,如使用“变体平化至字符串”函数,LabVIEW将只对变体进行平化处理,忽略所有属性。

    如使用该函数平化保存为自定义类型的自定义控件的数据,该函数将删除自定义类型的包装。如不希望删除包装,可右键单击函数,在快捷菜单中选择显示自定义类型。只有将数据连线至类型字符串(仅用于7.x)时,显示自定义类型快捷菜单项才可见。