gwenhywfar 4.0.3
Functions

ID list module

A list of uint64_t objects. More...

Functions

GWENHYWFAR_API int GWEN_IdList64_AddId (GWEN_IDLIST64 *idl, uint64_t id)
GWENHYWFAR_API int GWEN_IdList64_AppendId (GWEN_IDLIST64 *idl, uint64_t id)
GWENHYWFAR_API void GWEN_IdList64_Attach (GWEN_IDLIST64 *idl)
GWENHYWFAR_API void GWEN_IdList64_Clear (GWEN_IDLIST64 *idl)
GWENHYWFAR_API int GWEN_IdList64_DelId (GWEN_IDLIST64 *idl, uint64_t id)
GWENHYWFAR_API GWEN_IDLIST64GWEN_IdList64_dup (const GWEN_IDLIST64 *idl)
GWENHYWFAR_API void GWEN_IdList64_free (GWEN_IDLIST64 *idl)
GWENHYWFAR_API uint64_t GWEN_IdList64_GetEntryCount (const GWEN_IDLIST64 *idl)
GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetFirstId (GWEN_IDLIST64 *idl)
GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetFirstId2 (const GWEN_IDLIST64 *idl, uint64_t *hdl)
GWENHYWFAR_API uint64_t GWEN_IdList64_GetIdAt (const GWEN_IDLIST64 *idl, uint64_t index)
GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetNextId (GWEN_IDLIST64 *idl)
GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetNextId2 (const GWEN_IDLIST64 *idl, uint64_t *hdl)
GWENHYWFAR_API int GWEN_IdList64_HasId (const GWEN_IDLIST64 *idl, uint64_t id)
GWENHYWFAR_API GWEN_IDLIST64GWEN_IdList64_new ()
GWENHYWFAR_API int GWEN_IdList64_ReverseSort (GWEN_IDLIST64 *idl)
GWENHYWFAR_API int GWEN_IdList64_Sort (GWEN_IDLIST64 *idl)

Detailed Description

A list of uint64_t objects.

This is basically a list for uint64_t objects, but since it uses tables instead of those list objects normally used throughout Gwen it is less memory consuming.


Function Documentation

GWENHYWFAR_API int GWEN_IdList64_AddId ( GWEN_IDLIST64 idl,
uint64_t  id 
)

Adds an id to the list. This function does no doublecheck.

Definition at line 287 of file idlist64.c.

References GWEN_IdList64_AddTable(), GWEN_IdTable64_AddId(), GWEN_IdTable64_IsFull(), GWEN_IdTable64_new(), and NULL.

Referenced by GWEN_IdList64__Sort().

GWENHYWFAR_API int GWEN_IdList64_AppendId ( GWEN_IDLIST64 idl,
uint64_t  id 
)

Always append id at the end of the list.

Definition at line 668 of file idlist64.c.

References GWEN_IdList64_AddTable(), GWEN_IdTable64_AppendId(), GWEN_IdTable64_IsFull(), GWEN_IdTable64_new(), and NULL.

GWENHYWFAR_API void GWEN_IdList64_Attach ( GWEN_IDLIST64 idl)

Definition at line 227 of file idlist64.c.

Referenced by GWEN_IdList64_Iterator_new().

GWENHYWFAR_API void GWEN_IdList64_Clear ( GWEN_IDLIST64 idl)

Removes all ids from the list thus leaving it empty.

Definition at line 376 of file idlist64.c.

References GWEN_IdTable64_free(), and NULL.

Referenced by GWEN_IdList64__Sort(), and GWEN_IdList64_free().

GWENHYWFAR_API int GWEN_IdList64_DelId ( GWEN_IDLIST64 idl,
uint64_t  id 
)

Removes the first occurrence of the given id.

Returns:
0 if deleted, !=0 if the id wasn't found

Definition at line 320 of file idlist64.c.

References GWEN_IdList64_Clean(), GWEN_IdTable64_DelId(), and NULL.

GWENHYWFAR_API GWEN_IDLIST64* GWEN_IdList64_dup ( const GWEN_IDLIST64 idl)

Returns a new id list which contains all the ids of the given list in the same order. However, the list returned might be more is compact (i.e. it has fewer wholes), so the positions of ids within the list might have changed!.

Definition at line 488 of file idlist64.c.

References GWEN_IdList64_AddTable(), GWEN_IdList64_new(), GWEN_IdTable64_IsEmpty(), and GWEN_IdTable64_new().

GWENHYWFAR_API void GWEN_IdList64_free ( GWEN_IDLIST64 idl)

Destructor.

Definition at line 235 of file idlist64.c.

References GWEN_FREE_OBJECT, and GWEN_IdList64_Clear().

Referenced by GWEN_IdList64_Iterator_free().

GWENHYWFAR_API uint64_t GWEN_IdList64_GetEntryCount ( const GWEN_IDLIST64 idl)

Definition at line 517 of file idlist64.c.

GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetFirstId ( GWEN_IDLIST64 idl)
Deprecated:
This function is deprecated, please use GWEN_IdList64_Iterator_new instead.

Definition at line 606 of file idlist64.c.

References GWEN_IdList64__GetFirstId().

GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetFirstId2 ( const GWEN_IDLIST64 idl,
uint64_t *  hdl 
)
Deprecated:
This function is deprecated, please use GWEN_IdList64_Iterator_new instead.

Definition at line 618 of file idlist64.c.

References GWEN_IdList64__GetFirstId().

GWENHYWFAR_API uint64_t GWEN_IdList64_GetIdAt ( const GWEN_IDLIST64 idl,
uint64_t  index 
)

Definition at line 694 of file idlist64.c.

References DBG_INFO, GWEN_LOGDOMAIN, and NULL.

GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetNextId ( GWEN_IDLIST64 idl)
Deprecated:
This function is deprecated, please use GWEN_IdList64_Iterator_new instead.

Definition at line 612 of file idlist64.c.

References GWEN_IdList64__GetNextId().

GWENHYWFAR_API DEPRECATED uint64_t GWEN_IdList64_GetNextId2 ( const GWEN_IDLIST64 idl,
uint64_t *  hdl 
)
Deprecated:
This function is deprecated, please use GWEN_IdList64_Iterator_new instead.

Definition at line 624 of file idlist64.c.

References GWEN_IdList64__GetNextId().

GWENHYWFAR_API int GWEN_IdList64_HasId ( const GWEN_IDLIST64 idl,
uint64_t  id 
)

Checks whether the given id exists in the idlist.

Returns:
0 if found, !=0 otherwise

Definition at line 342 of file idlist64.c.

References GWEN_IdTable64_HasId(), and NULL.

GWENHYWFAR_API GWEN_IDLIST64* GWEN_IdList64_new ( )

Constructor.

Definition at line 217 of file idlist64.c.

References GWEN_NEW_OBJECT.

Referenced by GWEN_IdList64_dup().

GWENHYWFAR_API int GWEN_IdList64_ReverseSort ( GWEN_IDLIST64 idl)

Definition at line 482 of file idlist64.c.

References GWEN_IdList64__Sort().

GWENHYWFAR_API int GWEN_IdList64_Sort ( GWEN_IDLIST64 idl)

Sorts the ids in ascending order

Definition at line 476 of file idlist64.c.

References GWEN_IdList64__Sort().