JST_list.h File Reference

#include "jstools.h"

Include dependency graph for JST_list.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	JST_Node_

Typedefs
typedef struct JST_Node_	JST_List
typedef void(*	LST_assign_t) (void *dest, unsigned index, void *src)

Functions
JST_Error	JST_List_push_back (JST_List **first, JST_List **current, void *data)
JST_Error	JST_List_move_to (JST_List *from, void *dest, LST_assign_t assign)
	For each item in list, call assign to transfert ownership of items and free the list, node by node. More...

Variables
const JST_List	JST_List_Zero

Typedef Documentation

JST_List

typedef struct JST_Node_ JST_List

LST_assign_t

typedef void( * LST_assign_t) (void *dest, unsigned index, void *src)

Definition at line 11 of file JST_list.h.

Function Documentation

JST_List_move_to()

JST_Error JST_List_move_to	(	JST_List *	from,
		void *	dest,
		LST_assign_t	assign
	)

For each item in list, call assign to transfert ownership of items and free the list, node by node.

Parameters

from	the list to clear
dest	the destination of transfert, a data structure (opaque here)
assign	the callback able to make the transfert from JST_List to another data structure (opaque here)

Returns

JST_ERR_NONE or JST_ERR_NULL_ARGUMENT when from, dest or assign are null.

Definition at line 25 of file JST_list.c.

                                                                                {
   if(( from == NULL )||( dest == NULL )||( assign == NULL )) {
      return JST_ERR_NULL_ARGUMENT;
   }
   JST_List * iter = from;
   for( unsigned i = 0; iter; ++i ) {
      assign( dest, i, iter->item );
      JST_List * next = iter->next;
      free( iter );
      iter = next;
   }
   return JST_ERR_NONE;
}

JST_List_push_back()

JST_Error JST_List_push_back	(	JST_List **	first,
		JST_List **	current,
		void *	data
	)

Returns

JST_ERR_NONE or JST_ERR_NULL_ARGUMENT when first or current are null.

Definition at line 7 of file JST_list.c.

                                                                                    {
   if(( first == NULL )||( current == NULL )) {
      return JST_ERR_NULL_ARGUMENT;
   }
   if( *first == NULL ) {
      *first = *current = calloc( 1, sizeof( JST_List ));
   }
   else {
      if( *current == NULL ) {
         return JST_ERR_NULL_ARGUMENT;
      }
      (*current)->next = calloc( 1, sizeof( JST_List ));
      *current = (*current)->next;
   }
   (*current)->item = data;
   return JST_ERR_NONE;
}

Variable Documentation

JST_List_Zero

const JST_List JST_List_Zero

Definition at line 5 of file JST_list.c.