Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtGenListAllItems()

Get pointers to all the items in a list

Synopsis:

PtGenListItem_t **PtGenListAllItems( 
                      PtWidget_t *widget,
                      PtGenListItem_t **buffer );

Description:

This function fills the given buffer with pointers to all the list items.

If buffer is NULL, the function allocates a buffer by calling malloc(), and the buffer is NULL-terminated (or zero-terminated). It's your application's responsibility to free the buffer when it's no longer needed.

If buffer isn't NULL, the function doesn't add a NULL or zero to the end.

Returns:

A pointer to a buffer containing pointers to all the items in the list, or NULL.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtGenList, PtGenListItem_t