acl3 : A C-lang Library ver.3
基本方針
- mainは置き換えない。AComArgも使わない。・・・おかげで癖がなくなった。
各種短縮表記
| Ai | intptr_t |
| Ap | void * |
| As | static |
| Av | void |
| AStr | char * |
| ACStr | const char * |
AM (malloc, free, reallocの代用)
- Ap AM_alc(AM *w, AM_Vt *v, Ai n)
- malloc(n)の代用。wやvはシステムが提供しているものをそのまま使う。
- Av AM_fre(AM *w, AM_Vt *v, Ap p, Ai n)
- free(p)の代用。nはAM_alc()したときと同じ値を渡す。直前にrlcしているのならそのn1を渡す。
- Ap AM_rlc(AM *w, AM_Vt *v, Ap p, Ai n0, Ai n1)
- realloc(p, n1)の代用。n0はAM_alc()したときと同じ値を渡す。直前にrlcしているのならそのn1をn0として渡す。
AX (サイズ可変メモリ) (旧名：AExpMem)
- AX_ini(AX *w)
- コンストラクタ。
- コンストラクタを呼んだ直後にw->mとw->mvを上書きすれば、利用するAMを切り替えられる。
- AX_dst(AX *w)
- Av AX_ini4(AX *x0, AX *x1, AX *x2, AX *x3)
- x0～x3をiniするだけ。x2やx3にNULLを指定すれば、それは無視してくれる。
- Av AX_dst4(AX *x0, AX *x1, AX *x2, AX *x3)
- x0～x3をdstするだけ。x2やx3にNULLを指定すれば、それは無視してくれる。
- Av AX_rsv(AX *w, Ai n)
- w->p + w->n からnバイトをリザーブして、自由に読み書きできるようにする。
- 書き込みが済んだら w->n を更新するのを忘れずに。
- Av AX_putc(AX *w, char c)
- 1バイト書き込み（AX_rsv(1)して、cを書いて、n++する）。
- Av AX_puts0(AX *x, Ap s, Ai n)
- Av AX_puts(AX *x, ACStr s)
- AX_puts0(x, s, strlen(s));する。
- Ai AX_fread(AX *x, FILE *fp)
- ファイルをEOFまで読み込んでメモリに格納。読み込んだバイト数を返す。
- Av AX_fread1(AX *x, ACStr path, Ai flg)
- AOpen(path, "rb")してfread()してfclose()する。
- pathが"-"の場合は、stdinからfreadする。
- flg:4=ファイル内にCR（0x0d）の文字がある場合はこれをすべて取り除く。
- flg:2=ファイル読み取り後に AX_putc('\n'); する。
- flg:1=ファイル読み取り後に AX_putc('\0'); する（色々な用途に使えるように16バイトの0x00を付与している）。
- Av AX_fwrite1(AX *x, ACStr path, ACStr mod)
- AOpen()してfwrite()してfclose()する。
- pathが"-"の場合は、stdoutへfwriteする。
- x->pからx->nバイトをファイルに出力。
- Av AX_gets0(AX *x, Ap s, Ai n)
- sからnバイトの内容からなる文字列をAX上に作る。末尾に'\0'は付与しない（必要なら自分でやる）。呼び出し前に入っていた内容は上書きで消えるので気にしなくてよい。
- AStr AX_gets(AX *x, ACStr s)
- s1 = Astrchr1(s, '\n', 3); AX_gets0(x, s, s1 - s); AX_putc(x, '\0'); return s1;する。
ATokenMgr (文字列にIDを割り当てる)
- ATokenMgr_ini(ATokenMgr *w)
- コンストラクタ。
- コンストラクタを呼んだ直後にw->mとw->mvを上書きすれば、利用するAMを切り替えられる。
- ATokenMgr_dst(ATokenMgr *w)
- Ai ATokenMgr_s2i(ATokenMgr *w, ACStr s, Ai n)
- sからのn文字の文字列に対応する整数（＝トークン番号）を返す。新規登録の場合はsを内部にコピーするため、sを破棄しても問題なく動作し続ける。
- 内部で二分探索しているので、比較的高速に結果を返すことができる。
- AStr ATokenMgr_i2s(ATokenMgr *w, Ai i)
string系拡張
- AStr Astrstr1(ACStr s, ACStr t, Ai flg)
- 基本的にはstrstr()と同じ。
- flg:2=文字列が見つかった場合、strlen(t)を加算してから返す。
- flg:1=文字列が見つからない場合、s + strlen(s)を返す。
- AStr Astrchr1(ACStr s, char c, Ai flg)
言語処理系用
- AStr AskpSpc(ACStr s)
- AStr AliteralEnd(ACStr s, char t)
- 文字tが現れるまで読み飛ばす。返すポインタはtが見つかった場所を返す。バックスラッシュで文字tをエスケープしている場合は、止まらずに進む。
- AStr AparenthesisEnd(ACStr s, char p0, char p1, Ai flg)
- sの位置にあるカッコに対応する閉じカッコを探す。p0に'('をp1に')'を指定する。別の組み合わせでもよい。
- 返されるポインタはp1の次を指している。対応するカッコを見つける前にsが尽きた場合はNULLを返す。
- flg:1=処理中に文字列リテラルを見つけた場合、AliteralEnd()を使って読み飛ばす（だから文字列中にp0やp1が含まれていてもカウントしない）。
- flg:2=flg:1の処理でエラーがあった場合、これを無視して続行する（引用符を閉じないで改行しているとか）。
- flg:4=「//」のコメントを見つけた場合は、行末まで読み飛ばす。
- AStr AparenthesisEnd1(ACStr s, Ai flg)
- sの位置にあるカッコの種類に応じて、p0とp1を自動設定したのちにAparenthesisEnd()する。
バイナリ系
- Av AputBytes(Auc *p, Ai i, Ai s0, Ai s1, Ai s2, Ai s3)
- iの値をp[0], p[1], p[2], p[3]に書き込む。その際にs0～s3だけ右シフトしてAND 0xffする。
- 対応するsの値が-1の場合は、書き込みを行わない。
- Ai AgetBytes(Auc *p, Ai s0, Ai s1, Ai s2, Ai s3)
- p[0]～p[3]を読み込んで、s0～s3の値だけシフトしてORして、AputBytesのiを復元して返す。
- 対応するsの値が-1の場合は、読み込みを行わない。
そのほか
- FILE *AOpen(ACStr path, ACStr mod)
- fopen()の代わり。fopenがNULLを返した場合は適当なエラーメッセージをstderrに出力してexit(1)してくれる。
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
