Previous Topic

Next Topic

ctThrdQueueCount

Returns the number of entries in a queue.

Short Name

ctThrdQueueCount()

Type

Threading function

Declaration

LONG ctThrdQueueCount(NINT qid)

Description

Returns the number of entries in the queue qid. If an error occurs, ctThrdQueueCount() returns a negative value corresponding to the error code negated.

Return

See Description.

Value

Symbolic Constant

Explanation

0

NO_ERROR

Successful function.

90

NQUE_ERR

Invalid qid.

514

CQUE_ERR

Queue could not be closed.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.

Limitations

Can only be used with a ctThrd library.

See also

ctThrdQueueClose(), ctThrdQueueOpen(), ctThrdLIFOWrite(), ctThrdQueueMlen(), ctThrdQueueRead(), ctThrdQueueWrite()