ファイルフォーマットの仕様書の書き方メモ

ファイルフォーマットの仕様書を書くときに何に気をつけるべきか.
実際に仕様書見ながらプログラム書いていていて,こういうところに気をつけると良いのかなぁ,というメモ.

・大まかな構造はだいたい見ればわかる
・そうではなくて、欲しいのは例外条件や曖昧なところ
 ・これがなかったらどうなるか? 必須・オプションの条件
 ・この要素が複数個あったらどうなるか?
 ・初期値はいくつになるか?
 ・値の単位は何か?
 ・値の範囲は?
・忘れがちなところ
 ・ファイルの文字エンコーディングは?
 ・ファイルの改行コードは?

まぁ読み手が何を必要としているか,ちゃんと考えてみれば特に難しい話ではないと思う.

Posted at : 2013-05-25 00:18:21 / Category : none

Comments

まだコメントはありません / No comment.

Send comment


Name


Mail-address (empty is OK. If you want to notify update, please fill mail-address.)


Bot check code (240328 と入力してください / Please input 240328.)