string_format

Turns a real number into a string using your own formatting.

Syntax:

GML Code Example

string_format(val, tot, dec);


Argument Description
val The real number to be turned into a string.
tot The total number of places of the main number to be shown. Zeroes or spaces will be inserted to match this.
dec The number of decimal places to be included.


Returns: String


Description

Turns a real number into a string using your own formatting, where you can choose how many "places" are saved to the string and how many decimal places are saved also. Both can be very handy, some games prefer to display a score as a set number of digits, while control over decimal places can be good for a high accuracy the two decimal places of string() cannot provide. If the number of places specified is greater than the value to be shown and/or the number plus the decimal places that have been specified is less than the total places, then spaces will be added before the value to make up the difference (see the example below). Zeros will be added to the right of the decimal point if the value given is less than the total and the number of decimal places to include.


Example:

GML Code Example

str1 = string_format(1234, 8, 0);
 str2 = string_format(pi, 1, 10);
 str3 = string_format(pi, 5, 5);
 

This will set str1 to "    1234", str2 to "3.1415926535" and str3 to "    3.14159".


Back: Strings



No Examples Submitted

Does this page need better examples? Be the first to Submit

No Edits Suggested

Is this page unclear or not descriptive enough? Suggest an edit to the page and with enough upvotes your changes will be made.

No Questions Have Been Ask

Do you have a question about this page? Ask it Here