返回队列的引用。

在调用其他队列操作函数时使用该引用。


icon

输入/输出

  • ci32.png 队列最大值（-1，无限） —

    队列最大值是队列要保持的元素的最大数量。

    默认值为–1，表示队列的元素数量没有限制。

    如队列达到队列最大值，则元素入队列或队列最前端插入元素函数等待，直至元素出队列或清空队列函数删除队列的所有元素。

    如存在具有相同名称的队列，LabVIEW可忽略该输入并使用已有队列的大小。

    注： (实时模块）在 RT 目标机上运行时， 最大队列大小 会在标量数据类型队列中预先分配指定数量的元素。
    注： 不在RT终端上运行时，队列最大值只限制队列的元素数，不预先分配队列。如需预分配队列内存，可在队列中插入所需数量的元素，刷新队列。分配给队列的内存可在以后使用。关于队列内存分配的更多信息，见详细信息。
  • cstr.png 名称（未命名） —

    名称包含要获取或创建的队列的名称。

    默认值为空字符串，用于创建无名称的通知器。
  • cfxdt.png 元素数据类型 —

    元素数据类型是需要队列包含的数据类型。

    该输入端可连线任意数据类型。
  • cbool.png 如未找到则创建？(T) —

    如未找到是否创建？指定名称指定的队列不存在时，是否创建新的队列。

    如值为TRUE（默认值），指定名称的队列不存在时，函数可创建新的队列。
  • cerrcodeclst.png 错误输入（无错误） —

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

  • iqueuern.png 队列输出 —

    队列输出是对已有队列或函数创建的新队列的引用。

  • ibool.png 新建？ —

    新建？函数创建新的队列时，值为TRUE。

  • ierrcodeclst.png 错误输出 —

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

    • 入队或出队可调整大小的数据类型（例如，路径、字符串和数组），不影响队列使用的内存大小。队列可传递数据，但不生成数据副本。有损耗元素入队列函数可避免元素在等待插入已满队列时导致判断循环抖动。

    通过已命名队列可在同一程序框图的两个部分间传递数据，或在同一应用程序实例的两个VI间传递数据。如未连线名称，该函数可创建新的未命名的队列引用。如连线名称，该函数可在现有的队列中搜索具有相同名称的队列并返回该队列的新引用。如不存在具有相同名称的队列且如未找到是否创建？为TRUE，则该函数可创建新的已命名的引用。

    如使用该函数返回循环内部某个已命名队列的引用，LabVIEW可在每次循环执行时创建该已命名队列的新的引用。如在循环中使用该函数，因为每个新引用都使用额外的4个字节，LabVIEW可逐渐占用更多的内存。VI停止运行时可自动释放字节。然而，对于持续时间较长的应用程序，内存占用的持续增加可能使LabVIEW的表现类似发生内存溢出。在循环中使用释放队列引用函数可释放每次循环的队列引用，防止不必要的内存占用。

    该函数可能返回的错误代码包括：1、2、1094、1100、1491或1548。

    注：

    队列或已命名队列不可用于应用程序实例之间的通信。如试图与另一应用程序实例中的已命名队列通信，LabVIEW并不返回错误，但结果可能无法预期。

    在一个应用程序实例中获取的队列引用，不能在另一个应用程序实例中使用。在另一个应用程序实例中使用队列引用时，LabVIEW返回错误1491。

    范例

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

    • labview\examples\Synchronization\Queue\Queue Overflow and Underflow.vi