/simpletypesystem/trunk

#ifndef __GAME_MATRIX__

#define __GAME_MATRIX__

#include <string.h>

#include <stdlib.h>

#include <stdbool.h>

#include <stdio.h>

#include "defs.h"

#include "DynamicArray.h"

/**

 * @file

 * @defgroup SMatrix SMatrix

 * @addtogroup SMatrix

 * @{

 * A SMatrix is a 2d, square array.

 */

typedef struct _SMatrix SMatrix;

SMatrix *

s_matrix_new (size_t width, size_t height);

void

s_matrix_free (SMatrix * self, bool free_data);

/**

 * Reallocate a SMatrix from one tuple width to an other.

 *

 * @note The new tuple size must be larger then the last, or it will be

 * turnicated.

 *

 * @note You need to free the old SMatrix yourself, this is to avoid memory

 * leaks.

 */

SMatrix *

s_matrix_realloc (SMatrix * self, size_t width);

/**

 * Get element y in tuple x.

 *

 * Equivalent to matrix[x][y] would be in static 2d arrays.

 */

spointer

s_matrix_get (SMatrix * self, size_t x, size_t y);

void

s_matrix_set (SMatrix * self, size_t x, size_t y, spointer data);

spointer *

s_matrix_get_tupel (SMatrix * self, size_t x);

void

s_matrix_append (SMatrix * self, spointer data);

SDynamicArray *

s_matrix_get_tupel_as_dynamic_array (SMatrix * self, size_t x);

/**

 * This iterates over each tuple. giving the tuple as the item in the

 * callback function.

 */

void

s_matrix_foreach (SMatrix * self, ForEachFunc callback, spointer data);

/** @} */

#endif /*__GAME_MATRIX__ */