@@ -50,4 +50,14 @@
 || ''start'' || 対象バイト列の変換開始位置。デフォルトの値は0 ||
 || ''end'' || 対象バイト列の変換終端位置。デフォルトの値は''(length octets)'' ||
 || ''string'' || 変換後の文字列。''(simple-array character *)''型 ||
 || ''legal?'' || 対象バイト列に変換不能なシークエンスが含まれていた場合は''nil''、それ以外の場合は''t''が返る ||
+
+
+[[BR]]
+
+=== __参考__ ===
+・creoleでのバイト列からユニコード文字列への変換方法概要[[BR]]
+　・UTF系(UTF-8,UTF-16)は、個別に変換コードを実装[[BR]]
+　・それ以外の文字コードは、あらかじめ作成しておいた変換テーブルに従って変換[[BR]]
+　・詳細は、右のURLを参照: [http://d.hatena.ne.jp/sile/20100425/1272205217 マルチバイト文字列→ユニコード文字列][[BR]]
+　・TODO: 変換テーブルの作成コードも配布物に含める

@@ -1,5 +1,5 @@
-= creole (ver 0.1.0) =
+= creole (ver 0.1.1) =
 
 === __概要__ ===
 
 ユニコード文字列とバイト列の相互変換を行うためのライブラリ。

@@ -1,5 +1,5 @@
-= creole (ver 0.0.2) =
+= creole (ver 0.1.0) =
 
 === __概要__ ===
 
 ユニコード文字列とバイト列の相互変換を行うためのライブラリ。

@@ -20,4 +20,34 @@
 (asdf-install:install :creole)
 }}}
 
 === __API__ ===
+
+-- Variable: '''*default-external-format*'''
+> デフォルトで使われる文字エンコーディング [[BR]]
+> 初期値は、UTF-8に固定 
+[[BR]]
+
+-- Variable: '''*external-formats*'''
+> 利用可能な文字エンコーディングの一覧 
+[[BR]]
+
+-- Function: '''string-to-octets''' ''string'' '''&key''' ''external-format'' ''start'' ''end'' '''=>''' (values ''octets'' ''legal?'')
+> 文字列を指定されたエンコーディングに従って、バイト列に変換する [[BR]]
+> 文字列内に変換不能な文字が含まれている場合、バイト列内の該当位置が代わりに''(code-char #\?)''で埋められる [[BR]]
+|| ''string'' || 変換対象となる文字列。string型 ||
+|| ''external-format'' || 変換に用いる文字エンコーディング方式[[BR]] 省略された場合は、''*default-external-format*''の値が使われる ||
+|| ''start'' || 対象文字列の変換開始位置。デフォルトの値は0 ||
+|| ''end'' || 対象文字列の変換終端位置。デフォルトの値は''(length string)'' ||
+|| ''octets'' || 変換後のバイト列。''(simple-array (unsigned-byte 8))''型 ||
+|| ''legal?'' || 対象文字列に変換不能な文字が含まれていた場合は''nil''、それ以外の場合は''t''が返る ||
+[[BR]]
+
+-- Function: '''octets-to-string''' ''octets'' '''&key''' ''external-format'' ''end'' ''start'' '''=>''' (values ''string'' ''legal?'')
+> バイト列を指定されたエンコーディングに従って、ユニコード文字列に変換する [[BR]]
+> バイト列内に変換不能なシークエンスを検出した場合、文字列内の該当位置が代わりに''#\?''で埋められる [[BR]]
+|| ''octets'' || 変換対象となるバイト列。''(simple-array (unsigned-byte 8))''型 ||
+|| ''external-format'' || 変換に用いる文字エンコーディング方式[[BR]] 省略された場合は、''*default-external-format*''の値が使われる ||
+|| ''start'' || 対象バイト列の変換開始位置。デフォルトの値は0 ||
+|| ''end'' || 対象バイト列の変換終端位置。デフォルトの値は''(length octets)'' ||
+|| ''string'' || 変換後の文字列。''(simple-array character *)''型 ||
+|| ''legal?'' || 対象バイト列に変換不能なシークエンスが含まれていた場合は''nil''、それ以外の場合は''t''が返る ||

@@ -1 +1,23 @@
+= creole (ver 0.0.2) =
 
+=== __概要__ ===
+
+ユニコード文字列とバイト列の相互変換を行うためのライブラリ。
+
+=== __対応__ ===
+
+ユニコード(UTF-32)に対応しているCommon Lisp処理系で動作可能。[[BR]]
+ただし、SBCL(1.0.28以降)にのみ最適化されているため、それ以外の処理系では実用的な速度が出ない可能性がある。
+
+=== __依存パッケージ__ ===
+
+[http://github.com/sile/charseq charseq]
+
+=== __インストール方法__ ===
+
+{{{ code lisp
+;; asdf-installパッケージが利用可能なことが前提
+(asdf-install:install :creole)
+}}}
+
+=== __API__ ===