117 lines
3.5 KiB
Lua
117 lines
3.5 KiB
Lua
--[[
|
|
Copyright (c) 2014, Robert 'Bobby' Zenz
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
* Redistributions of source code must retain the above copyright notice, this
|
|
list of conditions and the following disclaimer.
|
|
|
|
* Redistributions in binary form must reproduce the above copyright notice,
|
|
this list of conditions and the following disclaimer in the documentation
|
|
and/or other materials provided with the distribution.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
--]]
|
|
|
|
|
|
--- Various utility functions for working with strings.
|
|
stringutil = {}
|
|
|
|
|
|
--- Concats all the given items by invoking tostring on them into one string.
|
|
--
|
|
-- @param ... The items to concat.
|
|
-- @return The concatenated items as string.
|
|
function stringutil.concat(...)
|
|
if ... == nil then
|
|
return ""
|
|
end
|
|
|
|
local string = ""
|
|
|
|
for idx, value in ipairs({...}) do
|
|
string = string .. tostring(value)
|
|
end
|
|
|
|
return string
|
|
end
|
|
|
|
--- Tests if the given text ends with the given value.
|
|
--
|
|
-- @param text The text to check if it ends with the given value.
|
|
-- @param value The value that text should end with.
|
|
-- @return true if the given text ends with the value.
|
|
function stringutil.endswith(text, value)
|
|
if text == nil or value == nil then
|
|
return false
|
|
end
|
|
|
|
if value == "" then
|
|
return true
|
|
end
|
|
|
|
return string.sub(text, -string.len(value)) == value
|
|
end
|
|
|
|
--- Splits the given text using the given split value. Returns the splitted text
|
|
-- as List. If the string is empty or nil, the returned list will not contain
|
|
-- any entries. If the string only contains a value without a separator,
|
|
-- the list will contain one value, if it contains only the separator,
|
|
-- two empty values.
|
|
--
|
|
-- @param text The text to split.
|
|
-- @param split The split value.
|
|
-- @return The list of splitted values.
|
|
function stringutil.split(text, split)
|
|
local splitted = List:new()
|
|
|
|
if string ~= nil and #text > 0 then
|
|
local previous_starts = 0
|
|
local previous_ends = 0
|
|
local starts, ends = string.find(text, split, 0, true)
|
|
|
|
while ends ~= nil do
|
|
splitted:add(string.sub(text, previous_ends + 1, starts - 1))
|
|
|
|
previous_starts = starts
|
|
previous_ends = ends
|
|
starts, ends = string.find(text, split, ends + 1, true)
|
|
end
|
|
|
|
if previous_ends > 0 or splitted:size() == 0 then
|
|
splitted:add(string.sub(text, previous_ends + 1))
|
|
end
|
|
end
|
|
|
|
return splitted
|
|
end
|
|
|
|
--- Tests if the given text starts with the given value.
|
|
--
|
|
-- @param text The text to check if it starts with the given value.
|
|
-- @param value The value that text should start with.
|
|
-- @return true if the given text starts with the value.
|
|
function stringutil.startswith(text, value)
|
|
if text == nil or value == nil then
|
|
return false
|
|
end
|
|
|
|
if value == "" then
|
|
return true
|
|
end
|
|
|
|
return string.sub(text, 1, string.len(value)) == value
|
|
end
|
|
|