util.string.upper

Syntax

local result = util.string.upper(
    input
)

Parameters

Type	Name	Description
`string`	input	String to convert

Returns

Type	Name	Description
`string`	result	Altered string with all uppercase letters converted to uppercase

Examples

Convert a lowercase string to uppercase

local result = util.string.upper("hello")

core.engine.print("info", result) -- 'HELLO'

Convert a mixed-case string to uppercase

local result = util.string.upper("Hello World")

core.engine.print("info", result) -- 'HELLO WORLD'

Already-uppercase strings are unchanged

local result = util.string.upper("ALREADY UPPERCASE")

core.engine.print("info", result) -- 'ALREADY UPPERCASE'

Numbers and special characters are unchanged

local result = util.string.upper("abc123!@#")

core.engine.print("info", result) -- 'ABC123!@#'

Perform a case-insensitive comparison

local str1 = "Hello"
local str2 = "hello"

if util.string.upper(str1) == util.string.upper(str2) then
    core.engine.print("info", "Strings are equal (case-insensitive)")
end

Normalize user input for comparison

local input = "yes"

if util.string.upper(input) == "YES" then
    core.engine.print("info", "User confirmed")
end

Create a constant name from a variable name

local varName = "max_value"
local constant = util.string.upper(varName)

core.engine.print("info", constant) -- 'MAX_VALUE'

Emphasize text with uppercase

local text = "warning"
local emphasized = util.string.upper(text)

core.engine.print("info", emphasized) -- 'WARNING'

Convert a status string to an enum value

local status = "active"
local enum = util.string.upper(status)

core.engine.print("info", enum) -- 'ACTIVE'

Strings with only numbers are unchanged

local result = util.string.upper("123456")

core.engine.print("info", result) -- '123456'

Uppercase an empty string

local result = util.string.upper("")

core.engine.print("info", result) -- ''

Convert a title to an uppercase header

local title = "my document title"
local header = util.string.upper(title)

core.engine.print("info", header) -- 'MY DOCUMENT TITLE'

Convert a column name to SQL-style uppercase

local column = "user_id"

core.engine.print("info", util.string.upper(column)) -- 'USER_ID'

Compare two strings ignoring case

local function equalsIgnoreCase(a, b)
    return util.string.upper(a) == util.string.upper(b)
end

core.engine.print("info", equalsIgnoreCase("Test", "test")) -- true

Format a command string in uppercase

local cmd = "help"

core.engine.print("info", "Command: "..util.string.upper(cmd)) -- 'Command: HELP'

Build an acronym from a phrase

local text = "hypertext markup language"
local acronym = ""
for word in util.string.gmatch(text, "%S+") do
    acronym = acronym..util.string.upper(util.string.sub(word, 1, 1))
end

core.engine.print("info", acronym) -- 'HML'

Convert to shouty snake case

local name = "my_variable_name"
local shouty = util.string.upper(name)

core.engine.print("info", shouty) -- 'MY_VARIABLE_NAME'

Syntax

Parameters

Returns

Examples

On this page