F.69 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 Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide 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, and ctThrdQueueWrite.