Main Page | Alphabetical List | Data Structures | File List | Data Fields | Globals | Related Pages

text_array.h File Reference


Detailed Description

A two dimensional array of strings.

Each cell may contain either a null pointer or a pointer to an ordinary string. A simple external representation is used to load, store, and subset arrays between processes.

Go to the source code of this file.

Functions

text_array * text_array_create (int w, int h)
 Create a new text array.
void text_array_delete (struct text_array *t)
 Delete a text array and all of its contents.
int text_array_width (struct text_array *t)
 Get the width of the array.
int text_array_height (struct text_array *t)
 Get the height of the array.
const char * text_array_get (struct text_array *t, int x, int y)
 Look up one cell in the array.
int text_array_set (struct text_array *t, int x, int y, const char *c)
 Set one cell in the array.
int text_array_load (struct text_array *t, const char *filename)
 Load an array from a file.
int text_array_save (struct text_array *t, const char *filename)
 Save an array to a file.
int text_array_save_range (struct text_array *t, const char *filename, int x, int y, int w, int h)
 Save a portion of an array to a file.


Function Documentation

struct text_array* text_array_create int  w,
int  h
 

Create a new text array.

Parameters:
w Width of the array.
h Height of the array.
Returns:
A new text array on success, or null on failure.

void text_array_delete struct text_array *  t  ) 
 

Delete a text array and all of its contents.

Parameters:
t The text array to deleted.

int text_array_width struct text_array *  t  ) 
 

Get the width of the array.

Parameters:
t A text array.
Returns:
The width of the array.

int text_array_height struct text_array *  t  ) 
 

Get the height of the array.

Parameters:
t A text array.
Returns:
The height of the array.

const char* text_array_get struct text_array *  t,
int  x,
int  y
 

Look up one cell in the array.

Parameters:
t A text array.
x The x position of the cell.
y The y position of the cell.
Returns:
The value of the cell, which might be null.

int text_array_set struct text_array *  t,
int  x,
int  y,
const char *  c
 

Set one cell in the array.

Parameters:
t A text array.
x The x position of the cell.
y The y position of the cell.
c A string to place in the cell. If not null, c will be copied with strdup and placed in the data structure. Regardless, the current occupant of the cell will be freed.

int text_array_load struct text_array *  t,
const char *  filename
 

Load an array from a file.

Parameters:
t An array created by text_array_create.
filename The filename to load from.

int text_array_save struct text_array *  t,
const char *  filename
 

Save an array to a file.

Parameters:
t An array created by text_array_create.
filename The filename to write to.

int text_array_save_range struct text_array *  t,
const char *  filename,
int  x,
int  y,
int  w,
int  h
 

Save a portion of an array to a file.

Parameters:
t An array created by text_array_create.
filename The filename to write to.
x The starting x position of the range to save.
y The starting y position of the range to save.
w The width of the range to save.
h The height of the range to save.


Generated on Thu Jul 2 15:49:25 2009 for cctools by  doxygen 1.3.9.1