加好友 发短信
等级:蝙蝠侠
帖子:297
积分:2634
威望:0
精华:0
注册:2010-4-10 16:10:02
|
Post By:2012-10-10 18:18:53 [只看该作者]
语法 |
解释 |
%title% |
音轨标题。若元数据 “title” 不存在则使用文件名代替。 |
%artist% |
艺术家名。依次检查下列元数据字段: “artist”, “album artist”, “composer”, “performer”。 |
%album artist% |
专辑艺术家名。依次检查下列元数据字段: “album artist”, “artist”, “composer”, “performer”。与 %artist% 不同的是 %album artist% 用于在整张专辑有不同艺术家的情况。 |
%track artist% |
音轨艺术家名。仅在 %album artist% 与 %artist% 不同的时候有效。用于与 %album artist% 共同使用以指定专辑中的不同艺术家,例如: ”%album artist% - %title%[ '//' %track artist%]” ;在这种情况下,最后一部分内容仅会在有根据音轨指定的艺术家存在时才会显示。 |
%album% |
专辑名。依次检查下列元数据字段: “album”, “venue”. |
%date% |
年代。使用元数据 “date” 字段。 |
%genre% |
流派,使用元数据 “genre” 字段。 |
%tracknumber% |
音轨号。仅在存在元数据 “tracknumber” 字段时有效。 |
%totaltracks% |
合计音轨。仅在存在元数据 “totaltracks” 字段时有效。 |
%discnumber% |
光盘编号。仅在存在元数据 “discnumber” 或 “disc” 字段时有效。 |
%totaldiscs% |
合计光盘。仅在存在元数据 “totaldiscs” 字段时有效。 |
%codec% |
编码格式名。若无法有效取得准确的编码格式,使用文件后缀。 |
%codec_profile% |
关于编码设置的附加信息,并不总是有效。 |
%filename% |
文件名,不包括后缀名和目录 |
%filename_ext% |
文件名,包括后缀名但不包括目录。 |
%directoryname% |
文件所处目录名。 |
%path% |
文件路径,注意排序时应使用 %path_sort% 而非 %path%。 |
%subsong% |
文件内的音轨编号,用于单文件支持多音轨的文件格式(例如章节和CUE)。 |
%path_sort% |
结合了音轨号的文件路径,用于排序;返回值不确定,因此不应依赖其返回值。 |
%length% |
长度,格式为 [HH:]MM:SS。 |
%length_seconds% |
长度,单位为秒,格式是整数。 |
%bitrate% |
比特率,单位为千比特每秒(kbps);支持动态 VBR 比特率。 |
%channels% |
声道数(mono/stereo/etc)。 |
%samplerate% |
采样率,单位为 Hz。 |
%replaygain_track_gain%, %replaygain_album_gain%, %replaygain_track_peak%, %replaygain_album_peak% |
播放增益相关信息。 |
%filesize% |
文件大小,单位为字节。 |
%filesize_natural% |
文件大小,将根据实际情况返回如MB或KB的形式。 |
%last_modified% |
返回文件最后更改时间,格式为 YYYY-MM-DD HH:MM:SS。 |
以上列表内容没有完成,还有一些不太重要的字段如 %field%、元数据和 %__field%、技术信息映射,它们用于保持向后兼容性。
语法 |
解释 |
%list_index% |
指定项目所在的列表编号。应用于:播放列表,由 masstagger/massrenamer 处理过的项目的列表,等等。在结果前补足0以适应列表中最大数的位数。 |
%list_total% |
指定项目所在列表的总项目数。应用于:播放列表,由 masstagger/massrenamer 处理过的列表,等等。 |
%isplaying% |
若当前项目正在播放则有效,例如: 一个播放列表项正在播放。用于 $if() 中的条件。 |
%ispaused% |
若当前项目正在播放并处于暂停状态则有效,例如: 一个播放列表项已暂停。用于 $if() 中的条件。 |
%playback_time% |
当前播放时间,格式为 [HH:]MM:SS。仅在某些使用播放上下文信息的地方有效,例如状态栏。 |
%playback_time_seconds% |
当前播放时间,单位为秒。格式为整数。仅在某些使用播放上下文信息的地方有效,例如状态栏。 |
%playback_time_remaining% |
剩余播放时间,格式为 [HH:]MM:SS。仅在某些会使用播放上下文信息的地方有效,例如状态栏。若当前播放音轨无持续时间信息则无效。 |
%playback_time_remaining_seconds% |
剩余播放时间,单位为秒。格式为整数。仅在某些使用播放上下文信息的地方有效,例如状态栏。若当前播放音轨无持续时间信息则无效。 |
%queue_index% |
指定项目所处队列的编号,仅对播放列表有效。 |
%queue_indexes% |
指定项目所处队列的编号列表,仅对播放列表有效。当指定项目仅在队列中出现一次则与 %queue_index% 等价。 |
%queue_total% |
队列的项目总数。由于技术上的原因该字段仅对属于队列中音轨有效。 |
语法 |
解释 |
示例 |
$abbr(X) |
返回 X 的缩写。 |
$abbr(%album%) |
$abbr(X,Y) |
若 X 的长度不大于 Y,则返回 X 的缩写,否则返回 X。 |
$abbr(%album%,5) |
$ansi(X) |
返回字符串 X 中属于当前代码页的部分,否则替换为相应最适合的字符。一般用于清理文件名与外部一些对Unicode支持不好的软件交互。 |
$ansi(%title%), $ansi(%filename%) |
$ascii(X) |
返回字符串 X 中属于ASCII表部分,否则替换为相应最适合的字符。一般用于与外部一些对Unicode支持不好的软件交互。 |
$ascii(%title%), $ascii(%filename%) |
$lower(X), $upper(X) |
将 X 转换到小写/大写。 |
$upper(%title%) |
$num(X,Y) |
显示数字 X 并在前补足0使其长度不小于 Y (用于音轨号等)。 |
$num(%tracknumber%,3) |
$caps(X) |
将所有单词的第一个字母转换为大写,所有其他字母转换为小写,例如: “blah BLAH” ? “Blah Blah”. |
$caps(%title%) |
$caps2(X) |
类似于 $caps,但是不改变已为大写的字母,例如: “blah BLAH” ? “Blah BLAH”. |
$caps2(%title%) |
$if(X,Y,Z) |
若 X 包含了至少一个有效字段,则执行/显示 Y, 否则执行/显示 Z。 |
$if(%artist%,%artist%,unknown artist) |
$if2(X,Y) |
与 $if(X,X,Y) 相同。 |
|
$if3(X,Y,Z,..) |
返回首先包含至少一个有效字段的参数。 |
|
$ifgreater(A,B,C,D) |
若数字 A 大于 B, 则执行/返回 C,否则执行/返回 D。 |
|
$iflonger(A,B,C,D) |
若字符串 A 长度大于 B,则执行/返回 C,否则执行/返回 D。 |
|
$ifequal(A,B,C,D) |
若数字 A 等于 B,则执行/返回 C,否则执行/返回 D。 |
|
$longest(A,B,C,….) |
比较字符串 A,B,C,…并返回最大长度的字符串。 |
$longest(%title%,%filename%) |
$len(X) |
返回字符串 X 的长度。 |
|
$pad(X,Y), $pad_right(X,Y) |
对字符串 X 前/后补足空格使其长度不小于 Y。 |
|
$pad(X,Y,Z), $pad_right(X,Y,Z) |
对字符串 X 前/后补足字符 Z 使其长度不小于 Y。 |
|
$cut(X,Y) |
截取 X 使其长度为 Y。 |
|
$padcut(X,Y), $padcut_right(X,Y) |
对字符串 X 前/后补足空格,并截取结果使其长度不大于 Y。 |
|
$insert(A,B,N) |
向字符串 A 中 N 个字符后插入字符串 B。 |
|
$add(X,Y), $sub(X,Y), $mul(X,Y), $div(X,Y), $mod(X,Y), $min(X,Y), $max(X,Y) |
数学运算,依次为:加、减、乘、除、取模、最小值、最大值。 |
|
$left(X,Y) |
返回字符串 X 的头 Y 个字符。 |
|
$right(X,Y) |
返回字符串 X 的后 Y 个字符。 |
|
$and(X,Y), $or(X,Y), $xor(X,Y), $not(X) |
逻辑运算符,依次为:与、或、异或、非。用于与 $if() 协作。 |
|
$fix_eol(x), $fix_eol(x,y) |
截取多行字符串,在字符串尾添加 ” (…)” (第一个版本) 或 y (第二个版本)。 |
|
$meta(X) |
返回元数据字段 X 的值。 |
$meta(artist) |
$meta_sep(X,Y), $meta_sep(X,Y,Z) |
返回元数据字段 X 中的值,对于多值情况,加上自定义分隔符。 |
$meta(artist,', ',' and ') ? “artist1, artist2 and artist3” |
$meta_num(X) |
返回元数据字段 X 中值的数目。 |
$info(X) |
返回名为 X 的技术信息。 |
$info(bitrate) |
$char(X) |
插入编号为 X 的 Unicode 字符。 |
$char(9674) |
$strcmp(X,Y) |
当字符串 X 和 Y 相同时返回 “1”,否则返回空字符串,用于与 $if() 协同使用。 |
|
$stricmp(X,Y) |
$strcmp(X,Y) 的不区分大小写版本。 |
|
$directory(X), $directory(X,N) |
从文件路径 X 中提取目录名,附加选项指定提取上 N 级目录名。 |
$directory(%path%,2) |
$directory_path(X) |
从文件路径 X 中获取相应目录路径。 |
$directory_path(%path%) |
$greater(X,Y) |
比较两个整数,检测是否 X > Y,用于与 $if() 和 逻辑运算符共同使用。 |
|
$longer(X,Y) |
比较两个字符串,检测是否 X 长度大于 Y,用于与 $if() 和 逻辑运算符共同使用。 |
|
$strchr(X,Y) |
查找字符串 X 中字符 Y 首先出现位置。 |
|
$strrchr(X,Y) |
查找字符串 X 中字符 Y 最后出现位置。 |
|
$strstr(X,Y) |
查找字符串 X 中字符串 Y 中首先出现位置。 |
|
$progress2(A,B,C,D,E) |
创建进度条。(版本2) |
$progress2(%playback_time_seconds%,%length%,20,’#’,’=’) ? ”#####===============” |
$select(N,A,B,C,….) |
返回从 A,B,C... 的第 N 个参数。 |
|
$repeat(X,N) |
重复X N 次。 |
|
$replace(A,B,C) |
将字符串 A 中所有出现的字符串 B 替换为字符串 C。 |
|
$ext(X) |
从文件名/路径 X 中提取后缀名。 |
$ext(%path%) |
$substr(A,B,C) |
返回 A 的子串,从第 B 个字符到 第C 个字符。 |
$substr(blah,1,2) ? “bl” |
$trim(A) |
移除字符串 A 中首/尾空白字符。 |
$trim(%title%) |
$tab() |
生成一个制表符,等同于 $char(9)。参见下面 “Tab(制表符)” 以获取详尽信息。 |
$tab() |
$stripprefix(X) |
将前缀 “A” 和 “The” 从X中移除。 |
$strippefix(%artist%) ? “The Prodigy” 变为 “Prodigy” |
$stripprefix(X,prefix1,prefix2,…) |
将指定前缀从 X 中移除。 |
$stripprefix(%artist%,a,the) ? “The Prodigy” 变为 “Prodigy” |
$swapprefix(X) |
将前缀 “A” 和 “The” 移动到 X 尾。 |
$swapprefix(%artist%) ? “The Prodigy” 变为 “Prodigy, The” |
$swapprefix(X,prefix1,prefix2,…) |
将指定前缀移动到 X 尾。 |
$swapprefix(%artist%,a,the) ? “The Prodigy” 变为 “Prodigy, The” |
$year(time) |
从时间/日期字符串中得到“年”(格式为4位数字)。 |
$year(%last_modified%) |
$month(time) |
从时间/日期字符串中得到“月”(格式为2位数字)。 |
$month(%last_modified%) |
$day_of_month(time) |
从时间/日期字符串中得到月中的第几天(格式为2位数字)。 |
$day_of_month(%last_modified%) |
$date(time) |
从时间/日期字符串中得到日期信息(格式为 YYYY-MM-DD)。 |
$date(%last_modified%) |
$time(time) |
从时间/日期字符串中得到时间信息(格式为 HH:MM:SS 或 HH:MM)。 |
$time(%last_modified%) |
|
|