Skip to main content


Translates the values contained in array, using the specified translation table, and returns the results in a new array.

table.translate(arr, translation)


arr is the array of values to be translated. translation is a key-value table containing the replacement values, or a function taking a single value and returning the translation.

Return Value

Returns a new array containing the translated values.


Premake 5.0 or later.


-- returns { "X", "Y" }
table.translate({ "A", "B", "C"}, { A = "X", C = "Y"})

-- returns { 2, 3, 4 }
table.translate({ 1, 2, 3}, function(value) return value + 1 end)