Mô tổ:String

Mô khối hồ sơ[Xem xét] [Biên tập] [Lịch sử] [Thanh trừ hoãn tồn]

Cái này mô khối cung cấp cơ bảnTự phù xuyến thao tácHàm số.

Nơi này cung cấp đại đa số hàm số đều có thể sử dụng mệnh danh tham số, chưa mệnh danh tham số hoặc hỗn hợp tham số thuyên chuyển. Nếu sử dụng mệnh danh tham số, Mediawiki đem tự động từ tham số trung xóa bỏ bất luận cái gì dẫn đường hoặc theo đuôi không cách. Quyết định bởi với mong muốn sử dụng, giữ lại hoặc xóa bỏ này loại chỗ trống các có ưu khuyết.

Toàn cục tham số

ignore_errors

Nếu thiết trí vì “true” hoặc “1”, tắc bất luận cái gì sai lầm điều kiện đều đem dẫn tới phản hồi không tự phù xuyến mà không phải sai lầm tin tức.

error_category

Nếu phát sinh sai lầm, tắc chỉ định muốn bao hàm ở sai lầm tin tức trung phân loại tên. Cam chịu phân loại vìCategory: Tự phù xuyến mô khối báo cáo sai lầm( 19 ).

no_category

Nếu thiết trí vì “true” hoặc 1, thì tại sinh thành sai lầm khi sẽ không tăng thêm bất luận cái gì phân loại.

Này mô khối đơn nguyên thí nghiệm nhưng ởModule:String/testcasesTiến hành.

len

Này hàm số phản hồi mục tiêu tự phù xuyến chiều dài.

Cách dùng:

{{#invoke:String|len|target_string}}

Hoặc

{{#invoke:String|len|s=target_string}}

Tham số:

s

Mục tiêu tự phù xuyến

Thí dụ mẫu:

• {{#invoke:String|len| abcdefghi }}→ 11
• {{#invoke:String|len|s= abcdefghi }}→ 9

sub

Này hàm số phản hồi chỉ định hướng dẫn tra cứu chỗ mục tiêu tự phù xuyến tử tự phù xuyến.

Cách dùng:

{{#invoke:String|sub|target_string|start_index|end_index}}

Hoặc

{{#invoke:String|sub|s=target_string|i=start_index|j=end_index}}

Tham số:

s

Phản hồi này tự phù xuyến tử tập

i

Muốn phản hồi tử tự phù xuyến cái thứ nhất hướng dẫn tra cứu, cam chịu vì 1.

j

Muốn phản hồi tự phù xuyến cuối cùng một cái hướng dẫn tra cứu, cam chịu vì cuối cùng một chữ phù.

Tự phù xuyến cái thứ nhất tự phù hướng dẫn tra cứu vì 1. Nếu i hoặc j là giá trị âm, tắc đem này phân tích vì thông qua từ tự phù xuyến cuối cùng đếm hết tới lựa chọn tự phù. Bởi vậy, giá trị -1 cùng lựa chọn tự phù xuyến cuối cùng một chữ phù tương đồng.

Nếu thỉnh cầu hướng dẫn tra cứu vượt qua cấp định tự phù xuyến phạm vi, tắc sẽ báo cáo sai lầm.

Thí dụ mẫu:

• "{{#invoke:String|sub| abcdefghi }}"→ "abcdefghi"
• "{{#invoke:String|sub|s= abcdefghi }}"→ "abcdefghi"
• "{{#invoke:String|sub| abcdefghi | 3 }}"→ "bcdefghi"
• "{{#invoke:String|sub|s= abcdefghi |i= 3 }}"→ "cdefghi"
• "{{#invoke:String|sub| abcdefghi | 3 | 4 }}"→ "bc"
• "{{#invoke:String|sub|s= abcdefghi |i= 3 |j= 4 }}"→ "cd"

sublength

Này hàm số thực hiện {{Str sub old}} công năng, giữ lại chỉ vì duy trì cũ khuôn mẫu.

Cách dùng:

{{#invoke:String|sublength|s=Mục tiêu tự phù xuyến|i=Bắt đầu hướng dẫn tra cứu|len=Chiều dài}}

Tham số:

s

Tự phù xuyến

i

Phản hồi tử xuyến bắt đầu hướng dẫn tra cứu. Cái thứ nhất cái tự phù hướng dẫn tra cứu vì 0.

len

Phản hồi tự phù xuyến chiều dài, cam chịu vì cuối cùng một chữ phù.

Thí dụ mẫu:

• {{#invoke:String|sublength|s= abcdefghi }}→ abcdefghi
• {{#invoke:String|sublength|s= abcdefghi |i= 3 }}→ defghi
• {{#invoke:String|sublength|s= abcdefghi |i= 3 |len= 4 }}→ defg

match

Này hàm số từ nguyên tự phù xuyến phản hồi một cái xứng đôi chỉ định hình thức tử tự phù xuyến.

Cách dùng:

{{#invoke:String|match|Nguyên tự phù xuyến|Hình thức tự phù xuyến|Bắt đầu hướng dẫn tra cứu|Xứng đôi số lượng|Thuần đánh dấu|Vô cùng xứng phát ra}}

Hoặc là

{{#invoke:String|match|s=Nguyên tự phù xuyến|pattern=Hình thức tự phù xuyến|start=Bắt đầu hướng dẫn tra cứu|match=Xứng đôi số lượng|plain=Thuần đánh dấu|nomatch=Vô cùng xứng phát ra}}

Tham số:

s

Ở cái này tự phù xuyến nội tìm tòi

pattern

Yêu cầu ở tự phù xuyến nội tìm tòi hình thức hoặc là tự phù xuyến

start

Nguyên tự phù xuyến nội hướng dẫn tra cứu, từ đây hướng dẫn tra cứu bắt đầu tìm tòi. Tự phù xuyến cái thứ nhất tự phù hướng dẫn tra cứu vì 1. Cam chịu vì 1.

match

Ở một ít dưới tình huống, khả năng yêu cầu ở đơn cái tự phù xuyến trung tiến hành nhiều lần xứng đôi. Này tham số chỉ định phản hồi cái nào xứng đôi, trong đó cái thứ nhất xứng đôi chính là match=1. Nếu chỉ định số âm, như vậy phản hồi xứng đôi từ cuối cùng một cái xứng đôi bắt đầu số. Bởi vậy match=-1 biểu đạt phản hồi cuối cùng một cái xứng đôi. Cam chịu vì 1.

plain

pattern hay không hẳn là lý giải vì thuần tự phù xuyến, mà phi chính tắc biểu đạt thức. Cam chịu vì false.

nomatch

Nếu không có tìm được xứng đôi, phản hồi nomatch giá trị, mà không phải một sai lầm.

Nếu match_number hoặc start_index vượt qua tuần tra tự phù xuyến phạm vi, này hàm số sẽ sinh ra sai lầm. Nếu không có tìm được xứng đôi, cũng sẽ sinh ra sai lầm.

Nếu tăng thêm tham số ignore_errors=true, như vậy sai lầm sẽ bị cấm, thất bại khi phản hồi chính là một cái không tự phù xuyến.

Xứng đôi là Lua một loại chính tắc biểu đạt thức, càng nhiều tin tức có thể tham khảo:

• Scribunto patterns
• Scribunto Unicode string patterns

Thí dụ mẫu:

• {{#invoke:String|match| abc123def456 |%d+}}→ 123
• {{#invoke:String|match|s= abc123def456 |pattern= %d+ }}→ 123
• {{#invoke:String|match| abc123def456 |%d+|6}}→ 23
• {{#invoke:String|match|s= abc123def456 |pattern= %d+ |start= 6 }}→ 3
• {{#invoke:String|match|s= abc123def456 |pattern= %d+ |start= 6 |match= 2 }}→ 456
• {{#invoke:String|match|s= abc123%d+ |pattern= %d+ }}→ 123
• {{#invoke:String|match|s= abc123%d+ |pattern= %d+ |plain= true }}→ %d+
• {{#invoke:String|match|s= abc |pattern= %d }}→
• {{#invoke:String|match|s= abc |pattern= %d |nomatch= No numeric characters in string }}→ No numeric characters in string
• {{#invoke:String|match|s= abc |pattern= %d |ignore_errors= true }}→
• {{#invoke:String|match|s= 0012001200 |pattern= 0*(%d*) }}→ 12001200

pos

Phản hồi tại mục tiêu tự phù xuyến trung vị trí pos chỗ đơn cái tự phù.

Cách dùng:

{{#invoke:String|pos|Mục tiêu tự phù xuyến|Hướng dẫn tra cứu giá trị}}

Hoặc

{{#invoke:String|pos|target=Mục tiêu tự phù xuyến|pos=Hướng dẫn tra cứu giá trị}}

Tham số:

Mục tiêu

Tại đây tự phù xuyến nội tìm tòi

pos

Yêu cầu phản hồi tự phù nơi hướng dẫn tra cứu.

Cái thứ nhất tự phù hướng dẫn tra cứu giá trị vì 1.

Nếu vì giá trị âm, tắc này hàm số sẽ từ tự phù xuyến mặt sau cùng bắt đầu đếm ngược. Nói cách khác, pos=-1 tương đương với phản hồi cuối cùng một chữ phù.

Nếu này giá trị vì 0, hoặc là vượt qua tự phù xuyến chiều dài, tắc sẽ phản hồi sai lầm.

Thí dụ mẫu:

• {{#invoke:String|pos| abcdefghi | 4 }}→ c
• {{#invoke:String|pos|target= abcdefghi |pos= 4 }}→ d

str_find

Này hàm số cùng {{str_find}} hành vi lặp lại, bao hàm này sở hữu kỹ xảo, chỉ vì duy trì tồn tại khuôn mẫu, nhưng là đối với tân số hiệu cùng khuôn mẫuKhông đề cửSử dụng. Tân số hiệu kiến nghị trực tiếp sử dụng find hàm số.

Phản hồi nguyên tự phù xuyến trung xứng đôi mục đích cái thứ nhất hướng dẫn tra cứu. Hướng dẫn tra cứu là từ 1 bắt đầu số, nếu nguyên tự phù xuyến trung tìm không thấy mục tiêu tự phù xuyến, tắc phản hồi -1.

Chú ý: Nếu mục tiêu tự phù xuyến là chỗ trống hoặc là thiếu hụt, tắc hàm số phản hồi giá trị vì 1, này khả năng không phải mong muốn hành vi, cần thiết muốn đơn độc suy xét.

Cách dùng:

{{#invoke:String|str_find|Nguyên tự phù xuyến|Mục tiêu tự phù xuyến}}

Hoặc

{{#invoke:String|str_find|source=Nguyên tự phù xuyến|target=Mục tiêu tự phù xuyến}}

Tham số:

source

Tại đây tự phù xuyến nội tìm tòi

target

Ở nguyên nội tìm tòi tự phù xuyến

Thí dụ mẫu:

• {{#invoke:String|str_find| abc123def }}→ 1
• {{#invoke:String|str_find|source= abc123def }}→ 1
• {{#invoke:String|str_find| abc123def |123}}→ 5
• {{#invoke:String|str_find|source= abc123def |target= 123 }}→ 4
• {{#invoke:String|str_find| abc123def |not}}→ -1

find

Này hàm số ở một chữ phù xuyến nội tìm tòi một cái khác tự phù xuyến.

Cách dùng:

{{#invoke:String|find|Nguyên tự phù xuyến|Mục tiêu tự phù xuyến|Bắt đầu hướng dẫn tra cứu|Thuần đánh dấu}}

Hoặc

{{#invoke:String|find|source=Nguyên tự phù xuyến|target=Mục tiêu tự phù xuyến|start=Bắt đầu hướng dẫn tra cứu|plain=Thuần đánh dấu}}

Tham số:

source

Tại đây tự phù xuyến nội tìm tòi

target

Ở nguyên tự phù xuyến nội tìm tòi tự phù xuyến

start

Ở nguyên tự phù xuyến lúc này trí hướng dẫn tra cứu bản chủ bắt đầu tìm tòi. Cam chịu vì 1

plain

Bố ngươi giá trị đánh dấu, tỏ vẻ mục đích hẳn là bị lý giải vì thuần văn bản, mà không phảiScribunto ustring hình thức,Cam chịu vì true

Này hàm số quay trở về ở hướng dẫn tra cứu > "start", trong đó "source" trung có thể liên tục đến "target". Hướng dẫn tra cứu là từ 1 bắt đầu số. Nếu không có tìm được mục tiêu tự phù xuyến, hàm số phản hồi 0. Nếu hướng dẫn tra cứu hoặc là mục đích thiếu hụt hoặc là trống không, này hàm số cũng sẽ phản hồi 0.

Này hàm số hẳn là có thể an toàn mà thao tác UTF-8 tự phù xuyến.

Thí dụ mẫu:

• {{#invoke:String|find|abc123def|12}}→ 4
• {{#invoke:String|find|source=abc123def|target=12}}→ 4
• {{#invoke:String|find|source=abc123def|target=pqr}}→ 0
• {{#invoke:String|find| abc123def |123}}→ 5
• {{#invoke:String|find|source= abc123def |target= 123 }}→ 4
• {{#invoke:String|find|source=abc123def|target=%d |start=3 |plain=false }}→ 4

Cùng chưa mệnh danh tham số sử dụng khi, hai quả nhiên không cách sẽ bị giữ lại thả bị đưa vào:

• {{#invoke:String|find| abc123def |c|false}}→ 5
• {{#invoke:String|find|source= abc123def |target=c|plain=false}}→ 3
• {{#invoke:string|find|abc 123 def|%s|plain=false}}→ 4

Kiểm tra đo lường tự phù xuyến hay không tồn tại:

• {{#ifexpr:{{#invoke:string|find|haystack|needle}}|Found needle|Didn't find needle}}→ Didn't find needle

replace ( gsub )

Này hàm số ở một chữ phù xuyến nội thay đổi đến mục đích tự phù xuyến hoặc là hình thức. Này hàm số là thông qua thuyên chuyểnmw.ustring.gsubThực hiện.

Cách dùng:

{{#invoke:String|replace|Nguyên tự phù xuyến|Hình thức tự phù xuyến|Thay đổi tự phù xuyến|Thay đổi số lần|Thuần đánh dấu}}

Hoặc

{{#invoke:String|replace|source=Nguyên tự phù xuyến|pattern=Hình thức tự phù xuyến|replace=Thay đổi tự phù xuyến|count=Thay đổi số lần|plain=Thuần đánh dấu}}

Tham số:

source

Tại đây tự phù xuyến nội tìm tòi

pattern

Ở nguyên nội tra tìm này tự phù xuyến hoặc là hình thức

replace

Sử dụng này tự phù xuyến thay đổi

count

Yêu cầu thay đổi số lần, cam chịu vì all

plain

Bố ngươi giá trị đánh dấu, tỏ vẻ mục đích hẳn là bị lý giải vì thuần văn bản, mà không phảiScribunto ustring hình thức,Cam chịu vì true

Thí dụ mẫu:

• "{{#invoke:String|replace| abc123def456 |123|XYZ}}"→ "abcXYZdef456"
• "{{#invoke:String|replace|source= abc123def456 |pattern= 123 |replace= XYZ }}"→ "abcXYZdef456"
• "{{#invoke:String|replace| abc123def456 |%d+|XYZ|1|false}}"→ "abcXYZdef456"
• "{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= XYZ |count=1 |plain= false }}"→ "abcXYZdef456"
• "{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= XYZ |plain= false }}"→ "abcXYZdefXYZ"
• {{#invoke:String|replace|source= 0012001200 |pattern= ^0* |plain= false }}→ 12001200

rep

Đem một chữ phù xuyến lặp lạinThứ, này bản chất vìstring.rep.

Cách dùng:

{{#invoke:String|rep|Nguyên|Số lần}}

Tham số:

Nguyên

Yêu cầu lặp lại tự phù xuyến

Số lần

Lặp lại số lần

Thí dụ mẫu:

• "{{#invoke:String|rep|hello|3}}"→ "hellohellohello"
• "{{#invoke:String|rep| hello | 3 }}"→ "hello hello hello"

[[Category:Lua nguyên mô khối }]]

--[[

This module is intended to provide access to basic string functions.

Most of the functions provided here can be invoked with named parameters,
unnamed parameters, or a mixture. If named parameters are used, Mediawiki will
automatically remove any leading or trailing whitespace from the parameter.
Depending on the intended use, it may be advantageous to either preserve or
remove such whitespace.

Global options
ignore_errors: If set to 'true' or 1, any error condition will result in
an empty string being returned rather than an error message.

error_category: If an error occurs, specifies the name of a category to
include with the error message. The default category is
[Category:Errors reported by Module String].

no_category: If set to 'true' or 1, no category will be added if an error
is generated.

Unit tests for this module are available at Module:String/tests.
]]

localstr={}

--[[
len

This function returns the length of the target string.

Usage:
{{#invoke:String|len|target_string|}}
OR
{{#invoke:String|len|s=target_string}}

Parameters
s: The string whose length to report

If invoked using named parameters, Mediawiki will automatically remove any leading or
trailing whitespace from the target string.
]]
functionstr.len(frame)
localnew_args=str._getParameters(frame.args,{'s'});
locals=new_args['s']or'';
returnmw.ustring.len(s)
end

--[[
sub

This function returns a substring of the target string at specified indices.

Usage:
{{#invoke:String|sub|target_string|start_index|end_index}}
OR
{{#invoke:String|sub|s=target_string|i=start_index|j=end_index}}

Parameters
s: The string to return a subset of
i: The fist index of the substring to return, defaults to 1.
j: The last index of the string to return, defaults to the last character.

The first character of the string is assigned an index of 1. If either i or j
is a negative value, it is interpreted the same as selecting a character by
counting from the end of the string. Hence, a value of -1 is the same as
selecting the last character of the string.

If the requested indices are out of range for the given string, an error is
reported.
]]
functionstr.sub(frame)
localnew_args=str._getParameters(frame.args,{'s','i','j'});
locals=new_args['s']or'';
locali=tonumber(new_args['i'])or1;
localj=tonumber(new_args['j'])or-1;

locallen=mw.ustring.len(s);

-- Convert negatives for range checking
ifi<0then
i=len+i+1;
end
ifj<0then
j=len+j+1;
end

ifi>lenorj>lenori<1orj<1then
returnstr._error(' lấy ra tự phù xuyến hướng dẫn tra cứu thoát ly khu gian ');
end
ifj<ithen
returnstr._error(' lấy ra tự phù xuyến chỉ thị thoát ly trình tự ');
end

returnmw.ustring.sub(s,i,j)
end

--[[
This function implements that features of {{str sub old}} and is kept in order
to maintain these older templates.
]]
functionstr.sublength(frame)
locali=tonumber(frame.args.i)or0
locallen=tonumber(frame.args.len)
returnmw.ustring.sub(frame.args.s,i+1,lenand(i+len))
end

--[[
match

This function returns a substring from the source string that matches a
specified pattern.

Usage:
{{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}}
OR
{{#invoke:String|pos|s=source_string|pattern=pattern_string|start=start_index
|match=match_number|plain=plain_flag|nomatch=nomatch_output}}

Parameters
s: The string to search
pattern: The pattern or string to find within the string
start: The index within the source string to start the search. The first
character of the string has index 1. Defaults to 1.
match: In some cases it may be possible to make multiple matches on a single
string. This specifies which match to return, where the first match is
match= 1. If a negative number is specified then a match is returned
counting from the last match. Hence match = -1 is the same as requesting
the last match. Defaults to 1.
plain: A flag indicating that the pattern should be understood as plain
text. Defaults to false.
nomatch: If no match is found, output the "nomatch" value rather than an error.

If invoked using named parameters, Mediawiki will automatically remove any leading or
trailing whitespace from each string. In some circumstances this is desirable, in
other cases one may want to preserve the whitespace.

If the match_number or start_index are out of range for the string being queried, then
this function generates an error. An error is also generated if no match is found.
If one adds the parameter ignore_errors=true, then the error will be suppressed and
an empty string will be returned on any failure.

For information on constructing Lua patterns, a form of [regular expression], see:

* http:// lua.org/manual/5.1/manual.html#5.4.1
* http:// mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Patterns
* http:// mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Ustring_patterns

]]
functionstr.match(frame)
localnew_args=str._getParameters(frame.args,{'s','pattern','start','match','plain','nomatch'});
locals=new_args['s']or'';
localstart=tonumber(new_args['start'])or1;
localplain_flag=str._getBoolean(new_args['plain']orfalse);
localpattern=new_args['pattern']or'';
localmatch_index=math.floor(tonumber(new_args['match'])or1);
localnomatch=new_args['nomatch'];

ifs==''then
returnstr._error(' mục tiêu tự phù xuyến là trống không ');
end
ifpattern==''then
returnstr._error(' hình thức tự phù xuyến là trống không ');
end
ifmath.abs(start)<1ormath.abs(start)>mw.ustring.len(s)then
returnstr._error(' yêu cầu lúc đầu điểm thoát ly khu gian ');
end
ifmatch_index==0then
returnstr._error(' xứng đôi hướng dẫn tra cứu thoát ly khu gian ');
end
ifplain_flagthen
pattern=str._escapePattern(pattern);
end

localresult
ifmatch_index==1then
-- Find first match is simple case
result=mw.ustring.match(s,pattern,start)
else
ifstart>1then
s=mw.ustring.sub(s,start);
end

localiterator=mw.ustring.gmatch(s,pattern);
ifmatch_index>0then
-- Forward search
forwiniteratordo
match_index=match_index-1;
ifmatch_index==0then
result=w;
break;
end
end
else
-- Reverse search
localresult_table={};
localcount=1;
forwiniteratordo
result_table[count]=w;
count=count+1;
end

result=result_table[count+match_index];
end
end

ifresult==nilthen
ifnomatch==nilthen
returnstr._error(' tìm không thấy xứng đôi ');
else
returnnomatch;
end
else
returnresult;
end
end

--[[
pos

This function returns a single character from the target string at position pos.

Usage:
{{#invoke:String|pos|target_string|index_value}}
OR
{{#invoke:String|pos|target=target_string|pos=index_value}}

Parameters
target: The string to search
pos: The index for the character to return

If invoked using named parameters, Mediawiki will automatically remove any leading or
trailing whitespace from the target string. In some circumstances this is desirable, in
other cases one may want to preserve the whitespace.

The first character has an index value of 1.

If one requests a negative value, this function will select a character by counting backwards
from the end of the string. In other words pos = -1 is the same as asking for the last character.

A requested value of zero, or a value greater than the length of the string returns an error.
]]
functionstr.pos(frame)
localnew_args=str._getParameters(frame.args,{'target','pos'});
localtarget_str=new_args['target']or'';
localpos=tonumber(new_args['pos'])or0;

ifpos==0ormath.abs(pos)>mw.ustring.len(target_str)then
returnstr._error(' tự phù xuyến hướng dẫn tra cứu thoát ly khu gian ');
end

returnmw.ustring.sub(target_str,pos,pos);
end

--[[
str_find

This function duplicates the behavior of {{str_find}}, including all of its quirks.
This is provided in order to support existing templates, but is NOT RECOMMENDED for
new code and templates. New code is recommended to use the "find" function instead.

Returns the first index in "source" that is a match to "target". Inde xing is 1-based,
and the function returns -1 if the "target" string is not present in "source".

Important Note: If the "target" string is empty / missing, this function returns a
value of "1", which is generally unexpected behavior, and must be accounted for
separatetly.
]]
functionstr.str_find(frame)
localnew_args=str._getParameters(frame.args,{'source','target'});
localsource_str=new_args['source']or'';
localtarget_str=new_args['target']or'';

iftarget_str==''then
return1;
end

localstart=mw.ustring.find(source_str,target_str,1,true)
ifstart==nilthen
start=-1
end

returnstart
end

--[[
find

This function allows one to search for a target string or pattern within another
string.

Usage:
{{#invoke:String|find|source_str|target_string|start_index|plain_flag}}
OR
{{#invoke:String|find|source=source_str|target=target_str|start=start_index|plain=plain_flag}}

Parameters
source: The string to search
target: The string or pattern to find within source
start: The index within the source string to start the search, defaults to 1
plain: Boolean flag indicating that target should be understood as plain
text and not as a Lua style regular expression, defaults to true

If invoked using named parameters, Mediawiki will automatically remove any leading or
trailing whitespace from the parameter. In some circumstances this is desirable, in
other cases one may want to preserve the whitespace.

This function returns the first index >= "start" where "target" can be found
within "source". Indices are 1-based. If "target" is not found, then this
function returns 0. If either "source" or "target" are missing / empty, this
function also returns 0.

This function should be safe for UTF-8 strings.
]]
functionstr.find(frame)
localnew_args=str._getParameters(frame.args,{'source','target','start','plain'});
localsource_str=new_args['source']or'';
localpattern=new_args['target']or'';
localstart_pos=tonumber(new_args['start'])or1;
localplain=new_args['plain']ortrue;

ifsource_str==''orpattern==''then
return0;
end

plain=str._getBoolean(plain);

localstart=mw.ustring.find(source_str,pattern,start_pos,plain)
ifstart==nilthen
start=0
end

returnstart
end

--[[
replace

This function allows one to replace a target string or pattern within another
string.

Usage:
{{#invoke:String|replace|source_str|pattern_string|replace_string|replacement_count|plain_flag}}
OR
{{#invoke:String|replace|source=source_string|pattern=pattern_string|replace=replace_string|
count=replacement_count|plain=plain_flag}}

Parameters
source: The string to search
pattern: The string or pattern to find within source
replace: The replacement text
count: The number of occurences to replace, defaults to all.
plain: Boolean flag indicating that pattern should be understood as plain
text and not as a Lua style regular expression, defaults to true
]]
functionstr.replace(frame)
localnew_args=str._getParameters(frame.args,{'source','pattern','replace','count','plain'});
localsource_str=new_args['source']or'';
localpattern=new_args['pattern']or'';
localreplace=new_args['replace']or'';
localcount=tonumber(new_args['count']);
localplain=new_args['plain']ortrue;

ifsource_str==''orpattern==''then
returnsource_str;
end
plain=str._getBoolean(plain);

ifplainthen
pattern=str._escapePattern(pattern);
replace=mw.ustring.gsub(replace,"%%","%%%%");--Only need to escape replacement sequences.
end

localresult;

ifcount~=nilthen
result=mw.ustring.gsub(source_str,pattern,replace,count);
else
result=mw.ustring.gsub(source_str,pattern,replace);
end

returnresult;
end

--[[
simple function to pipe string.rep to templates.
]]

functionstr.rep(frame)
localrepetitions=tonumber(frame.args[2])
ifnotrepetitionsthen
returnstr._error('function rep expects a number as second parameter, received "'..(frame.args[2]or'')..' "')
end
returnstring.rep(frame.args[1]or'',repetitions)
end


functionstr.split(inputstr,sep,no_pattern,ignore_null)
--#invoke chi viện
iftype(inputstr)==type({table})then
ifnotgetArgsthengetArgs=require('Module:Arguments').getArgsend
args=getArgs(inputstr,{parentFirst=true})
forarg_name,arg_valueinpairs(args)do
ifarg_name==1orarg_name=='1'orarg_name=="str"orarg_name=="inputstr"orarg_name=="input"then
input_str=arg_value
elseifarg_name==2orarg_name=='2'orarg_name=="sep"orarg_name=="separator"then
separ=arg_value
elseifarg_name==3orarg_name=='3'orarg_name=="no_pattern"orarg_name=="no pattern"then
no_pattern_flag=arg_value
elseifarg_name==4orarg_name=='4'orarg_name=="ignore_null"orarg_name=="ignore null"then
ignore_null_flag=arg_value
elseifarg_name==5orarg_name=='5'orarg_name=="format"then
format=arg_valueor"*{{{1}}}\n";
end
end
ifnotyesnothenyesno=require('Module:Yesno')end
no_pattern_flag=yesno(no_pattern_flagor'yes')
ignore_null_flag=yesno(ignore_null_flagor'no')
is_invoke=true
format=mw.ustring.gsub(formator"*{{{1}}}\n","%{%{%{.-%}%}%}","%%s");
it=mw.ustring.find(format,"%%s",1)
ifit==nilthenformat=format.."%s"end
format=mw.ustring.gsub(format,"\\n ","\n")
else
input_str=inputstr
separ=sep
no_pattern_flag=no_pattern
ignore_null_flag=ignore_null
is_invoke=false
end
input_str=input_stror''
separ=separor"%s"
ifno_pattern_flag==nilthenno_pattern_flag=trueend
ifignore_null_flag==nilthenignore_null_flag=falseend

length=mw.ustring.len(input_str)
--split hàm số khởi điểm
ifno_pattern_flagthen
separ=mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(mw.ustring.gsub(separ,
"%[","%["),"%]","%]"),"%{","%{"),"%}","%}"),"%%","%%%%"),"%)","%)"),"%-","%-"),
"%^","%^"),"%$","%$"),"%(","%("),"%.","%."),"%*","%*"),"%+","%+"),"%|","%|");
end
iterator=1;i=1;flag=true
result={}
separ_str_begin,separ_str_end=mw.ustring.find(input_str,separ,iterator)
--
debug1=1
--
whileflagdo
debug1=debug1+1
ifsepar_str_begin==niloriterator>lengthordebug1>=100then
separ_str_begin=0
separ_str_end=-2
flag=false
end
ifsepar_str_end<separ_str_beginthensepar_str_end=separ_str_beginend
finded_str=mw.ustring.sub(input_str,iterator,separ_str_begin-1)
ifnot(mw.text.trim(finded_str)==''andignore_null_flag)then
result[i]=finded_str
i=i+1
end

iterator=separ_str_end+1
separ_str_begin,separ_str_end=mw.ustring.find(input_str,separ,iterator)
end
ifis_invokethen
body=''
fori,result_strinpairs(result)do
body=body..mw.ustring.gsub(format,"%%s",result_str)
end
returnbody
end
returnresult;
end

--[[
join

Join all non empty arguments together; the first argument is the separator.
Usage:
{{#invoke:String|join|sep|one|two|three}}
]]
functionstr.join(frame)
localargs={}
localsep
for_,vinipairs(frame.args)do
ifsepthen
ifv~=''then
table.insert(args,v)
end
else
sep=v
end
end
returntable.concat(args,sepor'')
end

--[[
Helper function that populates the argument list given that user may need to use a mix of
named and unnamed parameters. This is relevant because named parameters are not
identical to unnamed parameters due to string trimming, and when dealing with strings
we sometimes want to either preserve or remove that whitespace depending on the application.
]]
functionstr._getParameters(frame_args,arg_list)
localnew_args={};
localindex=1;
localvalue;

fori,arginipairs(arg_list)do
value=frame_args[arg]
ifvalue==nilthen
value=frame_args[index];
index=index+1;
end
new_args[arg]=value;
end

returnnew_args;
end

--[[
Helper function to handle error messages.
]]
functionstr._error(error_str)
localframe=mw.getCurrentFrame();
localerror_category=frame.args.error_categoryor' tự phù xuyến mô khối báo cáo sai lầm ';
localignore_errors=frame.args.ignore_errorsorfalse;
localno_category=frame.args.no_categoryorfalse;

ifstr._getBoolean(ignore_errors)then
return'';
end

localerror_str='<strong class= "error" > tự phù xuyến mô khối làm lỗi: '..error_str..'</strong>';
iferror_category~=''andnotstr._getBoolean(no_category)then
error_str='[[Category:'..error_category..']]'..error_str;
end

returnerror_str;
end

--[[
Helper Function to interpret boolean strings
]]
functionstr._getBoolean(boolean_str)
localboolean_value;

iftype(boolean_str)=='string'then
boolean_str=boolean_str:lower();
ifboolean_str=='false'orboolean_str=='no'orboolean_str=='0'
orboolean_str==''then
boolean_value=false;
else
boolean_value=true;
end
elseiftype(boolean_str)=='boolean'then
boolean_value=boolean_str;
else
error(' bố ngươi giá trị tìm không thấy ');
end
returnboolean_value
end

--[[
Helper function that escapes all pattern characters so that they will be treated
as plain text.
]]
functionstr._escapePattern(pattern_str)
returnmw.ustring.gsub(pattern_str,"([%(%)%.%%%+%-%*%?%[%^%$%]])","%%%1");
end

returnstr