メソッドの型は、 get_next_key() のように引数なしか STR を引数にし STR を返り値にしています。 これは、 ファイルの一覧を見るとか、 特定のアドレスに対する何かの値を取り寄せる、 といった操作がよく使われるためです。
しかし、特定のアドレスに対する値が組になっている返り値もあります。 これは
KEY_STR => [ VALUE_STR_1 VALUE_STR_2 VALUE_STR_3 ]のようなデータ構造が返ってくることを期待する場合です。 たとえば fml4 の actives はメールアドレスに対していくつかのオプションの値を記述するので、 こういったデータ構造と考えられます。
例 rudo@nuinui.net s=skip m=xxx.yyy.z # commnet rudo@nuinui.net => [ s=skip m=xxx.yyy.z # comment ]
まとめると引数は「ない」か「STR」(正規表現も文字列の一種)なので STR とひとまとめにしても良いでしょう。 一方、返り値は STR か ARRAY_REF になります。
引数 返り値 --------------------------------------- なし => STR STR => STR なし => [STR, STR, ... ] STR => [STR, STR, ... ]
author's homepage is www.fml.org/home/fukachan/.
Also, visit nuinui's world :) at www.nuinui.net.
For questions about FML, e-mail <fml-bugs@fml.org>.