Basic operations

basic functions for getting and setting matrices, arrays, tables, etc. More...

Functions
TCAPIEXPORT tc_matrix	tc_createMatrix (int rows, int cols)
	Create a matrix with the given rows and columns.
TCAPIEXPORT tc_table	tc_createTable (int rows, int cols)
	Create a strings table with the given rows and columns.
TCAPIEXPORT tc_strings	tc_createStringsArray (int len)
	Create an array of strings.
TCAPIEXPORT tc_items	tc_createItemsArray (int len)
	Create an array of items.
TCAPIEXPORT double	tc_getMatrixValue (tc_matrix M, int i, int j)
	get i,jth value from a tc_matrix
TCAPIEXPORT void	tc_setMatrixValue (tc_matrix M, int i, int j, double d)
	set i,jth value of a tc_matrix
TCAPIEXPORT const char *	tc_getRowName (tc_matrix M, int i)
	get ith row name from a tc_matrix
TCAPIEXPORT void	tc_setRowName (tc_matrix M, int i, const char *s)
	set ith row name for a tc_matrix
TCAPIEXPORT const char *	tc_getColumnName (tc_matrix M, int j)
	get jth column name of a tc_matrix
TCAPIEXPORT void	tc_setColumnName (tc_matrix M, int j, const char *s)
	set jth column name of a tc_matrix
TCAPIEXPORT const char *	tc_getTableValue (tc_table S, int i, int j)
	get i,j-th string in a table
TCAPIEXPORT void	tc_setTableValue (tc_table S, int i, int j, const char *s)
	set i,jth string in a table
TCAPIEXPORT const char *	tc_getString (tc_strings S, int i)
	get ith string in array of strings
TCAPIEXPORT void	tc_setString (tc_strings S, int i, const char *c)
	set ith string in array of strings
TCAPIEXPORT long	tc_getItem (tc_items A, int i)
	get ith long item in array of items
TCAPIEXPORT void	tc_setItem (tc_items A, int i, long o)
	set ith long item in array of items
TCAPIEXPORT int	tc_getStringIndex (tc_strings A, const char *s)
	get the index of a string in the array
TCAPIEXPORT int	tc_getRowIndex (tc_matrix, const char *s)
	get the row number of a row name
TCAPIEXPORT int	tc_getColumnIndex (tc_matrix, const char *s)
	get the column number of a column name
TCAPIEXPORT void	tc_deleteMatrix (tc_matrix M)
	delete a matrix
TCAPIEXPORT void	tc_deleteTable (tc_table M)
	delete a strings table
TCAPIEXPORT void	tc_deleteItemsArray (tc_items A)
	delete an array of items
TCAPIEXPORT void	tc_deleteStringsArray (tc_strings C)
	delete an array of strings
TCAPIEXPORT tc_matrix	tc_appendColumns (tc_matrix A, tc_matrix B)
	combine two matrices by appending their columns. row size must be equal for both matrices
TCAPIEXPORT tc_matrix	tc_appendRows (tc_matrix A, tc_matrix B)
	combine two matrices by appending their row. column sizes must be equal for both matrices
TCAPIEXPORT tc_matrix	tc_transpose (tc_matrix A)
	transpose a matrix
TCAPIEXPORT void	tc_printMatrixToFile (const char *file, tc_matrix M)
	print a matrix to file
TCAPIEXPORT void	tc_printOutMatrix (tc_matrix M)
	print a matrix to stdout
TCAPIEXPORT void	tc_printTableToFile (const char *file, tc_table M)
	print a table to file
TCAPIEXPORT void	tc_printOutTable (tc_table M)
	print a table to stdout

---

Detailed Description

basic functions for getting and setting matrices, arrays, tables, etc.

---

Function Documentation

TCAPIEXPORT tc_matrix tc_appendColumns	(	tc_matrix	A,
		tc_matrix	B
	)

combine two matrices by appending their columns. row size must be equal for both matrices

Parameters:

tc_matrix	first matrix
tc_matrix	fsecond matrix

Returns:

tc_matrix new combined matrix

TCAPIEXPORT tc_matrix tc_appendRows	(	tc_matrix	A,
		tc_matrix	B
	)

combine two matrices by appending their row. column sizes must be equal for both matrices

Parameters:

tc_matrix	first matrix
tc_matrix	fsecond matrix

Returns:

tc_matrix new combined matrix

TCAPIEXPORT tc_items tc_createItemsArray

(

int

len

)

Create an array of items.

Parameters:

int	number of items

Returns:

tc_items

TCAPIEXPORT tc_matrix tc_createMatrix	(	int	rows,
		int	cols
	)

Create a matrix with the given rows and columns.

Parameters:

int	number of rows
int	number of columns

Returns:

tc_matrix

TCAPIEXPORT tc_strings tc_createStringsArray

(

int

len

)

Create an array of strings.

Parameters:

int

length

Returns:

tc_strings

TCAPIEXPORT tc_table tc_createTable	(	int	rows,
		int	cols
	)

Create a strings table with the given rows and columns.

Parameters:

int	number of rows
int	number of columns

Returns:

tc_table

TCAPIEXPORT void tc_deleteItemsArray

(

tc_items

A

)

delete an array of items

Parameters:

&tc_items

pointer to array

TCAPIEXPORT void tc_deleteMatrix

(

tc_matrix

M

)

delete a matrix

Parameters:

&tc_matrix

pointer to matrix

TCAPIEXPORT void tc_deleteStringsArray

(

tc_strings

C

)

delete an array of strings

Parameters:

&tc_strings

pointer to array

TCAPIEXPORT void tc_deleteTable

(

tc_table

M

)

delete a strings table

Parameters:

&tc_table

pointer to table

TCAPIEXPORT int tc_getColumnIndex	(	tc_matrix	,
		const char *	s
	)

get the column number of a column name

Parameters:

tc_matrix	matrix
char*	a string in the matrix

Returns:

int index of that string

TCAPIEXPORT const char* tc_getColumnName	(	tc_matrix	M,
		int	j
	)

get jth column name of a tc_matrix

Parameters:

tc_matrix	matrix
int	column

Returns:

string column name

TCAPIEXPORT long tc_getItem	(	tc_items	A,
		int	i
	)

get ith long item in array of items

Parameters:

tc_items	array
int	index

Returns:

long value

TCAPIEXPORT double tc_getMatrixValue	(	tc_matrix	M,
		int	i,
		int	j
	)

get i,jth value from a tc_matrix

Parameters:

tc_matrix	matrix
int	row
int	column

Returns:

double value at the given row, column

TCAPIEXPORT int tc_getRowIndex	(	tc_matrix	,
		const char *	s
	)

get the row number of a row name

Parameters:

tc_matrix	matrix
char*	a string in the matrix

Returns:

int index of that string

TCAPIEXPORT const char* tc_getRowName	(	tc_matrix	M,
		int	i
	)

get ith row name from a tc_matrix

Parameters:

tc_matrix	matrix
int	row

Returns:

string row name

TCAPIEXPORT const char* tc_getString	(	tc_strings	S,
		int	i
	)

get ith string in array of strings

Parameters:

tc_strings	array
int	index

Returns:

string value

TCAPIEXPORT int tc_getStringIndex	(	tc_strings	A,
		const char *	s
	)

get the index of a string in the array

Parameters:

tc_strings	array
char*	a string in the array

Returns:

int index of that string

TCAPIEXPORT const char* tc_getTableValue	(	tc_table	S,
		int	i,
		int	j
	)

get i,j-th string in a table

Parameters:

tc_table	table
int	row
int	column

Returns:

string value at row,column

TCAPIEXPORT void tc_printMatrixToFile	(	const char *	file,
		tc_matrix	M
	)

print a matrix to file

Parameters:

char*	file name
tc_matrix

TCAPIEXPORT void tc_printOutMatrix

(

tc_matrix

M

)

print a matrix to stdout

Parameters:

char*	file name
tc_matrix

TCAPIEXPORT void tc_printOutTable

(

tc_table

M

)

print a table to stdout

Parameters:

tc_table

TCAPIEXPORT void tc_printTableToFile	(	const char *	file,
		tc_table	M
	)

print a table to file

Parameters:

char*	file name
tc_table

TCAPIEXPORT void tc_setColumnName	(	tc_matrix	M,
		int	j,
		const char *	s
	)

set jth column name of a tc_matrix

Parameters:

tc_matrix	matrix
int	column
string	column name

TCAPIEXPORT void tc_setItem	(	tc_items	A,
		int	i,
		long	o
	)

set ith long item in array of items

Parameters:

tc_items	array
int	index
long	value

TCAPIEXPORT void tc_setMatrixValue	(	tc_matrix	M,
		int	i,
		int	j,
		double	d
	)

set i,jth value of a tc_matrix

Parameters:

tc_matrix	matrix
int	row
int	column
double	value at the given row, column

TCAPIEXPORT void tc_setRowName	(	tc_matrix	M,
		int	i,
		const char *	s
	)

set ith row name for a tc_matrix

Parameters:

tc_matrix	matrix
int	row
string	row name

TCAPIEXPORT void tc_setString	(	tc_strings	S,
		int	i,
		const char *	c
	)

set ith string in array of strings

Parameters:

tc_strings	array
int	index
string	value

TCAPIEXPORT void tc_setTableValue	(	tc_table	S,
		int	i,
		int	j,
		const char *	s
	)

set i,jth string in a table

Parameters:

tc_table	table
int	row
int	column
string	value at row,column

TCAPIEXPORT tc_matrix tc_transpose

(

tc_matrix

A

)

transpose a matrix

Parameters:

tc_matrix

target matrix

Returns:

tc_matrix new transposed matrix