Zaurus BASIC ライブラリマニュアル Copyright 2000 小笠原博之 GA 3D Engine が内部で使用している Zaurus 用ライブラリです。 【関数マニュアル】 ●メモリ管理 現バージョンでは ZaurusOS のヒープ用 API をそのまま使用しています。そのため、 この関数は細かいメモリを数多く確保する用途には向きません。後から仕様変更され る可能性があります。 void *MemAlloc( int size ) ----------------------------------------------------------------------------- ヒープメモリからメモリを確保しポインタを返します。 ----------------------------------------------------------------------------- void MemFree( void *ptr ) ----------------------------------------------------------------------------- メモリを開放します。 ----------------------------------------------------------------------------- ●ファイル操作 ・ファイルローダ void *FsLoad( char *filename, int *size ) ----------------------------------------------------------------------------- 指定したファイルをメモリ上に読み込み、そのポインタを返します。エラー の場合は NULL を返します。メモリは MemAlloc() で確保されるので、不用 になったら MemFree() で開放してください。ファイルサイズが必要な場合 は size に受け取りバッファのアドレスを渡してください。サイズ情報が不 要な場合 size は NULL で構いません。ファイル名にドライブ名が含まれて いないときは、F0:filename、F1:filename の順で読込をリトライします。 ----------------------------------------------------------------------------- ・ファイルアクセス低レベル関数 ファイルアクセスは専用の構造体 FsFile を必要とします。 int FsOpen( FsFile *fs, char *file ) ----------------------------------------------------------------------------- ファイルをオープンします。成功すると TRUE、失敗で FALSE を返します。 ----------------------------------------------------------------------------- int FsCreate( FsFile *fs, char *file ) ----------------------------------------------------------------------------- ファイルを新規作成します。(未完成) ----------------------------------------------------------------------------- int FsClose( FsFile *fs ) ----------------------------------------------------------------------------- ファイルをクローズします。 ----------------------------------------------------------------------------- int FsSize( FsFile *fs ) ----------------------------------------------------------------------------- ファイルサイズを返します。 ----------------------------------------------------------------------------- int FsRead( FsFile *fs, void *buf, int size ) ----------------------------------------------------------------------------- ファイルの内容をバッファに読み込みます。読み込んだサイズを返し、エラー の場合は -1 が返ります。 ----------------------------------------------------------------------------- ●エラーメッセージ void ErrorMessage( char *format, ... ) ----------------------------------------------------------------------------- フォーマット付き文字列をダイアログに表示します。簡単なエラーメッセー ジの表示に使用します。文字列はフォーマット展開(s_formatv)後で 255byte までです。 ----------------------------------------------------------------------------- ●文字列操作 char *p_strcpy( char *str, char *ptr ) char *s_strcpy( char *str, char *ptr ) ----------------------------------------------------------------------------- 文字列をコピーします。 ----------------------------------------------------------------------------- char *s_itos( char *str, int num ) char *s_itosf( char *str, int num, int len ) ----------------------------------------------------------------------------- 数値を符号付き10進数文字列に変換します。 ----------------------------------------------------------------------------- char *s_itohs( char *str, int num ) char *s_itohsf( char *str, int num, int len ) ----------------------------------------------------------------------------- 数値を16進数文字列に変換します。 ----------------------------------------------------------------------------- char *s_formatv( char *str, char *format, void **arg ) ----------------------------------------------------------------------------- フォーマット付き文字列を展開します。使えるフォーマットは次の通り。 %s 文字列 %d 数値 10進数出力 %x 数値 16進数出力 %nd 桁数指定付き数値(nは10進数値) %nx 桁数指定付き数値(nは10進数値) ----------------------------------------------------------------------------- 2000/01/08 初版 2000/01/15 修正 小笠原博之 oga@art.udn.ne.jp http://www.vector.co.jp/authors/VA004474/