FSA: File of Stream Array(C/C++ Library)

標準 C 関数での読み書き手順	FSA 関数での読み書き手順	説明
#include <stdio.h> #include <fcntl.h> #include <unistd.h> int fd; fd=open(pathname,openmode); read(fd,buf,count); write(fd,buf,count); close(fd);	/* fsa.h must be included before using FSA API */ #include "fsa.h" FSA_HANDLE h; FsaOpen(&h,pathname, openmode); FsaReadStream(h,i,buf,from,count); FsaWriteStream(h,i,buf,from,count); FsaClose(&h);	標準 C ライブラリィも FSA も最初に対象ファイルをオープンして処理後にクローズするのは同じです。 標準 C の write() に FSA では FsaWriteStream()、 標準 C の read() に FSA では FsaReadStream() が対応します。 FSA では seek() が無いので、引数に処理開始バイト位置の from を指定する必要があります。 最大の違いは FsaReadStream() と FsaWriteStream() ではストリームのインデックス i を指定していることです。 FSA では 同じファイルに読み書きを実行しても、 i が異なれば全く独立した互いに異なる処理と見なされます。従って、各 i 毎にサイズ（ストリームサイズ）が存在します。

標準 C の I/O	FSA の I/O

• 0　　 ... 正常終了
• 0以外 ... エラー（fsa.h 参照）

主要関数

n は FsaGetMaxStreamCount(h,&m) で取得できます（n=m-1）。また、m は FsaExtendMaxStreamCount(h,M) で自由に拡大できます（最低でも M 個ストリーム数を増やします）。

補助関数

エラーハンドラー

エラーハンドラーの引数と処理は以下の例（サンプルプログラム tans.c より）を参考にしてください。

int ErrorFunc(
	/* All arguments are set by FSA */
	FSA_HANDLE  handle,       /* FSA_HANDLE currently running.   */
	const char* function,     /* FSA function name the error detected */
	int         fsa_code,     /* FSA error code(see fsa.h) that FSA function detected.
                                     (If this is FSA_ERROR_UNDEFINED,then infomations after err_no may be undefined. */
	int         err_no,       /* copy of C system's errno. Use C standard function strerror(err_no) for detail. */
	const char* msg,          /* The error message that FSA function can describe. */
	const char* source_file,  /* The source file the error occured. */
	int         source_line   /* The source line the error occured. */
	)
{
	char ch;
	printf(" FSA Error: f=%s code=%d c_er=%d msg=%s file=%s line=%d\n", function, fsa_code, err_no, msg, source_file, source_line);
	if(err_no!=0) printf("        c error=%d:%s\n",err_no,strerror(err_no));
	printf("Continue or exit (c|e)?");
	do {
		ch = toupper(getchar());
	} while (ch != 'C' && ch != 'E');
	if (ch == 'E') {
		FsaClose(&handle);
		exit(EXIT_FAILURE);
	}
	return fsa_code;
}

サンプルプログラム(tans.c)