Skip to content

Latest commit

 

History

History
117 lines (81 loc) · 3.82 KB

singlylinkedlist-h.md

File metadata and controls

117 lines (81 loc) · 3.82 KB
title titleSuffix description manager author ms.author ms.date ms.service ms.custom ms.topic
singlylinkedlist.h header file reference | Microsoft Docs
Azure IoT C SDK
This is the header file reference page for singlylinkedlist.h in the Azure IoT C SDK. This SDK is used with Azure IoT Hub and Azure IoT Hub Device Provisioning Service
timlt
wesmc7777
wesmc
03/25/2022
iot-hub
reference

singlylinkedlist.h

Includes

#include "stdbool.h"
#include "umock_c/umock_c_prod.h"

Detailed Description

Functions

Function Name Description
singlylinkedlist_create
singlylinkedlist_destroy
singlylinkedlist_add
singlylinkedlist_add_head
singlylinkedlist_remove
singlylinkedlist_get_head_item
singlylinkedlist_get_next_item
singlylinkedlist_find
singlylinkedlist_item_get_value
singlylinkedlist_remove_if
singlylinkedlist_foreach

Type definitions

SINGLYLINKEDLIST_HANDLE

typedef struct SINGLYLINKEDLIST_INSTANCE_TAG* SINGLYLINKEDLIST_HANDLE;

LIST_ITEM_HANDLE

typedef struct LIST_ITEM_INSTANCE_TAG* LIST_ITEM_HANDLE;

LIST_MATCH_FUNCTION

Function passed to singlylinkedlist_find, which returns whichever first list item that matches it.

typedef bool(* LIST_MATCH_FUNCTION) (
  LIST_ITEM_HANDLE  list_item,
  const void *      match_context
);

Parameters:

  • list_item Current list node being evaluated.

  • match_context Context passed to singlylinkedlist_find.

Return Value:

True to indicate that the current list node is the one to be returned, or false to continue traversing the list.

LIST_CONDITION_FUNCTION

Function passed to singlylinkedlist_remove_if, which is used to define if an item of the list should be removed or not.

typedef bool(* LIST_CONDITION_FUNCTION) (
  const void *  item,
  const void *  match_context,
  bool *        continue_processing
);

Parameters:

  • item Value of the current list node being evaluated for removal.

  • match_context Context passed to singlylinkedlist_remove_if.

  • continue_processing Indicates if singlylinkedlist_remove_if shall continue iterating through the next nodes of the list or stop.

Return Value:

True to indicate that the current list node shall be removed, or false to not to.

LIST_ACTION_FUNCTION

Function passed to singlylinkedlist_foreach, which is called for the value of each node of the list.

typedef void(* LIST_ACTION_FUNCTION) (
  const void *  item,
  const void *  action_context,
  bool *        continue_processing
);

Parameters:

  • item Value of the current list node being processed.

  • action_context Context passed to singlylinkedlist_foreach.

  • continue_processing Indicates if singlylinkedlist_foreach shall continue iterating through the next nodes of the list or stop.