Functions
FILE *	t_fopen (const char , const char )

FILE *	t_fclose (FILE *stream)

long	read_shortvector_elements (FILE , SHORTVECTOR , char *)

long	write_shortvector_elements (FILE , SHORTVECTOR , long)

long	binarywrite_shortvector_elements (FILE , SHORTVECTOR )

void	print_shortvector_elements (SHORTVECTOR *, long)

long	read_intvector_elements (FILE , INTVECTOR , char *)

long	write_intvector_elements (FILE , INTVECTOR , long)

long	binarywrite_intvector_elements (FILE , INTVECTOR )

void	print_intvector_elements (INTVECTOR *, long)

long	read_longvector_elements (FILE , LONGVECTOR , char *)

long	write_longvector_elements (FILE , LONGVECTOR , long)

long	binarywrite_longvector_elements (FILE , LONGVECTOR )

void	print_longvector_elements (LONGVECTOR *, long)

long	read_floatvector_elements (FILE , FLOATVECTOR , char *)

long	write_floatvector_elements (FILE , FLOATVECTOR , long)

long	binarywrite_floatvector_elements (FILE , FLOATVECTOR )

void	print_floatvector_elements (FLOATVECTOR *, long)

long	read_doublevector_elements (FILE , DOUBLEVECTOR , char *)

long	write_doublevector_elements (FILE , DOUBLEVECTOR , long)

long	binarywrite_doublevector_elements (FILE , DOUBLEVECTOR )

void	print_doublevector_elements (DOUBLEVECTOR *, long)

long	read_charvector_elements (FILE , CHARVECTOR , char *)

long	write_charvector_elements (FILE , CHARVECTOR , long)

long	binarywrite_charvector_elements (FILE , CHARVECTOR )

void	print_charvector_elements (CHARVECTOR *, long)

long	read_shortmatrix_elements (FILE , SHORTMATRIX , char *)

long	write_shortmatrix_elements (FILE , SHORTMATRIX , long)

long	binarywrite_shortmatrix_elements (FILE , SHORTMATRIX )

void	print_shortmatrix_elements (SHORTMATRIX *, long)

long	read_intmatrix_elements (FILE , INTMATRIX , char *)

long	write_intmatrix_elements (FILE , INTMATRIX , long)

long	binarywrite_intmatrix_elements (FILE , INTMATRIX )

void	print_intmatrix_elements (INTMATRIX *, long)

long	read_longmatrix_elements (FILE , LONGMATRIX , char *)

long	write_longmatrix_elements (FILE , LONGMATRIX , long)

long	binarywrite_longmatrix_elements (FILE , LONGMATRIX )

void	print_longmatrix_elements (LONGMATRIX *, long)

long	read_floatmatrix_elements (FILE , FLOATMATRIX , char *)

long	write_floatmatrix_elements (FILE , FLOATMATRIX , long)

long	binarywrite_floatmatrix_elements (FILE , FLOATMATRIX )

void	print_floatmatrix_elements (FLOATMATRIX *, long)

long	read_doublematrix_elements (FILE , DOUBLEMATRIX , char *)

long	write_doublematrix_elements (FILE , DOUBLEMATRIX , long)

long	binarywrite_doublematrix_elements (FILE , DOUBLEMATRIX )

void	print_doublematrix_elements (DOUBLEMATRIX *, long)

long	read_intbin_elements (FILE , INTBIN , char *)

long	write_intbin_elements (FILE , INTBIN , long)

long	binarywrite_intbin_elements (FILE output, INTBIN l)

void	print_intbin_elements (INTBIN *, long)

STRINGBIN *	read_plane_strings (FILE *, long, long)

long	write_stringbin_elements (FILE , STRINGBIN , long)

void	print_stringbin_elements (STRINGBIN *, long)

long	read_shortbin_elements (FILE , SHORTBIN , char *)

long	write_shortbin_elements (FILE , SHORTBIN , long)

long	binarywrite_shortbin_elements (FILE , SHORTBIN )

void	print_shortbin_elements (SHORTBIN *, long)

long	read_longbin_elements (FILE , LONGBIN , char *)

long	write_longbin_elements (FILE , LONGBIN , long)

long	binarywrite_longbin_elements (FILE , LONGBIN )

void	print_longbin_elements (LONGBIN *, long)

long	read_doublebin_elements (FILE , DOUBLEBIN , char *)

long	write_doublebin_elements (FILE , DOUBLEBIN , long)

long	binarywrite_doublebin_elements (FILE , DOUBLEBIN )

void	print_doublebin_elements (DOUBLEBIN *, long)

int	copy_buffer_into_stringbin (char , STRINGBIN )

int	read_comment (FILE *, int, long, short)

char *	readandstore_comment (FILE *, int, long)

char *	read_buffer_from_stdio (long)

int	iscomment (char , FILE )

char *	join_strings (char , char )

char *	get_filename (char , char )

STRINGBIN *	read_filenames (char working_directory, char program, char extension, char position)

DOUBLEVECTOR *	read_parameters (char working_directory, char program, char extension, char position)

double	get_parameter (char , char )

char *	get_strings (char , char )

char *	get_workingdirectory (void)

void	skip_whitespaces (FILE *)

void	goto_EOF (FILE *)

HEADER	read_header (FILE , const char )

void	print_header (HEADER *)

int	query_for_token (FILE , const char )

char *	query_for_label (FILE *)

char *	get_phrase (FILE *, const char)

INTMATRIX *	read_intmatrix (FILE , char , short)

SHORTMATRIX *	read_shortmatrix (FILE , char , short)

LONGMATRIX *	read_longmatrix (FILE , char , short)

FLOATMATRIX *	read_floatmatrix (FILE , char , short)

DOUBLEMATRIX *	read_doublematrix (FILE , char , short)

CHARVECTOR *	read_charvector (FILE , char , short)

INTVECTOR *	read_intvector (FILE , char , short)

SHORTVECTOR *	read_shortvector (FILE , char , short)

LONGVECTOR *	read_longvector (FILE , char , short)

FLOATVECTOR *	read_floatvector (FILE , char , short)

DOUBLEVECTOR *	read_doublevector (FILE , char , short)

SHORTBIN *	read_shortbin (FILE , char , short)

INTBIN *	read_intbin (FILE , char , short)

LONGBIN *	read_longbin (FILE , char , short)

DOUBLEBIN *	read_doublebin (FILE , char , short)

long	read_index (FILE *, short)

INTVECTOR *	read_intarray (FILE *, short)

SHORTVECTOR *	read_shortarray (FILE *, short)

FLOATVECTOR *	read_floatarray (FILE *, short)

LONGVECTOR *	read_longarray (FILE *, short)

CHARVECTOR *	read_chararray (FILE *, short)

DOUBLEVECTOR *	read_doublearray (FILE *, short)

STRINGBIN *	read_stringarray (FILE *, short)

void	justread_floatarray (FILE , FLOATVECTOR , short)

void	justread_floatmatrix (FILE , FLOATMATRIX , char *mode, short print)

void	justread_longarray (FILE , LONGVECTOR , short)

void	justread_chararray (FILE , CHARVECTOR , short)

void	write_floatarray_elements (FILE , FLOATVECTOR , long)

void	write_doublearray_elements (FILE , DOUBLEVECTOR , long)

void	write_shortarray_elements (FILE , SHORTVECTOR , long)

void	write_intarray_elements (FILE , INTVECTOR , long)

void	write_longarray_elements (FILE , LONGVECTOR , long)

void	write_chararray_elements (FILE , CHARVECTOR , long)

void	write_stringsarray_elements (FILE , STRINGBIN )

long	headercmp (HEADER , HEADER )

long	longvectorcmp (LONGVECTOR , LONGVECTOR )

void	read_matrixheader (FILE , HEADER )

void	read_vectorheader (FILE , HEADER )

int	header_scan (FILE , HEADER )

short	header_name_scan (FILE *, HEADER)

void	write_turtle (FILE , char , char *)

void	write_comment (FILE , const char , long)

void	write_header_header (FILE , HEADER H)

long	write_doubletensor_elements (FILE output, DOUBLETENSOR m, long maxcols)

void	print_doubletensor_elements (DOUBLETENSOR *m, long maxcols)

DOUBLETENSOR *	read_doubletensor (FILE inputfile, char mode, short print)

long	read_doubletensor_elements (FILE input, DOUBLETENSOR m, char *mode)

void	read_tensorheader (FILE inputfile, HEADER h)

Function Documentation

long binarywrite_charvector_elements	(	FILE *	output,
		CHARVECTOR *	v
	)

Write a vector of char to a file in binary mode

Definition at line 937 of file t_io.c.

References CHARVECTOR::co, CHARVECTOR::isdynamic, CHARVECTOR::nh, CHARVECTOR::nl, and t_error().

long binarywrite_doublebin_elements	(	FILE *	output,
		DOUBLEBIN *	l
	)

Write a list of double to a file

Here is still missing a check that output was open as "wb"

Definition at line 2523 of file t_io.c.

References LONGVECTOR::co, db::co, db::index, db::isdynamic, and t_error().

long binarywrite_doublematrix_elements	(	FILE *	output,
		DOUBLEMATRIX *	m
	)

Write a matrix of double to a file

Definition at line 1803 of file t_io.c.

References DOUBLEMATRIX::co, DOUBLEMATRIX::isdynamic, DOUBLEMATRIX::nch, DOUBLEMATRIX::ncl, DOUBLEMATRIX::nrh, DOUBLEMATRIX::nrl, and t_error().

long binarywrite_doublevector_elements	(	FILE *	output,
		DOUBLEVECTOR *	v
	)

Write a vector of double to a file in binary mode

Definition at line 786 of file t_io.c.

References DOUBLEVECTOR::co, DOUBLEVECTOR::isdynamic, DOUBLEVECTOR::nh, DOUBLEVECTOR::nl, and t_error().

long binarywrite_floatmatrix_elements	(	FILE *	output,
		FLOATMATRIX *	m
	)

Write a matrix of float to a file

Definition at line 1632 of file t_io.c.

References FLOATMATRIX::co, FLOATMATRIX::isdynamic, FLOATMATRIX::nch, FLOATMATRIX::ncl, FLOATMATRIX::nrh, FLOATMATRIX::nrl, and t_error().

long binarywrite_floatvector_elements	(	FILE *	output,
		FLOATVECTOR *	v
	)

Write a vector of float to a file in binary mode

Definition at line 635 of file t_io.c.

References FLOATVECTOR::co, FLOATVECTOR::isdynamic, FLOATVECTOR::nh, FLOATVECTOR::nl, and t_error().

long binarywrite_intbin_elements	(	FILE *	output,
		INTBIN *	l
	)

Write a list of int to a file

Here is still missing a check that output was open as "wb"

Definition at line 1980 of file t_io.c.

References LONGVECTOR::co, INTBIN::co, INTBIN::index, INTBIN::isdynamic, and t_error().

long binarywrite_intmatrix_elements	(	FILE *	output,
		INTMATRIX *	m
	)

Write a matrix of int to a file

Definition at line 1281 of file t_io.c.

References INTMATRIX::co, INTMATRIX::isdynamic, INTMATRIX::nch, INTMATRIX::ncl, INTMATRIX::nrh, INTMATRIX::nrl, and t_error().

long binarywrite_intvector_elements	(	FILE *	output,
		INTVECTOR *	v
	)

Write a vector of int to a file in binary mode

Definition at line 334 of file t_io.c.

References INTVECTOR::co, INTVECTOR::isdynamic, INTVECTOR::nh, INTVECTOR::nl, and t_error().

long binarywrite_longbin_elements	(	FILE *	output,
		LONGBIN *	l
	)

Write a list of long to a file

Here is still missing a check that output was open as "wb"

Definition at line 2342 of file t_io.c.

References LONGVECTOR::co, LONGBIN::co, LONGBIN::index, LONGBIN::isdynamic, and t_error().

long binarywrite_longmatrix_elements	(	FILE *	output,
		LONGMATRIX *	m
	)

Write a matrix of long to a file

Definition at line 1455 of file t_io.c.

References LONGMATRIX::co, LONGMATRIX::isdynamic, LONGMATRIX::nch, LONGMATRIX::ncl, LONGMATRIX::nrh, LONGMATRIX::nrl, and t_error().

long binarywrite_longvector_elements	(	FILE *	output,
		LONGVECTOR *	v
	)

Write a vector of long to a file in binary mode

Definition at line 485 of file t_io.c.

References LONGVECTOR::co, LONGVECTOR::isdynamic, LONGVECTOR::nh, LONGVECTOR::nl, and t_error().

long binarywrite_shortbin_elements	(	FILE *	output,
		SHORTBIN *	l
	)

Write a list of short to a file

Here is still missing a check that output was open as "wb"

Definition at line 2161 of file t_io.c.

References LONGVECTOR::co, SHORTBIN::co, SHORTBIN::index, SHORTBIN::isdynamic, and t_error().

long binarywrite_shortmatrix_elements	(	FILE *	output,
		SHORTMATRIX *	m
	)

Write a matrix of shorts to a file

Definition at line 1110 of file t_io.c.

References SHORTMATRIX::co, SHORTMATRIX::isdynamic, SHORTMATRIX::nch, SHORTMATRIX::ncl, SHORTMATRIX::nrh, SHORTMATRIX::nrl, and t_error().

long binarywrite_shortvector_elements	(	FILE *	output,
		SHORTVECTOR *	v
	)

Write a vector of short int to a file in binary mode

Definition at line 181 of file t_io.c.

References SHORTVECTOR::co, SHORTVECTOR::isdynamic, SHORTVECTOR::nh, SHORTVECTOR::nl, and t_error().

int copy_buffer_into_stringbin	(	char *	buffer,
		STRINGBIN *	l
	)

Name: copy_buffer_into_stringbin

Synopsis: int copy_buffer_into_stringbin(char *,STRINGBIN *);

Version: 1.0

Description: In order to read a fixed number of strings whose

length is unknown, a buffer is inizialized and filled with the strings

reallocating each time is necessary a certain amount of memory

specified in the global variable BUFFER_INCREMENT. A buffer is termined

by a null character. Each string is separated by another by a whitespace

(in the sense of iswhitespace() - e.g. Harbison and Steele, 1995). While

reading them is kept track of the length of each string and the suitable

vector index for the string bin is inizialized (note: the number of string

must be known in advance). Finally one has to copy the content of the buffer

into its stringbin.

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Authors & Date: Riccardo Rigon, August 1997

Inputs: read_: A pointer to the buffer and a pointer to the stringbin.

Return: 1 if successful (otherwise it aborts).

See Also: iswhitespace, read_stringbin, print_stringbin_elements

Keywords: buffer, strings

Examples: 3.examples.c

Definition at line 2830 of file t_io.c.

References co, st::co, st::index, st::isdynamic, OK, and t_error().

Referenced by read_plane_strings(), and read_plane_strings_restricted().

char* get_filename	(	char *	working_directory,
		char *	program
	)

Name: get_filename

Synopsis: char *get_filename(char *WORKING_DIRECTORY,char *program);

Version: 0.8

Description: get_filename returns the full name of a file to work with. It is intended to be a platform

independent way to store input/output file names in a file. Thus avoiding to specify them on the standard input every

time the program is executed (this is particularly useful when the same program with the same inputs is executed several times).

The working directory (the variable: WORKING_DIRECTORY )is specified in the file

$PathFile that has to be placed in the directory where the programs are (Windows95/NT or Mac OS) or in the

current directory (Unixes). The file names are instead stored in a file whose name is $program where "program" is the

name of the program being executed.

Authors & Date : Riccardo Rigon, April 1998

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Inputs:

1) The pointer to working directory name

2) The pointer to the name of the program being executed

Return: the requested name

See Also: simplefind, get_parameter, get_string

Definition at line 3058 of file t_io.c.

References st::co, IO_FILES_COUNTER, join_strings(), NOPRINT, read_stringarray(), simplefind(), t_error(), t_fclose(), and WORKING_POSITION.

double get_parameter	(	char *	working_directory,
		char *	program
	)

Name: get_parameter

Synopsis: double *get_parameter(char *WORKING_DIRECTORY,char *program);

Version: 0.8

Description: get_parameter returns a requested parameter. It is intended to be a platform

independent way to store program parameter values in a file without having to specify them on the standard input every

time the program is executed. The working directory (the variable: WORKING_DIRECTORY )is specified in the file

$PathFile that has to be placed in the directory where the programs are (Windows95/NT or Mac OS) or in the

current directory (Unixes). The file names are instead stored in a file whose name is $program where "program" is the

name of the program being executed. Every parameter is first read as a double but assignement to a different type

of variable is possible

Authors & Date: Riccardo Rigon, April 1998

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Inputs:

1) The pointer to working directory name

2) The pointer to the name of the program being executed

Return: the requested variable

See Also: simplefind, get_filename, get_string

Definition at line 3126 of file t_io.c.

References DOUBLEVECTOR::co, IO_PARMS_COUNTER, join_strings(), NOPRINT, read_doublearray(), simplefind(), t_error(), t_fclose(), and WORKING_POSITION.

char* get_phrase	(	FILE *	inputfile,
		const char	separator
	)

isspace(label[i-1]) &&

Definition at line 3400 of file t_io.c.

References join_strings(), LABELINCREMENT, MAXLABELSIZE, skip_whitespaces(), t_error(), and WORKING_DIRECTORY.

Referenced by justread_floatmatrix(), read_charvector(), read_doublematrix(), read_doubletensor(), read_doublevector(), read_floatmatrix(), read_floatvector(), read_intmatrix(), read_intvector(), read_longmatrix(), read_longvector(), read_shortmatrix(), and read_shortvector().

char* get_strings	(	char *	working_directory,
		char *	program
	)

Name: char *get_string

Synopsis: char *get_string(char *WORKING_DIRECTORY,char *program);

Version: 0.8

Description: get_string returns a string needed by a program. It is intended to be a platform

independent way to store strings in a file without having to specify them on the standard input every

time the program is executed. The strings are stored in a file whose name is $program where "program" is the

name of the program being executed.

Authors & Date: Riccardo Rigon, April 1998

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Inputs:

1) The pointer to working directory name

2) The pointer to the name of the program being executed

Return: the requested string

See Also: simplefind, get_filename, get_parameter

Definition at line 3170 of file t_io.c.

References st::co, IO_FILES_COUNTER, join_strings(), NOPRINT, read_stringarray(), simplefind(), t_error(), t_fclose(), and WORKING_POSITION.

char* get_workingdirectory ( void )

Names: get_workingdirectory

Synopsis: char *get_workingdirectory(void );

Version: 1.0

Description: It asks for the working directory, i.e. the directory where inputs data are stored.

This directory can be alternatively specified in a file $WorkingPaths to be found in the executable directory

(for Windows or Mac systems where it is useful. In Unix systems it can be also the directory from where

the program containing this routine is called)

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Inputs: void

Return: a pointer to the resulting string (the working directory )

Examples: 1.examples.c

Authors & Date: Riccardo Rigon, October 1997

Definition at line 2992 of file t_io.c.

References t_error().

void goto_EOF ( FILE * inputfile)

Name: goto_EOF

Synopsis: void goto_EOF(FILE *);

Version: 1.0

Description: skips the whitespaces in a file and exits when a

normal character or EOF is found. It is very similar to skip_whitespaces.

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Authors & Date: Riccardo Rigon, February 1997

Inputs: the pointer to the opened file

Return: void

See Also: read_comment, iscomment, goto_EOF

Definition at line 2927 of file t_io.c.

Referenced by read_charvector(), and read_intbin().

short header_name_scan	(	FILE *	,
		HEADER
	)

int header_scan	(	FILE *	inputfile,
		HEADER *	h
	)

Name: header_scan

Version: 1.0

Description: reads the first part of a header

Authors & Date: Riccardo Rigon, September 1997

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Inputs: the pointer to the file where the header is stored

and the pointer to the HEADER variable where to write read information

Return: 1 if successfull

below stands for _vectorheader, matrixheader or

header

Authors & Date: Riccardo Rigon, February, September 1997

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Inputs: read_#: the pointer to the opened file. print_#

the HEADER to be printed

Return: a HEADER

Keywords: turtle file

Examples: 1.example.c

long read_index	(	FILE *	inputfile,
		short	print
	)

Name: read_index

Synopsis: long read_index(FILE *);

Version: 1.0

Description: reads the number of data blocks in a file. the format is:

index{a,Nm} where a is the number of blocks and Nm is the type of file. Nm is optional.

Authors & Date: Riccardo Rigon, September 1997

FILE: LIBRARIES/BASICS/t_io.h, LIBRARIES/BASICS/t_io.c

Inputs: a pointer to a file

Return: the number of blocks or 0 if unsuccessful in reading

char* join_strings	(	char *	first,
		char *	second
	)

void justread_chararray	(	FILE *	inputfile,
		CHARVECTOR *	vec,
		short	print
	)

void justread_floatarray	(	FILE *	inputfile,
		FLOATVECTOR *	vec,
		short	print
	)

void justread_floatmatrix	(	FILE *	inputfile,
		FLOATMATRIX *	C,
		char *	mode,
		short	print
	)

void justread_longarray	(	FILE *	inputfile,
		LONGVECTOR *	vec,
		short	print
	)

void print_doublematrix_elements	(	DOUBLEMATRIX *	m,
		long	maxcols
	)

void print_doubletensor_elements	(	DOUBLETENSOR *	m,
		long	maxcols
	)

void print_doublevector_elements	(	DOUBLEVECTOR *	v,
		long	maxcols
	)

void print_floatmatrix_elements	(	FLOATMATRIX *	m,
		long	maxcols
	)

void print_floatvector_elements	(	FLOATVECTOR *	v,
		long	maxcols
	)

void print_shortmatrix_elements	(	SHORTMATRIX *	m,
		long	maxcols
	)

void print_shortvector_elements	(	SHORTVECTOR *	v,
		long	maxcols
	)

CHARVECTOR* read_charvector	(	FILE *	inputfile,
		char *	mode,
		short	print
	)

long read_charvector_elements	(	FILE *	input,
		CHARVECTOR *	v,
		char *	mode
	)

int read_comment	(	FILE *	inputfile,
		int	opt,
		long	maxbuffersize,
		short	print
	)

DOUBLEVECTOR* read_doublearray	(	FILE *	inputfile,
		short	print
	)

DOUBLEBIN* read_doublebin	(	FILE *	inputfile,
		char *	mode,
		short	print
	)

long read_doublebin_elements	(	FILE *	input,
		DOUBLEBIN *	l,
		char *	mode
	)

DOUBLEMATRIX* read_doublematrix	(	FILE *	inputfile,
		char *	mode,
		short	print
	)

long read_doublematrix_elements	(	FILE *	input,
		DOUBLEMATRIX *	m,
		char *	mode
	)

DOUBLETENSOR* read_doubletensor	(	FILE *	inputfile,
		char *	mode,
		short	print
	)

Functions

Function Documentation

below stands for _vectorheader, matrixheader or

long read_doubletensor_elements	(	FILE *	input,
		DOUBLETENSOR *	m,
		char *	mode
	)

DOUBLEVECTOR* read_doublevector	(	FILE *	inputfile,
		char *	mode,
		short	print
	)

long read_doublevector_elements	(	FILE *	input,
		DOUBLEVECTOR *	v,
		char *	mode
	)

STRINGBIN* read_filenames	(	char *	working_directory,
		char *	program,
		char *	extension,
		char *	position
	)

FLOATVECTOR* read_floatarray	(	FILE *	inputfile,
		short	print
	)

FLOATMATRIX* read_floatmatrix	(	FILE *	inputfile,
		char *	mode,
		short	print
	)

long read_floatmatrix_elements	(	FILE *	input,
		FLOATMATRIX *	m,
		char *	mode
	)

FLOATVECTOR* read_floatvector	(	FILE *	inputfile,
		char *	mode,
		short	print
	)

long read_floatvector_elements	(	FILE *	input,
		FLOATVECTOR *	v,
		char *	mode
	)

INTBIN* read_intbin	(	FILE *	inputfile,
		char *	mode,
		short	print
	)