Tools 是非官方社区Wiki。社区文档正在编写中，欢迎参与。 Wiki编辑答疑群：717421103
版本250923.2
全站通知：

帮助:解析函数/arraymap

来自WIKI实验室WIKI_BWIKI_哔哩哔哩
跳到导航 跳到搜索
arraymap 悬浮框🟢稳定可用
按分隔符拆分字符串，对每个元素应用格式转换后重新拼接
{{#arraymap: 字符串 | 分隔符 | 占位符 | 输出格式 | 输出分隔符 | 输出连接词 }}
扩展：Page Forms
数组
字符串处理
批量转换
相关函数
arraymaptemplate
相关资源

arraymap

拆分字符串，并按照指定格式拼接。出自扩展 Page Forms。

比如把字符串 apple, banana, cherry 拆分后，对每个水果名添加链接格式 [[水果:@]]，最终输出为 [[水果:apple]], [[水果:banana]], [[水果:cherry]]。

常用于根据原始数据，输出相同结构的内容。数据通常来自模板参数、SMW 查询或表达式结果。

语法

{{#arraymap: 字符串 | 分隔符 | 占位符 | 输出格式 | 输出分隔符 | 输出连接词 }}

参数

字符串
要处理的原始字符串
分隔符
拆分用的符号，默认为 , 英文逗号。留空时逐字符拆分（包括空格与换行）
占位符
在"输出格式"中用作替换的标记，通常用 @
输出格式
包含占位符的 wikitext，解析时会将占位符替换为当前子串。
输出分隔符
拼接各结果时使用的分隔符，默认 , （逗号+空格）
输出连接词
替代最后两个元素之间的分隔符，如“和”、“或”。默认与输出分隔符相同

效果

  • 输出：将处理后的所有非空元素按指定分隔符和连接词拼接成的字符串
  • 效果：对原始字符串的每个元素应用相同的格式转换，空元素和转换后为空的元素会被自动过滤


示例

用法 代码 结果
基本替换 {{#arraymap: a_b_c | _ | @ | '''@''' | + }} a+b+c
自定义格式 {{#arraymap: a_b_c | _ | @ | 有'''@'''的内容 | …… }} 有a的内容……有b的内容……有c的内容
添加连接词 {{#arraymap: 托奇_环理_小满_秘银_从云_辰纱 | _ | @ | [[首页|@]] | ， | 和 }}一起开会 托奇，环理，小满，秘银，从云 和 辰纱一起开会
配合模板/函数 {{#arraymap: apple, banana, cherry | , | @ | {{ucfirst:@}} }} Apple, Banana, Cherry
条件筛选 {{#arraymap: 2, 7, 4, 9, 3 |,|@|{{#ifexpr: @ > 5 | @ }} }} 7, 9

使用场景

在模板开发中，经常需要对一组数据应用相同的格式转换。

例如，当模板接收一个逗号分隔的角色列表 托奇,环理,小满 时，可能需要：

  • 为每个角色添加链接：[[角色:托奇]]、[[角色:环理]]、[[角色:小满]]
  • 或调用角色模板：{{角色卡片|托奇}} {{角色卡片|环理}} {{角色卡片|小满}}

如果手动处理，需要在模板中为每个可能的元素编写重复的代码，维护困难且无法应对数量不定的情况。

因此 arraymap 的典型应用场景是对数量不定的列表元素批量应用相同的格式转换。

实战中，arraymap最常见问题是多层嵌套导致难以阅读、理解和维护。当格式复杂时，可以通过 arraymaptemplate 调用模板渲染。在需要大量计算或字符串处理时，Lua模块更适合。

底层代码

/** mediawiki-extensions-PageForms-REL1_37 includes\parserfunctions\PF_ArrayMap.php
 * '#arraymap' is called as:
 * {{#arraymap:value|delimiter|var|formula|new_delimiter}}
 *
 * This function applies the same transformation to every section of a
 * delimited string; each such section, as dictated by the 'delimiter'
 * value, is given the same transformation that the 'var' string is
 * given in 'formula'. Finally, the transformed strings are joined
 * together using the 'new_delimiter' string. Both 'delimiter' and
 * 'new_delimiter' default to commas.
 *
 * Example: to take a semicolon-delimited list, and make each element
 * in the list a link, you could call the following:
 *
 * {{#arraymap:blue;red;yellow|;|x|[[x]]|;}}
 */

class PFArrayMap {
	public static function run( Parser $parser, $frame, $args ) {
		// Set variables.
		$value = isset( $args[0] ) ? trim( $frame->expand( $args[0] ) ) : '';
		$delimiter = isset( $args[1] ) ? trim( $frame->expand( $args[1] ) ) : ',';
		$var = isset( $args[2] ) ? trim( $frame->expand( $args[2], PPFrame::NO_ARGS | PPFrame::NO_TEMPLATES ) ) : 'x';
		$formula = isset( $args[3] ) ? $args[3] : 'x';
		$new_delimiter = isset( $args[4] ) ? trim( $frame->expand( $args[4] ) ) : ', ';
		$conjunction = isset( $args[5] ) ? trim( $frame->expand( $args[5] ) ) : $new_delimiter;
		// Unstrip some.
		if ( method_exists( $parser, 'getStripState' ) ) {
			// MW 1.35+
			$delimiter = $parser->getStripState()->unstripNoWiki( $delimiter );
		} else {
			$delimiter = $parser->mStripState->unstripNoWiki( $delimiter );
		}
		// Let '\n' represent newlines, and '\s' represent spaces.
		$delimiter = str_replace( [ '\n', '\s' ], [ "\n", ' ' ], $delimiter );
		$new_delimiter = str_replace( [ '\n', '\s' ], [ "\n", ' ' ], $new_delimiter );
		$conjunction = str_replace( [ '\n', '\s' ], [ "\n", ' ' ], $conjunction );

		if ( $delimiter == '' ) {
			$values_array = preg_split( '/(.)/u', $value, -1, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE );
		} else {
			$values_array = explode( $delimiter, $value );
		}

		$results_array = [];
		// Add results to the results array only if the old value was
		// non-null, and the new, mapped value is non-null as well.
		foreach ( $values_array as $old_value ) {
			$old_value = trim( $old_value );
			if ( $old_value == '' ) {
				continue;
			}
			$result_value = $frame->expand( $formula, PPFrame::NO_ARGS | PPFrame::NO_TEMPLATES );
			$result_value = str_replace( $var, $old_value, $result_value );
			$result_value = $parser->preprocessToDom( $result_value, $frame->isTemplate() ? Parser::PTD_FOR_INCLUSION : 0 );
			$result_value = trim( $frame->expand( $result_value ) );
			if ( $result_value == '' ) {
				continue;
			}
			$results_array[] = $result_value;
		}
		if ( $conjunction != $new_delimiter ) {
			$conjunction = " " . trim( $conjunction ) . " ";
		}

		$result_text = "";
		$num_values = count( $results_array );
		for ( $i = 0; $i < $num_values; $i++ ) {
			if ( $i == 0 ) {
				$result_text .= $results_array[$i];
			} elseif ( $i == $num_values - 1 ) {
				$result_text .= $conjunction . $results_array[$i];
			} else {
				$result_text .= $new_delimiter . $results_array[$i];
			}
		}
		return $result_text;
	}
}

处理流程：

  1. 参数提取：从参数数组中提取并展开字符串、分隔符、占位符、输出格式、输出分隔符和连接词，设置默认值
  2. 分隔符预处理：解除 nowiki 标签，将 \n 和 \s 转换为实际的换行符和空格
  3. 字符串拆分：若分隔符为空则按字符拆分（UTF-8安全），否则用 explode 按分隔符拆分
  4. 元素遍历处理：对每个非空元素执行以下操作：
    1. 去除首尾空格
    2. 展开输出格式模板（不展开参数和模板名）
    3. 将占位符替换为当前元素值
    4. 预处理为 DOM 树并完全展开
    5. 去除首尾空格后，仅保留非空结果
  5. 连接词处理：若连接词与分隔符不同，在连接词前后添加空格
  6. 结果拼接：遍历结果数组，使用输出分隔符连接元素，最后两个元素间使用连接词
  7. 返回输出：返回拼接后的完整字符串
帮助目录
工具

BWIKI编辑器 v2.6 • SmartClick • Table Editor • Table Generator • Table Convert • 格式转换 • New Bing • ChatGPT • 常用站外工具 • 编辑热力图

编辑帮助

设计首页 • Logo • 提示公告 • 投稿入口 • 背景 • 编辑规范 • 页面命名 • 术语表 • 范例

解析函数
A

Anchorencode • Arraydefine • Arraydiff • Arrayindex • Arrayintersect • Arraymap • Arraymaptemplate • Arraymerge • Arrayprint • Arrayreset • Arraysearch • Arraysearcharray • Arraysize • Arrayslice • Arraysort • Arrayunion • Arrayunique • Ask • Autoedit

B

Basepagename • Basepagenamee • Bidi

C

Calendarenddate • Calendarstartdate • Canonicalurl • Canonicalurle • Cascadingsources • Categorytree • Concept • Contributors • Count • Cscore • Css

D

Declare • Default_form • Defaultsort • Displaytitle • Dowhile • Dpl • Dplchapter • Dplmatrix • Dplnum • Dplreplace • Dplvar

E

Explode • Expr

F

Filepath • Follow • Forargs • Formatdate • Formatnum • Forminput • Formlink • Formredlink • Fornumargs • Fullpagename • Fullpagenamee • Fullurl • Fullurle

G

Gender • Grammar

I

If • Ifeq • Iferror • Ifexist • Ifexpr • Imgh • Imgw • Info • Int • Invoke

L

Language • Lc • Lcfirst • Len • Listfilter • Listmap • Listmerge • Listsort • Listunique • Localurl • Localurle • Loop • Lst • Lstapp • Lstcnt • Lstcntuniq • Lstelem • Lstfltr • Lstfnd • Lsth • Lstind • Lstjoin • Lstmap • Lstmaptemp • Lstprep • Lstrm • Lstsep • Lstsrt • Lstsub • Lstuniq • Lstx

N

Namespace • Namespacee • Namespacenumber • Ns • Nse • Numberingroup • Numberofactiveusers • Numberofadmins • Numberofarticles • Numberofedits • Numberoffiles • Numberofpages • Numberofpageviews • Numberofusers • Numberofviews

O

Or

P

Padleft • Padright • Pageid • Pagename • Pagenamee • Pagesincategory • Pagesize • Plural • Pos • Protectionexpiry • Protectionlevel

Q

Queryformlink

R

Rel2abs • Replace • Revisionday • Revisionday2 • Revisionid • Revisionmonth • Revisionmonth1 • Revisiontimestamp • Revisionuser • Revisionyear • Rmatch • Rootpagename • Rootpagenamee • Rpos • Rreplace • Rsplit

S

Seo • Set • Set_recurring_event • Show • Smwdoc • Special • Speciale • Sub • Subjectpagename • Subjectpagenamee • Subjectspace • Subjectspacee • Subobject • Subpagename • Subpagenamee • Switch

T

Tag • Talkpagename • Talkpagenamee • Talkspace • Talkspacee • Template_display • Template_params • Time • Timel • Titleparts • Token • Tokenif • Trim • Trimuesc

U

Uc • Ucfirst • Ueif • Ueifeq • Uesc • Uescnowiki • Ueswitch • Urldecode • Urlencode

V

Var • Var_final • Vardefine • Vardefineecho • Varexists

W

While • Widget

 总览交流答疑学习编辑模板插件资源推荐

取自“https://wiki.biligame.com/tools/index.php?title=帮助:解析函数/arraymap&oldid=53155”