コマンドリファレンス

以下で説明するコマンドは全て大文字と小文字の区別がありません。そのため例えば__datDATE(datID)__は、
__datdate(datID)__
__DATDATE(datID)__
__datDATE(datID)__
__DATdate(datID)__
__dAtdAtE(datID)__
としても全て同じコマンドとして解釈されます。

__beginDATLoop(fldID, sort)__

概要：

beginDATLoopとendDATLoopで囲まれた個所（ブロックと呼びます）は、fldIDで指定されたフォルダに含まれる一言の数だけ繰り返されます。このブロック内ではいくつかのコマンドで特別変数「DAT_ID」が使用できます。この「DAT_ID」は、繰り返しに際し自動的に一言のIDと置き換えられるので、例えばフォルダ内の一言のタイトルを全て書き出すということが可能です。DAT_IDが使用できるコマンドは以下の６つです。またブロック内でbeginDATLoopを入れ子構造にすることもできます。

このブロック内では以下の５組のコマンドを使用してサブブロックを設定することで、出力に使用されるブロックを細かく変化させることができます。

書式：

fldIDが-1のときのみ、sortは省略することができます。（この場合一言の順番は現在リスト画面に表示されている順番になります。）

サブブロックは５種類全て設定する必要はありません。必要あるもののみ設定してください。また順番も基本的には関係ありませんが、div系は先に記述されたものから条件判断がされます。例えばdiv(4,0)とdiv(2,0)を設定した場合、繰り返しの回数が４の時は、先に記述されているサブブロックが出力されます。

例１：

現在のリストの中に含まれている一言を全てこの形式で出力します。実際は以下のような形で出力されます。

例２：

現在のフォルダに含まれる一言のタイトルを、50音順で３列の表の形式で出力します。

__beginFLDLoop(fldID)__

概要：

beginFLDLoopとendFLDLoopで囲まれた個所（ブロックと呼びます）は、fldIDで指定されたフォルダに含まれるサブフォルダの数だけ繰り返されます。このブロック内ではいくつかのコマンドで特別変数「FLD_ID」が使用できます。この「FLD_ID」は、繰り返しに際し自動的にサブフォルダのIDと置き換えられるので、例えば含まれるサブフォルダの名前を全て書き出すということが可能です。FLD_IDが使用できるコマンドは以下の5つです。またブロック内でbeginFLDLoopを入れ子構造にすることもできます。

このブロック内では以下の５組のコマンドを使用してサブブロックを設定することで、出力に使用されるブロックを細かく変化させることができます。

該当するサブブロックが複数ある場合は、上から順に優先されます。

書式：

fldIDにはフォルダのIDを指定します。また-1（現在選択されているフォルダのID）、FLD_PARENT（親フォルダのID）、FLD_ID（beginFLDLoopとendFLDLoopのブロック内でのみ。現在繰り返されているサブフォルダのID）も使用できます。サブフォルダの出力される順番はツリー画面の並び方と同じです。

サブブロックは５種類全て設定する必要はありません。必要あるもののみ設定してください。また順番も基本的には関係ありませんが、div系は先に記述されたものから条件判断がされます。例えばdiv(4,0)とdiv(2,0)を設定した場合、繰り返しの回数が４の時は、先に記述されているサブブロックが出力されます。

例１：

サブフォルダに含まれている全ての一言のタイトルを出力します。

例２：

現在のフォルダに含まれるサブフォルダのフォルダ名を、３列の表の形式で出力します。

__beginReplace("string1", "string2")__

概要：

beginReplaceとendReplaceで囲まれた個所（ブロックと呼びます）の文字列をある文字列に置換します。ブロック内でbeginReplaceを入れ子構造にすることもできるので、同時にいくつの文字も置換することができます。この場合は内側のbeginReplaceから置換が実行されます。

置換は、ブロック内にあるコマンドが全て実行されてから置換されます。例えばブロック内に__datTEXT(-1,1)__などがあった場合は、該当する一言の本文中の文字が置換されて出力されます。

書式：

　string1に置換したい文字列を、string2に置換後の文字列を設定します。

__datDATE(datID)__

概要：

指定された一言の月日を出力します。

書式：

datIDに出力したい一言のIDを指定します。-1が指定された場合は、現在選択されている一言の月日を出力します。またbeginDATLoopとendDATLoopブロック内では、DAT_IDを指定することで、現在繰り返されている一言のIDを指定することができます。

表示用のフォーマットは標準では"%Y / %m / %d (%H:%M)"となっています。 これは"2000 / 1 / 25 (13:54)"と表示されます。

__datID(datID)__

概要：

指定された一言のIDを出力します。

書式：

datIDに出力したいフォルダのIDを指定します。-1が指定された場合は、現在選択されている一言のIDを出力します。またbeginDATLoopとendDATLoopブロック内では、DAT_IDを指定することで、現在繰り返されている一言のIDを指定することができます。

__datNAME(datID)__

概要：

指定された一言の名前（書いた人）を出力します。

書式：

datIDに出力したい一言のIDを指定します。-1が指定された場合は、現在選択されている一言の名前（書いた人）を出力します。またbeginDATLoopとendDATLoopブロック内では、DAT_IDを指定することで、現在繰り返されている一言のIDを指定することができます。

__datTEXT(datID, type)__

概要：

__datTLE(datID)__

概要：

指定された一言のタイトルを出力します。

書式：

datIDに出力したい一言のIDを指定します。-1が指定された場合は、現在選択されている一言のタイトルを出力します。またbeginDATLoopとendDATLoopブロック内では、DAT_IDを指定することで、現在繰り返されている一言のIDを指定することができます。

__endDATLoop()__

__endFLDLoop()__

__endReplace()__

__fldID(fldID)__

概要：

指定されたフォルダのIDを出力します。

書式：

fldIDに出力したいフォルダのIDを指定します。また-1（現在選択されているフォルダのID）、FLD_PARENT（親フォルダのID）、FLD_ID（beginFLDLoopとendFLDLoopのブロック内でのみ。現在繰り返されているサブフォルダのID）も使用できます。

__fldNAME(fldID)__

概要：

指定されたフォルダの名前を出力します。

書式：

fldIDに出力したいフォルダのIDを指定します。また-1（現在選択されているフォルダのID）、FLD_PARENT（親フォルダのID）、FLD_ID（beginFLDLoopとendFLDLoopのブロック内でのみ。現在繰り返されているサブフォルダのID）も使用できます。

__fldTEXT(fldID)__

概要：

指定されたフォルダの説明文を出力します。

書式：

fldIDに出力したいフォルダのIDを指定します。また-1（現在選択されているフォルダのID）、FLD_PARENT（親フォルダのID）、FLD_ID（beginFLDLoopとendFLDLoopのブロック内でのみ。現在繰り返されているサブフォルダのID）も使用できます。

__getSTR(index)__

概要：

一言スクリプトでは５つの文字列変数を使うことができます。このコマンドを使うと、indexで指定された番号（１〜５）の文字列を出力します。

書式：

indexには文字列の番号(1〜5)を指定します。

例：

__INCLUDE(datID, type)__

概要：

__INIT()__

概要：

文字列変数を全て初期化します。

__NOW()__

概要：

現在の日付、時間を表示します。

表示用のフォーマットは標準では"%Y / %m / %d (%H:%M)"となっています。 これは"2000 / 1 / 25 (13:54)"と表示されます。

__setSTR(index, "string")__

概要：

一言スクリプトでは５つの文字列変数を使うことができます。このコマンドは一言スクリプトで扱う文字列変数に文字列を代入するほか、特別定数の文字列を変更する時にも使用します。

書式：

indexには文字列の番号（１〜５）か指定するか、以下の特別定数を指定します。stringには代入する文字列を””で囲んで指定します。

特別定数：

__datDATE(ID)__や__NOW()__で日付を表示する時に使うフォーマット

例：