You are currently viewing the GMLscripts.com static mirror. Forum access and script submissions are not available through this mirror.

Invert GMLscripts.com

string_lpad

Returns a string padded on its left to a given length. If the padded length is less than the original length, the original string is returned.

//  string_lpad(str, len, pad)
s = string_lpad("123", 7, "xo");        //  "xoxo123"
s = string_lpad("1234", 7, "xo");       //  "xox1234"
s = string_lpad("1234", 8);             //  "    1234"
s = string_lpad("1234", 8, ".");        //  "....1234"
s = string_lpad("", 8, "123456789");    //  "12345678"
s = string_lpad("123456789", 4, ".");   //  "123456789"
string_lpad(str, len, pad)
Returns a string padded on its left to a given length.
COPY/// @func   string_lpad(str, len, pad)
///
/// @desc   Returns a string padded on its left to a given length.
///         If the padded length is less than the original length,
///         the original string is returned.
///
///         eg. string_lpad("1234", 7, "0") == "0001234"
///
/// @param  {string}    str             string of text
/// @param  {real}      len             desired length
/// @param  {string}    pad             padding string (default " ")
///
/// @return {string}    padded string
///
/// GMLscripts.com/license

function string_lpad(str, len, pad=" ")
{
    var padsize = string_length(pad);
    var padding = len - string_length(str);
    if (padding <= 0) {
        return str;
    }
    var out = string_repeat(pad, padding div padsize);
    out += string_copy(pad, 1, padding mod padsize);
    out += str;
    out = string_copy(out, 1, len);
    return out;
}

Contributors: xot

GitHub: View · Commits · Blame · Raw