uspTukubaiコマンドに関する様々な資料がここにあります。

 

 

魂内検索

DOCUMENTS

COMMAND

FORUM

UEC DOCS

VIDEO

 

ABC順リスト |  カテゴリ別リスト
動画説明

mojihame

＜概要＞

mojihame : テンプレートに文字をはめ込む

＜書式＞

Usage   : mojihame <template> <data>            (plain)
          mojihame -l<label> <template> <data>  (line)
          mojihame -h<label> <template> <data>  (hierarchy)
Options : -n<string>
          -s<c>
          -b
          --all
          --backslash
Version : Thu Feb  7 20:09:30 JST 2019
Edition : 2

＜オプション＞

-l : 行単位のデータを繰り返しはめ込む（-> 例７、８、９）
-h : 階層的データをはめ込む（-> 例１０、１１）

-n : 空文字列に置換する文字列を指定する（-> 例３）
-s : 空白に置換する文字を指定する（-> 例４）

＜説明＞

引数に指定する <template> ファイルに、<data> からデータを読んで、値
をはめ込みます。以下の３つの使い方があります。

1. <data> の全体のフィールドを順番にはめ込む（通常）

2. <data> の各行のフィールドを <template> 全体に繰り返しはめ込む
   または <template> の指定ラベル間に繰り返しはめ込む（行単位）

3. <data> の各行のフィールドを <template> の指定ラベル間に階層的には
   め込む（階層データ）

ファイル名を省略した時および "-" を指定した時は標準入力から読み込み
ます。<template> か <data> のいずれか一方のみを標準入力にできます。

＜例１ 通常＞

<template> 中にある %1 %2 %3 ... の部分に、<data> のフィールド（左上
から 右下に順番に %1 %2 %3 ... に対応）を読んで置換します。<template>
中の %1 %2 %3 ... の出現順序、回数についての制限は有りません。
$ cat template
1st=%1
2nd=%2
3rd=%3 4th=%4
$ cat data
a b
c d
$ mojihame template data
1st=a
2nd=b
3rd=c 4th=d

＜例２ 通常（デフォルトの空白・空文字列置換機能）＞

デフォルトでは、<data> 中の "_" のみのフィールドは空文字列に置換され、
文字列中の "_" は空白に置換されます。エスケープしてある "\_" は "_"
に置換されます。
$ cat template
<input type="text" value="%1" />
<input type="text" value="%2" />
<input type="text" value="%3" />
$ cat data
_
usp_lab
usp\_lab
$ mojihame template data
<input type="text" value="" />
<input type="text" value="usp lab" />
<input type="text" value="usp_lab" />

空文字列に置換する文字列は、-n オプションで変更できます。（-> 例３）
空白に置換する文字は、-s オプションで変更できます。（-> 例４）

＜例３ -n オプション＞

デフォルトでは、"_" のみの <data> 中のフィールドは空文字列に置換され
ます。この空文字列に置換するフィールドを -n オプションで変更できます。
$ cat template
1st=%1+
2nd=%2+
3rd=%3+ 4th=%4+
$ cat data
USP _
_ LABO
$ mojihame template data
1st=USP+
2nd=+
3rd=+ 4th=LABO+
$ mojihame -nUSP template data
1st=+
2nd= +
3rd= + 4th=LABO+

-n オプションの後に文字列を指定しなかった場合には、空文字列に置換す
る機能は無効になります。
$ mojihame -n template data
1st=USP+
2nd= +
3rd= + 4th=LABO+

-n オプションを指定するだけでは、"_" が空白に置換されるので、"_" を
そのまま残したい場合は -s オプションを併用します。（-> 例４）

＜例４ -s オプション＞

デフォルトでは、<data> 中の文字 "_" は、空白に置換されますが、空白文
字に置換する文字を -s<c> オプションで変更できます。
$ cat template
1st=(%1)
2nd=(%2)
3rd=(%3)
$ cat data1
usp_001
usp_002
_
$ mojihame template data1
1st=(usp 001)
2nd=(usp 002)
3rd=()
# "0" を空白に置換
$ mojihame -s0 template data1
1st=(usp_  1)
2nd=(usp_  2)
3rd=()

エスケープしてある文字 "\<c>" は "<c>" に置換されます。
$ cat data2
usp_\0\01
usp_002
_
# エスケープしていない "0" だけを空白に置換
$ mojihame -s0 template data2
1st=(usp_001)
2nd=(usp_  2)
3rd=()

-s オプションの後に文字を指定しなかった場合は、空白に置換する機能は
無効になります。
$ mojihame -s template data1
1st=(usp_001)
2nd=(usp_002)
3rd=()

-s オプションを -n オプションと併用すると、全ての "_" をそのまま残す
ことができます。
$ mojihame -s -n template data1
1st=(usp_001)
2nd=(usp_002)
3rd=(_)

＜例５ --backslash オプション＞

このオプションを指定すると、<data> 中の文字 "\\" を "\" に変換します。
これにより、<data> 中の文字 "\\_" が "\ " に変換されるようになります。
$ cat template
1st=(%1)
2nd=(%2)
3rd=(%3)
$ cat data
\_ \\_ \\\_
$ mojihame template data
1st=(_)
2nd=(\_)
3rd=(\\_)
$ mojihame --backslash template data
1st=(_)
2nd=(\ )
3rd=(\_)

＜例６ 行単位（ラベル指定なし）＞

<data> は１行ずつ読み込まれ、行の各フィールドが "%1" "%2" ... に対応
します。次の行が読み込まれる時は、再び <template> が使用され、データ
がはめ込まれ出力されます。
$ cat template
1st=%1 2nd=%2
3rd=%3 4th=%4
$ cat data
a b c d
w x y z
$ mojihame -l template data
1st=a 2nd=b
3rd=c 4th=d
1st=w 2nd=x
3rd=y 4th=z
$ mojihame -r template data
1st=a 2nd=b
3rd=c 4th=d
1st=w 2nd=x
3rd=y 4th=z

<template> 中の %1 %2 %3 ... の出現順序、回数についての制限は有りま
せん。

この使い方は 旧 mojihame の -r と互換性があります。mojihame -r は将
来廃止されます。

＜例７ 行単位（ラベル指定あり）＞

-l オプションで引数（ラベル）を指定した場合、<template> の "ラベル"
で囲まれた行のみにデータが繰り返しはめ込まれます。このとき、"ラベル"
を含む行は出力されません。

ラベルで挟んだ区間の前後の部分は何も変換されません。"%数字" があって
も何も変換されず、そのまま出力されます。また、ラベルは開始行と終了行
の２箇所のみ記述可能です。
$ cat template
header %1
LABEL
1st=%1 2nd=%2
LABEL
footer %2
$ cat data
a b
y z
$ mojihame -lLABEL template data
header %1
1st=a 2nd=b
1st=y 2nd=z
footer %2

なお、指定した文字列を含む（部分一致する）行をラベル行と判断されます
ので、注意が必要です。例えば、-lLABEL を指定した場合、"xLABELx" など
もラベル行と判断されます。

＜例８ 行単位（複数回適用）＞

mojihame -l オプションを複数回使用することで、プルダウンなどの html
を簡易に生成することができます。指定ラベルは <template> 内に１組しか
認められていないので、次の例のように、内側のラベルから順番に値をはめ
ていく必要があります。

$ cat member
佐藤
鈴木
$ cat kbn1
東京
大阪
横浜
$ cat kbn2
男
女
$ cat template
氏名＝%1
K1
地名＝%1
K1
K2
性別＝%1
K2
$ mojihame -lK1 template kbn1 |
  mojihame -lK2 -        kbn2 |
  mojihame -l   -        member
氏名＝佐藤
地名＝東京
地名＝大阪
地名＝横浜
性別＝男
性別＝女
氏名＝鈴木
地名＝東京
地名＝大阪
地名＝横浜
性別＝男
性別＝女

＜例９ 行単位（--all オプション）＞

--all オプションを指定すると、すべての指定ラベルの組が認識されるよう
になります。この場合、指定ラベルの組で挟まれた区間が値のはめこみの対
象になり、すべての区間に同じ値が適用されます。
$ cat template
header %1
LABEL1
1st=%1 2nd=%2
LABEL1
----- %1
LABEL2
1st=%1 3rd=%3
LABEL2
footer %1
$ cat data
a b c
x y z
$ mojihame -lLABEL --all template data
header %1
1st=a 2nd=b
1st=x 2nd=y
----- %1
1st=a 3rd=c
1st=x 3rd=z
footer %1

＜例１０ 階層データ＞

-h オプションは、階層的なデータをはめ込みます。"-hラベル" とラベル名
を指定しなければなりません。階層ラベルは "ラベル-数字"（数字は 1, 2,
3 ...） の形式で <template> 中の行で指定します。

<template> において、階層的ラベルに囲まれた部分に現れる "%数字" 文字
列が、<data> のフィールドに対応します。

例えば、次の例の <template> 場合、
"LABEL-1" に囲まれている部分に "%1"
"LABEL-2" で囲まれた部分に "%1"、"%2"、"%3"
"LABEL-3" で囲まれている部分に "%4"、"%5" があります。

このとき、<data> の指定フィールドからなるキーが変化する回数だけ、各
ラベルで囲まれた部分が繰り返し値がはめられます。

なお、このような階層ラベルは <template> の中で１組しか認められません。
<template> 中の %1 %2 %3 ... の出現順序、回数についての制限は有りま
せん。
$ cat template
<?xml version="1.0"?>
<!- LABEL-1 ->
<name attr="%1">
  <!- LABEL-2 ->
  <place name="%1" code="%2" attr="%3">
    <!- LABEL-3 ->
    <kind>%4</kind>
    <time>%5</time>
    <!- LABEL-3 ->
  </place>
  <!- LABEL-2 ->
</name>
<!- LABEL-1 ->
$ cat data
山田 001 東京 A 10:00
山田 001 東京 B 10:00
山田 001 大阪 C 20:00
山田 001 大阪 D 20:00
山田 001 横浜 E 09:30
山田 001 横浜 F 09:30
鈴木 002 東京 G 16:45
鈴木 002 東京 H 16:45
鈴木 002 神戸 I 15:30
鈴木 002 神戸 J 15:30
$ mojihame -hLABEL template data
<?xml version="1.0"?>
<name attr="山田">
  <place name="山田" code="001" attr="東京">
    <kind>A</kind>
    <time>10:00</time>
    <kind>B</kind>
    <time>10:00</time>
  </place>
  <place name="山田" code="001" attr="大阪">
    <kind>C</kind>
    <time>20:00</time>
    <kind>D</kind>
    <time>20:00</time>
  </place>
  <place name="山田" code="001" attr="横浜">
    <kind>E</kind>
    <time>09:30</time>
    <kind>F</kind>
    <time>09:30</time>
  </place>
</name>
<name attr="鈴木">
  <place name="鈴木" code="002" attr="東京">
    <kind>G</kind>
    <time>16:45</time>
    <kind>H</kind>
    <time>16:45</time>
  </place>
  <place name="鈴木" code="002" attr="神戸">
    <kind>I</kind>
    <time>15:30</time>
    <kind>J</kind>
    <time>15:30</time>
  </place>
</name>

＜例１１ 階層データ（--all オプション）＞

--all オプションを指定すると複数組の階層ラベルを指定できます。各組の
階層やキーは異なっていても構いません。
$ cat template
header %1
LABEL-1
1-1 %1
LABEL-2
1-2 %1 %2
LABEL-2
1-1 %1
LABEL-1
----- %1
LABEL-1
2-1 %1
LABEL-1
footer %1
$ cat data
aaa bbb
aaa ccc
aaa ccc
AAA bbb
AAA ccc
$ mojihame -hLABEL --all template data
1-1 aaa
1-2 aaa bbb
1-2 aaa ccc
1-2 aaa ccc
1-1 aaa
1-1 AAA
1-2 AAA bbb
1-2 AAA ccc
1-1 AAA
----- %1
2-1 aaa
2-1 aaa
2-1 aaa
2-1 AAA
2-1 AAA
footer %1

＜注１＞

-e オプションは廃止しました。
（変数の受け渡しがファイルによらず、明示的になりにくいため）

＜注２ エスケープ文字の扱い＞

データの中の "\<c>"（<c> は空白に置換される文字）は "<c>" に置換され
ます。エスケープされていない "<c>" は " " に置換されます。
$ cat template
%1
$ cat data
ABC\nDEFnGHI\mJKL
$ mojihame -sn template data
ABCnDEF GHI\mJKL

デフォルトで "<c>" はアンダースコア "_" です。

-s<c> オプションで空白に置換する文字を変更できます。
-s<c> の <c> を指定しないと、空白に置換する機能は無効になりま
す。（-> 例４）

＜注３ 空文字列の扱い＞

-n<string> を指定すると、データ中に <string> と一致したフィールドが
あれば、テンプレート中の対応する "%数字" にヌルデータをはめ込みます。
$ cat template
X%1X
$ cat data
USP
$ mojihame -nUSP template data
XX

＜注４ 旧版との互換＞

旧版では、階層ラベルのサフィックス（"ラベル-数字" の "-数字"）はオプ
ショナルでした。このため、旧版用のテンプレートではエラーになる場合が
有ります。-b オプションを指定すると、このサフィックスの検査を抑止す
ることができます。この場合、--all オプションは指定できません。