模板:Str mid

模板页面
文档图示 模板文档[查看] [编辑] [查看历史] [清除缓存]

Usage

Characters in the source string are counted: the first is index 1, the last one is index length of string. The substring requested can be defined by these two indexes. Also, the substring can be defined by one index, and the substring length. The options are: {{str mid|<string>|<index of first character>|<length of substring>|<index of last character>}} It returns a part of the <string>, starting with character on position index, length <sublength>, last character returned is end index.

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → efg

If parameter 2 is omitted, start is from character 1:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Abcde

If parameter 3 is omitted, the whole rest of the string is returned:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|15}} → opqrstuvwxyz

Counting from the end

By entering a negative value, the index is counted from the end:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}} → tuvw
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → tuvwxyz

Instead if substring length, use index for last character

By using parameter |4=n, a number, you do not ask for substring length, but the last character (as counted from the start of the input string):

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}} → efg

Spaces are kept

In the returned substring, spaces are kept:

  • >{{str mid|I like this.|2|6}}< → >like<

But the input string is trimmed:

  • >{{str mid| I like this. |2|6}}< → >like<

Error messages

When the ranges (either param2 or the substring length) is out impossible in the string, an error is returned:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|30}} → 字符串模块出错：截取字符串索引脱离区间
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}} → efghijklmnopqrstuvwxyz

The error can be suppressed by using |ignore errors=true. A blank (empty string) will be returned:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignore errors=true}} → efghijklmnopqrstuvwxyz

Error category

  • |no category=true switches off category adding.
  • |error category=[[Category:Your category name]] sets the category to be added when in case of an error.
Default is Category:Errors reported by Module String.

See also

字符串处理模板
切短
根据数量处理
模板链接：{{str mid}} 按位置及长度选取子串。
模板链接：{{trunc}} 切短到规定的字数。
模板链接：{{str left}} 切短或重复填充到规定的字数。
模板链接：{{str crop}} 从末尾切短特定数量的字元。
模板链接：{{chop head and tail}} To crop a specified number of characters off the beginning and end.
模板链接：{{str right}} 返回从左向右移除若干个字符后的字符串
模板链接：{{str rightc}} 返回从后向前指定数量的字符串，如果字符串为空则返回一个参数
模板链接：{{str rightmost}} To trim down to the last specified number of characters.
模板链接：{{str sub old}} To trim down to a specified number, starting at a given number from the left.
模板链接：{{str sub new}} Select a substr based on starting and ending index.
模板链接：{{str index}} 返回字符串的第×个字符
根据条件处理
模板链接：{{trim}} 移除首尾空格。
模板链接：{{str letter/trim}} To trim down to the beginning letters.
模板链接：{{str number/trim}} To trim down to the beginning numbers.
模板链接：{{trim brackets}} To trim any leading or trailing square brackets.
模板链接：{{trim quotes}} To trim leading or trailing matches quotes.
模板链接：{{String split}} 从长字符串中抽取短字符串。
模板链接：{{first word}} 切短至首个空格前。
模板链接：{{remove first word}} 移除首个空格前的内容。
模板链接：{{last word}} 切短至最后一个空格前。
模板链接：{{remove last word}} 移除最后一个空格前的内容。
专用于Wiki语法
模板链接：{{除链}} 去除Wiki连结的括号（Wiki代码）。
模板链接：{{remove file prefix}} 从档案名中去除“File:”（或“Image:”）。
模板链接：{{PAGENAMEBASE}} 去除字串末尾的括号文本（消歧义）。
模板链接：{{title disambig text}} 返回字串末尾的括号文本（消歧义）。
模板链接：{{WikiProjectbasename}} Removes "WikiProject" from a pagename.
模板链接：{{remove unranked}} Removes the string "unranked_" from the left of a string (taxonomy).
模板链接：{{ship prefix}} Returns the length of a ship's name prefix, if listed (ship names).
模板链接：{{title year}} Returns the 4-digit year from a pagename, if any.
插入、替换、长度
模板链接：{{strloc insert}} Inserts a string at character location strloc, or appends if strloc<=0.
模板链接：{{loop}} 特定次数重复字串。
模板链接：{{replace}} 在字串中查找并全部替换某字串后返回。
模板链接：{{str rep}} 在字串中查找并替换首次出现的某字串后返回。
模板链接：{{digits}} 移除字串中不是数字（0～9）的字元。
模板链接：{{str len}} 返回字串长度。
模板链接：{{str ≥ len}} 检查一个字串和某一给定长度相比是“更长或等长”还是“更短”。
模板链接：{{str ≤ len}} 检查一个字串和某一给定长度相比是“更短或等长”还是“更长”。
模板链接：{{str ≠ len}} 检查一个字串和某一给定长度相比是“不等长”还是“等长”。
模板链接：{{str ≤ ≥ len}} 检查一个字串和某一给定长度相比是“更短”、“等长”还是“更长”。
分析、技术
模板链接：{{str endswith}} 检查是否以给定的字符串结尾。
模板链接：{{str find}}
模板链接：{{strfind short}}		在一个字串中搜寻并返回特定字串的位置。
模板链接：{{str find0}} Zero-based substring search.
模板链接：{{str sub find}} 从指定的偏移量开始搜索一个子字符串。
模板链接：{{str letter}} 返回一个字符串开头的所有字符。
模板链接：{{str number}} 返回一个字符串开头的所有数字。
模板链接：{{str gtr str}} 判断两个字符串是否相等，然后根据返回相应的值。
模板链接：{{ASCII code}} 返回单个字符的ASCII码值
模板链接：{{a or an}} Takes a noun and produces the appropriate indefinite article, based on whether the first letter is a vowel.
   
Module:String
...Magic words About {{padleft:|}}.
...ParserFunctions About {{#titleparts:|}}, {{#expr:|}}, {{#ifeq:|}}, etc.
上述文档内容嵌入自Template:Str mid/doc。（编辑 | 历史）
编者可以在本模板的沙盒（创建 | 镜像）和测试样例（创建）页面进行实验。
请将模板自身所属的分类添加在文档中。本模板的子页面。
取自“https://www.qiuwenbaike.cn/index.php?title=Template:Str_mid&oldid=7260689”