본문문서 역사

모듈:String 편집하기

귀하는 로그인되어 있지 않습니다. 이대로 편집하면 귀하의 IP 주소가 편집 기록에 남게 됩니다.

편집을 취소할 수 있습니다. 이 편집을 되돌리려면 아래의 바뀐 내용을 확인한 후 게시해주세요.

최신판 당신의 편집
1번째 줄: 1번째 줄:
local getArgs = require('Module:Arguments').getArgs
local ustring = mw.ustring
local str = {}
local str = {}


-- string.find
function str.len( frame )
function str.len( frame )
local new_args = str._getParameters( frame.args, {'s'} )
    return mw.ustring.len( frame.args.s )
local s = new_args['s'] or ''
return ustring.len( s )
end
end
-- string.sub
 
function str.sub( frame )
function str.sub( frame )
local args = getArgs(frame)
    return mw.ustring.sub( frame.args.s, tonumber( frame.args.i ), tonumber( frame.args.j ) )
local new_args = str._getParameters( args, { 's', 'i', 'j' } )
local s = new_args['s'] or ''
local i = tonumber( new_args['i'] ) or 1
local j = tonumber( new_args['j'] ) or -1
 
local len = ustring.len( s )
 
-- Convert negatives for range checking
if i < 0 then
i = len + i + 1
end
if j < 0 then
j = len + j + 1
end
 
if i > len or j > len or i < 1 or j < 1 then
return str._error( 'String subset index out of range' )
end
if j < i then
return str._error( 'String subset indices out of order' )
end
 
return ustring.sub( s, i, j )
end
end


-- 다른 모듈에서 require 되는 함수
function str.sublength( frame )
function str._match( s, pattern, start, match_index, plain_flag, nomatch )
    local i = tonumber( frame.args.i ) or 0
if s == '' then
    local len = tonumber( frame.args.len )
return str._error( 'Target string is empty' )
    return mw.ustring.sub( frame.args.s, i + 1, len and ( i + len ) )
end
if pattern == '' then
return str._error( 'Pattern string is empty' )
end
start = tonumber(start) or 1
if math.abs(start) < 1 or math.abs(start) > ustring.len( s ) then
return str._error( 'Requested start is out of range' )
end
if match_index == 0 then
return str._error( 'Match index is out of range' )
end
if plain_flag then
pattern = str._escapePattern( pattern )
end
 
local result
if match_index == 1 then
-- Find first match is simple case
result = ustring.match( s, pattern, start )
else
if start > 1 then
s = ustring.sub( s, start )
end
 
local iterator = ustring.gmatch(s, pattern)
if match_index > 0 then
-- Forward search
for w in iterator do
match_index = match_index - 1
if match_index == 0 then
result = w
break
end
end
else
-- Reverse search
local result_table = {}
local count = 1
for w in iterator do
result_table[count] = w
count = count + 1
end
 
result = result_table[ count + match_index ]
end
end
 
if result == nil then
if nomatch == nil then
return str._error( 'Match not found' )
else
return nomatch
end
else
return result
end
end
end


-- string.match
function str.match( frame )
function str.match( frame )
local args = getArgs(frame)
    return mw.ustring.match( frame.args.s, frame.args.pattern, tonumber( frame.args.i ) )
local new_args = str._getParameters( args, {'s', 'pattern', 'start', 'match', 'plain', 'nomatch'} )
local s = new_args['s'] or ''
local start = tonumber( new_args['start'] ) or 1
local plain_flag = str._getBoolean( new_args['plain'] or false )
local pattern = new_args['pattern'] or ''
local match_index = math.floor( tonumber(new_args['match']) or 1 )
local nomatch = new_args['nomatch']
 
return str._match( s, pattern, start, match_index, plain_flag, nomatch )
end
end


--  
--[====[
function str.pos( frame )
pos
local args = getArgs(frame)
local new_args = str._getParameters( args, {'target', 'pos'} )
local target_str = new_args['target'] or ''
local pos = tonumber( new_args['pos'] ) or 0


if pos == 0 or math.abs(pos) > ustring.len( target_str ) then
This function returns a single character from the target string at position pos.
return str._error( 'String index out of range' )
end


return ustring.sub( target_str, pos, pos )
Usage:
end
{{#invoke:String|pos|target_string|index_value}}
OR
{{#invoke:String|pos|target=target_string|pos=index_value}}


-- string.find
Parameters
function str.find( frame )
    target: The string to search
local args = getArgs(frame)
    pos: The index for the character to return
local new_args = str._getParameters( args, {'source', 'target', 'start', 'plain' } )
local source_str = new_args['source'] or ''
local pattern = new_args['target'] or ''
local start_pos = tonumber(new_args['start']) or 1
local plain = new_args['plain'] or false


if source_str == '' or pattern == '' then
If invoked using named parameters, Mediawiki will automatically remove any leading or
return 0
trailing whitespace from the target string.  In some circumstances this is desirable, in
end
other cases one may want to preserve the whitespace.


plain = str._getBoolean( plain )
The first character has an index value of 1.


local start = ustring.find( source_str, pattern, start_pos, plain )
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.
if start == nil then
start = 0
end


return start
A requested value of zero, or a value greater than the length of the string returns an error.
end
]====]
 
function str.pos( frame )
function str.find_( str1,  str2 , str3, str4)
    local new_args = str._getParameters( frame.args, {'target', 'pos'} );
local source_str = str1 or ''
    local target_str = new_args['target'] or '';
local pattern_str = str2 or ''
    local pos = tonumber( new_args['pos'] ) or 0;
local start_ = str3 or 1
local plain_ = str4 or false


if source_str == '' or pattern_str == '' then
    if pos == 0 or math.abs(pos) > mw.ustring.len( target_str ) then
return 0
        return '<strong class="error">String index out of range</strong>';
end
    end  
 
   
plain_ = str._getBoolean( plain_ )
    return mw.ustring.sub( target_str, pos, pos );
 
local start = ustring.find( source_str, pattern_str, start_, plain_ )
if start == nil then
start = 0
end
 
return start
end
end


function str.ifexist( frame )
--[====[
local args = getArgs(frame)
str_find
local new_args = str._getParameters( args, {'source', 'target', 'return1', 'return2' } )
local source_str = new_args['source'] or ''
local pattern = new_args['target'] or ''
local return1 = new_args['return1'] or ''
local return2 = new_args['return2'] or ''


if str.find_( source_str,  pattern) == 0 then
This function duplicates the behavior of {{str_find}}, including all of its quirks.
return return2
This is provided in order to support existing templates, but is NOT RECOMMENDED for
else
new code and templates. New code is recommended to use the "find" function instead.
return return1
end
end


function str.ifexist_( source_str, pattern, return1, return2 )
Returns the first index in "source" that is a match to "target".  Indexing is 1-based,
if str.find_( source_str, pattern) == 0 then
and the function returns -1 if the "target" string is not present in "source".
return return2
else
return return1
end
end
 
-- string.gsub
function str.gsub( frame )
local new_args = str._getParameters( frame.args, {'source', 'pattern', 'replace', 'count', 'plain' } )
local source_str = new_args['source'] or ''
local pattern = new_args['pattern'] or ''
local replace = new_args['replace'] or ''
local count = tonumber( new_args['count'] )
local plain = new_args['plain'] or true
 
if source_str == '' or pattern == '' then
return source_str
end
plain = str._getBoolean( plain )
 
if plain then
pattern = str._escapePattern( pattern )
replace = ustring.gsub( replace, "%%", "%%%%" ) --Only need to escape replacement sequences.
end


local result
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.
]====]
function str.str_find( frame )
    local new_args = str._getParameters( frame.args, {'source', 'target'} );
    local source_str = new_args['source'] or '';
    local target_str = new_args['target'] or '';


if count ~= nil then
    if target_str == '' then
if replace == '제거' or replace == nil then
        return 1;
result = ustring.gsub( source_str, pattern, '', count)
    end   
else
   
result = ustring.gsub( source_str, pattern, replace, count )
    local start = mw.ustring.find( source_str, target_str, 1, true )
end
    if start == nil then
else
        start = -1
if replace == '제거' or replace == nil then
    end
result = ustring.gsub( source_str, pattern, '')
   
else
    return start
result = ustring.gsub( source_str, pattern, replace )
end
end
return result
end
end


-- string.rep
--[====[
function str.rep( frame )
find
local repetitions = tonumber( frame.args[2] )
if not repetitions then
return str._error( 'function rep expects a number as second parameter, received "' .. ( frame.args[2] or '' ) .. '"' )
end
return ustring.rep( frame.args[1] or '', repetitions )
end


-- string.upper
This function allows one to search for a target string or pattern within another
function str.upper( frame )
string.
local new_args = str._getParameters( frame.args, { 's' } )
local s = new_args['s'] or ''
return  ustring.upper( s )
end


-- string.lower
Usage:
function str.lower( frame )
{{#invoke:String|find|source_str|target_string|start_index|plain_flag}}
local new_args = str._getParameters( frame.args, { 's' } )
OR
local s = new_args['s'] or ''
{{#invoke:String|find|source=source_str|target=target_str|start=start_index|plain=plain_flag}}
return ustring.lower( s )
end


function str.reverse( frame )
Parameters
local new_args = str._getParameters( frame.args, { 's' } )
    source: The string to search
local s = new_args['s'] or ''
    target: The string or pattern to find within source
local str = ""
    start: The index within the source string to start the search, defaults to 1
for token in ustring.gmatch(s, ".") do
    plain: Boolean flag indicating that target should be understood as plain
str = token..str
        text and not as a Lua style regular expression, defaults to true
end
return str
end


-- string.byte의 유니코드 호환 버전
If invoked using named parameters, Mediawiki will automatically remove any leading or
function str.tounicode( frame )
trailing whitespace from the parameter. In some circumstances this is desirable, in
local args = getArgs( frame )
other cases one may want to preserve the whitespace.
local s = args[1] or -1
if s == -1 then
return '입력값이 없습니다.'
else
return 'U+0'..ustring.upper(string.format("%x", ustring.codepoint(s)))
end
end


function str.tounicode_( char )
This function returns the first index >= "start" where "target" can be found
local s = char or -1
within "source". Indices are 1-based.  If "target" is not found, then this
if s == -1 then
function returns 0. If either "source" or "target" are missing / empty, this
return 0
function also returns 0.
else
return 'U+0'..ustring.upper(string.format("%x", ustring.codepoint(s)))
end
end


-- string.char
This function should be safe for UTF-8 strings.
function str.char( frame )
]====]
local args = getArgs(frame)
function str.find( frame )
local new_args = str._getParameters( args, { 'c' } )
    local new_args = str._getParameters( frame.args, {'source', 'target', 'start', 'plain' } );
local c = tonumber(new_args['c'])
    local source_str = new_args['source'] or '';
return ustring.char( c )
    local pattern = new_args['target'] or '';
end
    local start_pos = tonumber(new_args['start']) or 1;
    local plain = new_args['plain'] or true;
function str.escapePattern( frame )
       
local args = getArgs(frame)
    if source_str == '' or pattern == '' then
local pattern_str = args[1]
        return 0;
if not pattern_str then
    end  
return str._error( 'No pattern string specified' )
   
end
    if type( plain ) == 'string' then
local result = str._escapePattern( pattern_str )
        plain = plain:lower();
return result
        if plain == 'false' or plain == 'no' or plain == '0' then
end
            plain = false;
 
        else
function str.count(frame)
            plain = true;
local args_ = getArgs(frame)
        end  
local args = str._getParameters(args_, {'source', 'pattern', 'plain'})
    end
local source = args.source or ''
local pattern = args.pattern or ''
local plain = str._getBoolean(args.plain or true)
if plain then
pattern = str._escapePattern(pattern)
end
local _, count = ustring.gsub(source, pattern, '')
return count
end
 
function str.count_(str, pattern)
local _, count = ustring.gsub(str, pattern, '')
return count
end
 
--[[
endswith
This function determines whether a string ends with another string.
]]
function str.endswith(frame)
local args_ = getArgs(frame)
local args = str._getParameters(args_, {'source', 'pattern'})
local source = args.source or ''
local pattern = args.pattern or ''
if pattern == '' then
-- All strings end with the empty string.
return "yes"
end
if ustring.sub(source, -ustring.len(pattern), -1) == pattern then
return "yes"
else
return ""
end
end


function str.join(frame)
    local start = mw.ustring.find( source_str, pattern, start_pos, plain )
local args = getArgs(frame)
    if start == nil then
local table_ = {}
        start = 0
local sep = args[1]
    end
local i, j = 2, 1
   
-- args,table
    return start
while args[i] ~= nil do
if args[i] ~= '_' then
table_[j] = args[i]
i = i + 1
j = j + 1
else
i = i + 1
end
end
return table.concat(table_, sep)
end
end


--[[
--[====[
Helper function that populates the argument list given that user may need to use a mix of
Helper function that populates the argument list given that user may need to use a mix of
named and unnamed 변수.  This is relevant because named 변수 are not
named and unnamed parameters.  This is relevant because named parameters are not
identical to unnamed 변수 due to string trimming, and when dealing with strings
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.
we sometimes want to either preserve or remove that whitespace depending on the application.
]]
]====]
function str._getParameters( frame_args, arg_list )
function str._getParameters( frame_args, arg_list )
local new_args = {}
    local new_args = {};
local index = 1
    local index = 1;
local value
    local value;
 
   
for _, arg in ipairs( arg_list ) do
    for i,arg in ipairs( arg_list ) do
value = frame_args[arg]
        value = frame_args[arg]
if value == nil then
        if value == nil then
value = frame_args[index]
            value = frame_args[index];
index = index + 1
            index = index + 1;
end
        end
new_args[arg] = value
        new_args[arg] = value;
end
    end
 
   
return new_args
    return new_args;
end
end      
 
--[[
Helper function to handle error messages.
]]
function str._error( error_str )
local frame = mw.getCurrentFrame()
local error_category = frame.args.error_category or 'String 모듈에 의해 보고된 오류'
local ignore_errors = frame.args.ignore_errors or false
local no_category = frame.args.no_category or false
 
if str._getBoolean(ignore_errors) then
return ''
end
 
local error_str = '<strong class="error">String Module Error: ' .. error_str .. '</strong>'
if error_category ~= '' and not str._getBoolean( no_category ) then
error_str = '[[Category:' .. error_category .. ']]' .. error_str
end
 
return error_str
end
 
--[[
Helper Function to interpret boolean strings
]]
function str._getBoolean( boolean_str )
local boolean_value
 
if type( boolean_str ) == 'string' then
boolean_str = boolean_str:lower()
if boolean_str == 'false' or boolean_str == 'no' or boolean_str == '0'
or boolean_str == '' then
boolean_value = false
else
boolean_value = true
end
elseif type( boolean_str ) == 'boolean' then
boolean_value = boolean_str
else
error( 'No boolean value found' )
end
return boolean_value
end
 
--[[
Helper function that escapes all pattern characters so that they will be treated
as plain text.
]]
function str._escapePattern( pattern_str )
return ustring.gsub( pattern_str, "([%(%)%.%%%+%-%*%?%[%^%$%]])", "%%%1" )
end


return str
return str
가온 위키에서의 모든 기여는 크리에이티브 커먼즈 저작자표시-동일조건변경허락 라이선스로 배포된다는 점을 유의해 주세요(자세한 내용에 대해서는 가온 위키:저작권 문서를 읽어주세요). 만약 여기에 동의하지 않는다면 문서를 저장하지 말아 주세요.
또한, 직접 작성했거나 퍼블릭 도메인과 같은 자유 문서에서 가져왔다는 것을 보증해야 합니다. 저작권이 있는 내용을 허가 없이 저장하지 마세요!
취소 편집 도움말 (새 창에서 열림)

이 문서에서 사용한 틀: