帮助:解析函数/padleft

padleft是一个解析函数。帮助:解析函数页列出了所有解析函数的说明。

padleft

从左侧填充字符串。MediaWiki原生支持。

将指定字符串填充到原字符串的左侧，直到达到要求的长度。支持多字节字符（如中文）并确保安全处理Unicode。

也可用于从左侧截取字符串，或重复指定文本

官方文档：MediaWiki文档

语法

{{padleft: 原字符串 | 目标长度 | 填充字符串 }}

原字符串：需要被填充的字符串
目标长度：填充后的总字符数（最大500）
填充字符串（可选）：用于填充的字符串，默认为"0"

填充时会循环使用填充字符串直到达到目标长度。如果原字符串已长于目标长度，则不做任何处理。

示例

默认填0 {{padleft: xyz | 5 }} → 00xyz
中文填充 {{padleft: 啊哈 | 5 | 填充 }} → 填充填啊哈
超长原文 {{padleft: 这个字符串太长了 | 5 | 填 }} → 这个字符串太长了
截断填充 {{padleft: | 3 | abcde }} → abc
重复输出 {{padleft: | {{#expr:{{#len: abc }} * 3 }} | abc }} → abcabcabc

底层代码

来自MediaWiki及其扩展的源代码，运行在服务端。此处仅供快速查阅，便于更充分的挖掘其"特性"。

// mediawiki-1.37.0\includes\parser\CoreParserFunctions.php
public static function padleft( $parser, $string = '', $length = 0, $padding = '0' ) {
	return self::pad( $parser, $string, $length, $padding, STR_PAD_LEFT );
}

/**
 * Unicode-safe str_pad with the restriction that $length is forced to be <= 500
 * @param Parser $parser
 * @param string $string
 * @param string $length
 * @param string $padding
 * @param int $direction
 * @return string
 */
public static function pad(
	$parser, $string, $length, $padding = '0', $direction = STR_PAD_RIGHT
) {
	$padding = $parser->killMarkers( $padding );
	$lengthOfPadding = mb_strlen( $padding );
	if ( $lengthOfPadding == 0 ) {
		return $string;
	}

	# The remaining length to add counts down to 0 as padding is added
	$length = min( (int)$length, 500 ) - mb_strlen( $string );
	if ( $length <= 0 ) {
		// Nothing to add
		return $string;
	}

	# $finalPadding is just $padding repeated enough times so that
	# mb_strlen( $string ) + mb_strlen( $finalPadding ) == $length
	$finalPadding = '';
	while ( $length > 0 ) {
		# If $length < $lengthofPadding, truncate $padding so we get the
		# exact length desired.
		$finalPadding .= mb_substr( $padding, 0, $length );
		$length -= $lengthOfPadding;
	}

	if ( $direction == STR_PAD_LEFT ) {
		return $finalPadding . $string;
	} else {
		return $string . $finalPadding;
	}
}

代码逻辑：

清理填充字符串中的解析标记(Strip marker)
检查填充字符串是否有效（非空）。无效直接返回原字符串
检查目标长度，限制最大值为500
检查要填充的字符串长度（目标长度 - 原字符串长度），小于0直接返回原字符串
循环构建要填充的字符串，直到达到目标长度
- 如果填充字符串长度不匹配需求，会截取部分内容
拼接到原字符串左侧

实际用例

一些Wiki使用了相关特性，如下所示这个静态列表可能在下列页面更改后过时，仅供批判性参考。

碧蓝航线 - blhx

原神 - ys

崩坏：星穹铁道 - sr

代号鸢 - yuan

密探故事录入

赛马娘 - umamusume

黑神话：悟空 - wukong

正负色显

白荆回廊 - bjhl

公主连结 - pcr

无期迷途 - wqmt

秘盟招募/行

孙美琪疑案 - sunmeiqi

人物档案

交错战线 - crosscore

千年之旅 - elf

CG

StardewValley星露谷物语 - stardewvalley

宝可梦大探险 - pq

新怪谈：秘密实验室 - scpsl

Coltit

小森灵 - xsl0

食谱

苍雾残响 - hazereverb406

驾驶员图鉴

少前:云图计划 - 42lab

同人作品

环行旅舍 - kelaiyinshe

关卡图鉴

突击莉莉终结之弹 - allb

掉落表列表

ARGONAVIS - aaside

Mp3

四叶草剧场 - clover

BangDream！少女乐团派对 - bangdream

美妙世界 - twewy

妃十三学园 - alterna

FormatCardNo

宇宙猜想 - yuzhou

云顶之弈 - tft

图标

《逃离塔科夫》官方 Wiki（镜像） - eft