list.h File Reference

Data Structures
struct	xLIST
struct	xLIST_ITEM
struct	xMINI_LIST_ITEM

Macros
#define	listCURRENT_LIST_LENGTH(pxList)   ( ( pxList )->uxNumberOfItems )
#define	listGET_ITEM_VALUE_OF_HEAD_ENTRY(pxList)   ( (&( ( pxList )->xListEnd ))->pxNext->xItemValue )
#define	listGET_LIST_ITEM_VALUE(pxListItem)   ( ( pxListItem )->xItemValue )
#define	listGET_OWNER_OF_HEAD_ENTRY(pxList)   ( (&( ( pxList )->xListEnd ))->pxNext->pvOwner )
#define	listGET_OWNER_OF_NEXT_ENTRY(pxTCB, pxList)
#define	listIS_CONTAINED_WITHIN(pxList, pxListItem)   ( ( pxListItem )->pvContainer == ( void * ) ( pxList ) )
#define	listLIST_IS_EMPTY(pxList)   ( ( pxList )->uxNumberOfItems == ( unsigned portBASE_TYPE ) 0 )
#define	listSET_LIST_ITEM_OWNER(pxListItem, pxOwner)   ( pxListItem )->pvOwner = ( void * ) ( pxOwner )
#define	listSET_LIST_ITEM_VALUE(pxListItem, xValue)   ( pxListItem )->xItemValue = ( xValue )

Typedefs
typedef struct xLIST	xList
typedef struct xLIST_ITEM	xListItem
typedef struct xMINI_LIST_ITEM	xMiniListItem

Functions
void	vListInitialise (xList *pxList)
void	vListInitialiseItem (xListItem *pxItem)
void	vListInsert (xList *pxList, xListItem *pxNewListItem)
void	vListInsertEnd (xList *pxList, xListItem *pxNewListItem)
void	vListRemove (xListItem *pxItemToRemove)

#define listCURRENT_LIST_LENGTH

(

pxList

)

( ( pxList )->uxNumberOfItems )

Referenced by portTASK_FUNCTION().

#define listGET_ITEM_VALUE_OF_HEAD_ENTRY

(

pxList

)

( (&( ( pxList )->xListEnd ))->pxNext->xItemValue )

#define listGET_LIST_ITEM_VALUE

(

pxListItem

)

( ( pxListItem )->xItemValue )

Referenced by prvCheckDelayedList(), and vTaskIncrementTick().

#define listGET_OWNER_OF_HEAD_ENTRY

(

pxList

)

( (&( ( pxList )->xListEnd ))->pxNext->pvOwner )

Referenced by prvCheckDelayedList(), prvCheckPendingReadyList(), prvCheckTasksWaitingTermination(), vTaskIncrementTick(), xCoRoutineRemoveFromEventList(), xTaskRemoveFromEventList(), and xTaskResumeAll().

#define listGET_OWNER_OF_NEXT_ENTRY	(		pxTCB,
			pxList
	)

Value:

{                                                                                       \
xList * const pxConstList = ( pxList );                                                 \
    /* Increment the index to the next item and return the item, ensuring */            \
    /* we don't return the marker used at the end of the list.  */                      \
    ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext;                        \
    if( ( pxConstList )->pxIndex == ( xListItem * ) &( ( pxConstList )->xListEnd ) )    \
    {                                                                                   \
        ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext;                    \
    }                                                                                   \
    ( pxTCB ) = ( pxConstList )->pxIndex->pvOwner;                                      \
}

Referenced by vCoRoutineSchedule(), and vTaskSwitchContext().

#define listIS_CONTAINED_WITHIN	(		pxList,
			pxListItem
	)		( ( pxListItem )->pvContainer == ( void * ) ( pxList ) )

Referenced by vTaskPrioritySet(), and xTaskIsTaskSuspended().

#define listLIST_IS_EMPTY

(

pxList

)

( ( pxList )->uxNumberOfItems == ( unsigned portBASE_TYPE ) 0 )

Referenced by prvCheckDelayedList(), prvCheckPendingReadyList(), prvCheckTasksWaitingTermination(), prvUnlockQueue(), vCoRoutineSchedule(), vTaskIncrementTick(), vTaskSwitchContext(), xQueueGenericReceive(), xQueueGenericSend(), xQueueGenericSendFromISR(), xQueueReceiveFromISR(), and xTaskResumeAll().

#define listSET_LIST_ITEM_OWNER	(		pxListItem,
			pxOwner
	)		( pxListItem )->pvOwner = ( void * ) ( pxOwner )

Referenced by prvInitialiseTCBVariables(), and xCoRoutineCreate().

#define listSET_LIST_ITEM_VALUE	(		pxListItem,
			xValue
	)		( pxListItem )->xItemValue = ( xValue )

Referenced by prvAddCurrentTaskToDelayedList(), prvInitialiseTCBVariables(), vCoRoutineAddToDelayedList(), vTaskPrioritySet(), and xCoRoutineCreate().

typedef struct xLIST xList

typedef struct xLIST_ITEM xListItem

typedef struct xMINI_LIST_ITEM xMiniListItem

void vListInitialise

(

xList *

pxList

)

References xLIST::pxIndex, xMINI_LIST_ITEM::pxNext, xMINI_LIST_ITEM::pxPrevious, xLIST::uxNumberOfItems, xMINI_LIST_ITEM::xItemValue, and xLIST::xListEnd.

Referenced by prvInitialiseCoRoutineLists(), and prvInitialiseTaskLists().

void vListInitialiseItem

(

xListItem *

pxItem

)

References xLIST_ITEM::pvContainer.

Referenced by prvInitialiseTCBVariables(), and xCoRoutineCreate().

void vListInsert	(	xList *	pxList,
		xListItem *	pxNewListItem
	)

References xLIST_ITEM::pvContainer, xLIST_ITEM::pxNext, xLIST_ITEM::pxPrevious, xMINI_LIST_ITEM::pxPrevious, xLIST::uxNumberOfItems, xLIST_ITEM::xItemValue, and xLIST::xListEnd.

Referenced by prvAddCurrentTaskToDelayedList(), vCoRoutineAddToDelayedList(), and vTaskPlaceOnEventList().

void vListInsertEnd	(	xList *	pxList,
		xListItem *	pxNewListItem
	)

References xLIST_ITEM::pvContainer, xLIST::pxIndex, xLIST_ITEM::pxNext, xLIST_ITEM::pxPrevious, and xLIST::uxNumberOfItems.

Referenced by vTaskDelete(), vTaskPlaceOnEventList(), vTaskSuspend(), xCoRoutineRemoveFromEventList(), xTaskRemoveFromEventList(), and xTaskResumeFromISR().

void vListRemove

(

xListItem *

pxItemToRemove

)

References xLIST_ITEM::pvContainer, xLIST::pxIndex, xLIST_ITEM::pxNext, xLIST_ITEM::pxPrevious, and xLIST::uxNumberOfItems.

Referenced by prvCheckDelayedList(), prvCheckPendingReadyList(), prvCheckTasksWaitingTermination(), vCoRoutineAddToDelayedList(), vTaskDelay(), vTaskDelayUntil(), vTaskDelete(), vTaskPlaceOnEventList(), vTaskPrioritySet(), vTaskResume(), vTaskSuspend(), xCoRoutineRemoveFromEventList(), xTaskRemoveFromEventList(), xTaskResumeAll(), and xTaskResumeFromISR().