QueOpen

Open a queue for reading and writing data elements. Use this function to create a new queue or open an existing queue. Use queues for sending data from one task to another or for other buffering operations.

Syntax

QueOpen(Name, Mode)

sName:

The name of the queue. You need to use the following syntax:

Names need to begin with either an alpha character (A-Z or a-z) or the underscore character (_).

Any following characters need to be either alpha characters (A-Z or a-z), digit characters (0 - 9), period characters (.), backslash characters (\), or underscore characters (_).

The use of any other characters will result in the name being modified.

Mode:

The mode of the queue open:

0 - Open existing queue.

1 - Create new queue.

2 - Attempts to open an existing queue. If the queue does not exist, it will create it.

4 - Create a queue that can have multiple blocked readers.

Return Value

The queue handle, or -1 if the queue cannot be opened. The queue handle identifies the table where all data on the associated queue is stored.

Related Functions

QueClose, QueLength, QueRead, QueWrite, QuePeek

Example

! Create a queue.

hQue=QueOpen("MyQue",1);

! Write data into the queue.

QueWrite(hQue,1,"Quetext");

QueWrite(hQue,1,"Moretext");

! Read back data from the queue.

QueRead(hQue,Type,Str,0);

See Also

Task Functions