MeatAxe  2.4
Integer Matrices

Detailed Description

Data Structures

class  IntMatrix_t
 An Integer Matrix. More...
 

Functions

int ImatIsValid (const IntMatrix_t *mat)
 Check an Integer Matrix. More...
 
IntMatrix_tImatAlloc (int nor, int noc)
 Create a New Integer Matrix. More...
 
int ImatFree (IntMatrix_t *mat)
 Delete an Integer Matrix. More...
 
IntMatrix_tImatRead (FILE *f)
 Read an integer matrix from a file. More...
 
IntMatrix_tImatLoad (const char *fn)
 Read an Integer Matrix From a File. More...
 
int ImatWrite (const IntMatrix_t *mat, FILE *f)
 Write an integer matrix to a file. More...
 
int ImatSave (const IntMatrix_t *mat, const char *file_name)
 Write an Integer Matrix to a File. More...
 

Function Documentation

◆ ImatAlloc()

IntMatrix_t* ImatAlloc ( int  nor,
int  noc 
)

Create a New Integer Matrix.

This function creates a new integer matrix with |nor| rows and |noc| columns. To destroy an integer matrix, use ImatFree(), not SysFree().

Parameters
norNumber of rows.
nocNumber of columns.
Returns
Pointer to the new matrix or 0 on error.

◆ ImatFree()

int ImatFree ( IntMatrix_t mat)

Delete an Integer Matrix.

This function frees a matrix which has beed created by ImatAlloc(). This implies freeing the internal data buffers as well as the IntMatrix_t structure itself.

Parameters
matPointer to the matrix.
Returns
0 on success, -1 on error.

◆ ImatIsValid()

int ImatIsValid ( const IntMatrix_t mat)

Check an Integer Matrix.

This function checks if the argument is a pointer to a valid integer matrix. If the matrix is o.k., the function returns 1. Otherwise, an error is signalled and, if the error handler does not terminate the program, the function returns 0.

Parameters
matPointer to the matrix.
Returns
1 if mat points to a valid matrix, 0 otherwise.

◆ ImatLoad()

IntMatrix_t* ImatLoad ( const char *  fn)

Read an Integer Matrix From a File.

This function opens a file, reads a single integer matrix, and closes the file. To read more than one matrix from a file, use ImatRead().

Parameters
fnFile name.
Returns
Pointer to the matrix, or 0 on error.

◆ ImatRead()

IntMatrix_t* ImatRead ( FILE *  f)

Read an integer matrix from a file.

This function reads an integer matrix from a file.

See also
ImatLoad()
Parameters
fFile to read from.
Returns
Pointer to the matrix, or 0 on error.

◆ ImatSave()

int ImatSave ( const IntMatrix_t mat,
const char *  file_name 
)

Write an Integer Matrix to a File.

This function writes an integer matrix to a named file. If the file exists, it is destroyed.

See also
ImatWrite()
Parameters
matPointer to the matrix.
file_nameFile name.
Returns
0 on success, -1 on error.

◆ ImatWrite()

int ImatWrite ( const IntMatrix_t mat,
FILE *  f 
)

Write an integer matrix to a file.

See also
ImatSave
Parameters
matPointer to the matrix.
fPointer to the file.
Returns
0 on success, -1 on error.

MeatAxe 2.4 documentation, generated on Mon Jun 7 2021 11:42:24