non existent

Syntax

Title formatting スクリプトはリテラルテキスト、フィールド参照、関数の呼び出し、コメント、改行文字の組み合わせから成ります。常に文字列 (空の文字列もあり得ます) を出力します。

コメントは 2 つのスラッシュで始まる行です。(例 : // これはコメントです。)

フィールド参照はフィールド名をパーセント記号で括ります。(例 : %artist%)

関数の呼び出しはドル記号で始まり、関数名とパラメーターリストが続きます。パラメーターリストは空であるか、1 つ以上のパラメーターをコンマで区切ります (例 : $abbr(%artist%))。パラメーターになり得るのはリテラルテキスト、フィールド参照、または他の関数の呼び出しです。ドル記号と関数名の間、関数名と開き括弧の間に空白を含めてはいけません。

リテラルテキストにおいて、%、$、[、]、' (アポストロフィー / シングルクォート) は ' で囲んでエスケープしなければなりません。'[' (シングルクォートで囲んだ左ブラケット) は [ (左ブラケット) を出力します。特別なケースとして、'' (2 つのシングルクォート) は 1 つのシングルクォートを出力します。プレイリストにおいて、< と > は特別です。Dimmed and highlighted text を参照してください。

スクリプトが評価されるとき、文字列は関数のパラメーター、関数の呼び出し、フィールド参照を評価することで組み立てられます。コメントと改行文字 (CR と LF) は無視されます。改行を出力するには $crlf() を使用してください。フィールド参照はフィールドの値を文字列として返します。関数は文字列か数値、真偽値を返し、他の関数で使用することができます。

Default UI のプレイリストにおいてカスタムカラムとグルーピングスキームを入力するインターフェースは改行をサポートしていません。スクリプトは一行で書かれなければならず、コメントを含めてはいけません。

Arithmetic functions

このセクションの関数は整数値で計算を行うために使用されます。文字列は自動的に数値に変換されます。数値への変換は、数値と解釈され得る最長のプレフィックスを使用します。先頭の空白は無視されます。小数はサポートされません。

• c3po → 0
• 4.8 → 4
• -12 → -12
• - 12 → 0

$add(a,b)

a と b を足します。

任意の数の引数をとることができます。$add(a,b,...) は $add($add(a,b),...) と同じです。

$div(a,b)

a を b で割り、整数に切り捨てます。b が 0 と評価されたときは a を返します。

任意の数の引数をとることができます。$div(a,b,...) は $div($div(a,b),...) と同じです。

$greater(a,b)

a が b より大きければ true を返し、そうでなければ false を返します。

$max(a,b)

a と b における最大値を返します。

任意の数の引数をとることができます。$max(a,b,...) は $max($max(a,b),...) と同じです。

$min(a,b)

a と b における最小値を返します。

任意の数の引数をとることができます。$min(a,b,...) は $min($min(a,b),...) と同じです。

$mod(a,b)

a を b で割ったときの余りを返します。結果は a と同じ符号を持ちます。b が 0 になったときは a を返します。

任意の数の引数をとることができます。$mod(a,b,...) は $mod($mod(a,b),...) と同じです。

$mul(a,b)

a に b を掛けます。

任意の数の引数をとることができます。$mul(a,b,...) は $mul($mul(a,b),...) と同じです。

$muldiv(a,b,c)

a に b を掛け、それから c で割ります。結果は近似の整数に四捨五入されます。

$rand()

0 から 2³²-1 (4294967295) までの間で、ランダムな数を生成します。ソートに関連したコンテキストでのみ利用可能です。

$sub(a,b)

a から b を引きます。

任意の数の引数をとることができます。$sub(a,b,...) は $sub($sub(a,b),...) と同じです。

Boolean functions

このセクションの関数は真偽値 (true と false) を扱うために使用されます。真偽値はスクリプトにおいて明示的な表現はありません。文字列や数値を返しません。$if や関連した関数を用いた、より複雑な条件のために使うことができます。

foobar2000 はプログラミング言語における true や false のコンセプトを持ちませんが、0 や空の文字列は false とみなされ、それ以外は true とみなされます。数値の 0 と文字列の '0' に違いはなく、どちらも値とみなされ、真偽値は false となります。アポストロフィーは特定の文字をエスケープする場合にのみ必要です。$add() のような計算時に、値は数値として扱われます。

$and(expr,...)

任意の数の引数の論理積。すべての expr が true と評価される場合にのみ true を返します。

$or(expr,...)

任意の数の引数の論理和。少なくとも一つの expr が true と評価されれば true を返します。

$not(expr)

論理否定。expr が true であれば false を返し、false であれば true を返します。

$xor(expr,...)

任意の数の引数の排他的論理和。奇数個の引数が true であれば true を返します。

例 : $xor(expr1,expr2) は expr1 か expr2 の一方が true であれば true を返しますが、両者が true であれば false を返します。

Control flow functions

このセクションの関数は条件文に使用されます。

[...]

括弧内の表現を評価し、真偽値が true となれば、括弧内の文字列と真偽値 true を返します。そうでなければ、空の文字列と真偽値 false を返します。

例 : [%artist%] は artist タグがあればその値を返します (括弧なしの %artist% の場合は ? を返します)。

$if(cond,then)

cond が true となれば then を評価し、値を返します。そうでなければ false を返します。

プレーンテキストは false と評価されます。フィールド検索や関数は true と評価され得ます。

• False: $if(0,True,False)
• False: $if('0',True,False)
• True または False: [$add(%rating%,1)]

最後の例は %rating% が設定されている場合にのみ、%rating% に 1 を足した値を表示します。

%album artist% が "various" を含むならこれを挿入しない場合

• 誤 : $if([%album artist%=Various],,%artist%-)
• 良い方法 : $if($stricmp(%album artist%,Various),,%artist%-)

$if(cond,then,else)

cond が true となれば then を評価し、値を返します。そうでなければ else を評価し、値を返します。

$if2(expr,else)

expr が一度だけ評価されるという点を除き、$if(expr,expr,else) と同様です。expr が true となれば expr を返し、そうでなければ else を評価し、値を返します。

$if3(a1,a2,...,aN,else)

true と評価されるものが見つかるまで、引数を a1 から aN まで順に評価します。見つかった時点で値を返します。そうでなければ else を評価し、値を返します。

$ifequal(int1,int2,then,else)

整数値 int1 と int2 を比較し、int1 が int2 と等しければ、then を評価し、値を返します。そうでなければ else を評価し、値を返します。

$ifgreater(int1,int2,then,else)

整数値 int1 と int2 を比較し、int1 が int2 より大きければ、then を評価し、値を返します。そうでなければ else を評価し、値を返します。

$iflonger(str,n,then,else)

文字列 str の長さと 数値 n を比較し、str が n より長ければ、then を評価し、値を返します。そうでなければ else を評価し、値を返します。

$select(n,a1,...,aN)

n の値が 1 から N までにあれば、値を返します。そうでなければ、false を返します。

String functions

このセクションの関数は文字列の操作に使用されます。

$abbr(str)

文字列 str の省略形を返します。英数字で始まる単語は最初の文字だけになり、スペースや括弧は取り除かれます。

$abbr('This is a Long Title (12-inch version) [needs tags]') → TiaLT1v[needst

$abbr(str,len)

str の文字数が len より長い場合、省略形を返します。そうでなければ str を返します。

$ansi(str)

文字列 str をシステムのコードページに変換します。システムのコードページの範囲に存在しない文字は削除または置換されます。ファイル名変更時など、ユニコード対応でないソフトとの互換性を持たせます。

$ascii(str)

文字列 str を ASCII に変換します。ASCII の範囲に存在しない文字は削除または置換されます。

$caps(str)

文字列 str にあるすべての単語の 1 文字目を大文字に、それ以外を小文字に変換します。

$caps2(str)

文字列 str にあるすべての単語の 1 文字目を大文字に変換し、それ以外はそのままにします。

$char(nbr)

コード番号 nbr のユニコード文字を返します。

$crc32(str)

文字列 str の CRC32 を算出します。文字列のカラーリングでの仕様を意図しています。

例 : $rgb($mod($crc32(%album%),256),128,128)

$crlf()

改行コード (CR-LF) を挿入します。システム通知領域のツールチップなどへの出力を複数行にすることができます。

$cut(str,len)

文字列 str の左から len の数だけ文字を返します。$left(str,len) と同じ関数です。負の数は文字列全体を返します。

• $cut('abc123',3) → abc
• $cut('abc123',0) → (空の文字列)
• $cut('abc123',-1) → abc123

$directory(path)

ファイル path からディレクトリ名を抽出します。

$directory(path,n)

ファイル path から n 階層上のディレクトリ名を抽出します。

$directory_path(path)

ファイル path からディレクトリパスを抽出します。

$ext(path)

文字列 path (ファイル名またはフルパス) から拡張子を抽出します。

$filename(path)

フルパス path からファイル名を抽出します。

$fix_eol(str)

str が改行コード (CR-LF) を含んでいれば、改行コードとそれ以降の文字列は " (...)" に置換されます。そうでなければ str をそのまま返します。

$fix_eol(str,indicator)

str が改行コード (CR-LF) を含んでいれば、改行コードとそれ以降の文字列は indicator で置き換えられます。そうでなければ str をそのまま返します。

$hex(int,len)

整数 int を len の数だけ桁取りし、16 進法で表記します。必要に応じて左から 0 を詰めます。

$insert(str,insert,n)

文字列 insert を、文字列 str の n 文字目の後に挿入します。

$left(str,len)

文字列 str の左から len の数だけ文字を返します。$cut(str,len) と同じ関数です。負の数は文字列全体を返します。

• $left('abc123',3) → abc
• $left('abc123',0) → (空の文字列)
• $left('abc123',-1) → abc123

$len(str)

文字列 str の文字数を返します。

$len2(str)

2 バイト文字を考慮して (2 バイト文字を 2 文字として) 文字列 str の文字数を返します。

$longer(str1,str2)

文字列 str1 が文字列 str2 より長ければ true を返します。そうでなければ false を返します。

$lower(str)

文字列 str を小文字に変換します。

$longest(arg,...)

引数の中で文字列が最も長いものを返します。任意の数の引数をとることができます。

$num(nbr,len)

整数 nbr を len の数だけ桁取りし、10 進法で表記します。必要に応じて左から 0 を詰めます。len は負の数の場合にダッシュを含みます。nbr が数字でなければ 0 として扱います。

• $num(123,5) → 00123
• $num(-123,5) → -0123
• $num(4.8,5) → 00004
• $num(A1,5) → 00000

$pad(str,len)

文字数が len になるよう、文字列 str の右側に空白を挿入します。文字数が len より大きいときはもとの str のままです。

$pad_right(str,len)

文字数が len になるよう、文字列 str の左側に空白を挿入します。文字数が len より大きいときはもとの str のままです。

$pad(str,len,char)

文字数が len になるよう、文字列 str の右側に文字 char を挿入します。文字数が len より大きいときはもとの str のままです。

$pad_right(str,len,char)

文字数が len になるよう、文字列 str の左側に文字 char を挿入します。文字数が len より大きいときはもとの str のままです。

$padcut(str,len)

文字列 str が len より長ければ、str の左から len の数だけ文字を返します。そうでなければ、文字数が len になるよう、文字列 str の右側に空白を挿入します。

$padcut_right(str,len)

文字列 str が len より長ければ、str の左から len の数だけ文字を返します。そうでなければ、文字数が len になるよう、文字列 str の左側に空白を挿入します。

$padcut(str,len,char)

文字列 str が len より長ければ、str の左から len の数だけ文字を返します。そうでなければ、文字数が len になるよう、文字列 str の右側に文字 char を挿入します。

$padcut_right(str,len,char)

文字列 str が len より長ければ、str の左から len の数だけ文字を返します。そうでなければ、文字数が len になるよう、文字列 str の左側に文字 char を挿入します。

$progress(pos,range,len,char1,char2)

プログレスバーを作成します。pos : インジケーターの位置。range ：プログレスバーの範囲。len : プログレスバーの長さを文字数で指定。char1, char2 : プログレスバーを構成する文字。

例 : $progress(%_time_elapsed_seconds%,%_time_total_seconds%,20,'#','=') は ====#=============== を作成し、# が再生位置に合わせて移動するように見えます。

$progress2(pos,range,len,char1,char2)

プログレスバーを作成します。pos : インジケーターの位置。range ：プログレスバーの範囲。len : プログレスバーの長さを文字数で指定。char1, char2 : プログレスバーを構成する文字。$progress とは異なる見た目になります。

例 : $progress2(%_time_elapsed_seconds%,%_time_total_seconds%,20,'#','=') は ####================ を作成し、# が再生位置に合わせて = を置き換えていくように見えます。

$repeat(expr,count)

expr を count 回繰り返します。expr は値を用いる前に評価されるので、$repeat はループには使用できません。

$replace(str,search,replace)

文字列 str に現れるすべての文字列 search を文字列 replace に置換します。任意の数の引数をとることができます。

$replace(str,search1,replace1,search2,replace2) は $replace($replace(srt,search1,replace1),search2,replace2) と同じではありません。

例 : $replace(ab,a,b,b,c) → bc, $replace($replace(ab,a,b),b,c) → cc

$right(str,len)

文字列 str の右から len の数だけ文字を返します。

$roman(int)

整数 int をローマ数字で表記します。

$rot13(str)

与えられた文字列に対して ROT13 を実行します。

例 : $rot13('foobar2000') → sbbone2000

$shortest(arg,...)

引数の中で文字列が最も短いものを返します。任意の数の引数をとることができます。

$strchr(str,char)

文字列 str の中で文字 char が現れる最初の場所を返します。

例 : $strchr(abca,a) → 1

$strrchr(str,char)

文字列 str の中で文字 char が現れる最後の場所を返します。

例 : $strrchr(abca,a) → 4

$strstr(str1,str2)

文字列 str1 の中で文字列 str2 が現れる最初の場所を返します。この関数は大文字と小文字を区別します。

$strcmp(str1,str2)

文字列 str1 と str2 を、大文字と小文字を区別して比較します。

$stricmp(str1,str2)

文字列 str1 と str2 を、大文字と小文字を区別せず比較します。

$stripprefix(str)

文字列 str から、接頭辞となる A (不定冠詞) と The (定冠詞) を削除します。

$stripprefix(str,prefix1,prefix2,...)

文字列 str から、指定した接頭辞を削除します。

$substr(str,from,to)

文字列 str の from 文字目から to 文字目までの文字列を返します。

$swapprefix(str)

接頭辞となる A (不定冠詞) と The (定冠詞) を文字列 str の後尾に移動します。

$swapprefix(str,prefix1,prefix2,...)

指定した接頭辞を文字列 str の後尾に移動します。

$trim(str)

文字列 str の先頭にある、あるいは連続する空白を削除します。

$tab()

タブ文字を 1 つ挿入します。

$tab(count)

タブ文字を count の数だけ挿入します。

$upper(str)

文字列 str を大文字に変換します。

Track info fields and functions

このセクションの関数とフィールドはトラック情報のアクセスに使用されます。

Time and date functions

このセクションの関数は時刻や日付の文字列の処理に使用されます。

$year(time)

年の部分を 4 桁で返します。

$month(time)

月の部分を 2 桁で返します。

$day_of_month(time)

日の部分を 2 桁で返します。

$date(time)

日付の部分を YYYY-MM-DD の形式で返します。

$time(time)

時刻の部分を HH:MM:SS あるいは HH:MM の形式で返します。

Variable operations

文字列や数値を保存します。真偽値は保存できません。同じ文字列を何度も必要とする場合などに最適です。変数は大文字と小文字を区別しません。

$get(name)

変数 name に最後に保存された値を返します。変数が定義されていなければ何も返しません。$get で返される真偽値は、変数が定義され、空の文字列でないかどうかを示します。

$put(name,value)

変数 name に値 value を保存し、同時に返します。

$puts(name,value)

変数 name に値 value を保存しますが、何も返しません。

$put(foo,bar)$char(10)
$get(foo)$char(10)
$get(Foo)$char(10)
$puts(foo,2000)$char(10)
$get(foo)$char(10)

bar
bar
bar

2000

Component-specific fields and functions

このセクションでは特定のコンポーネントで使用されるフィールドと関数を列挙します。