Format
From SA-MP Wiki
Formats a string to include variables and other strings inside it.
(output[], len, const format[], {Float,_}:...)
| output[] | The string to output the result to |
| len | The maximum length output can contain |
| format[] | The format string |
| {Float,_}:... | Indefinite number of arguments of any tag |
| Returns | This function doesn't return a specific value |
Format Strings
| Placeholder | Meaning |
|---|---|
| %b | Inserts a number at this position in binary radix |
| %c | Inserts a single character. |
| %d | Inserts an integer (whole) number |
| %f | Inserts a floating point number. |
| %i | Inserts an integer. |
| %s | Inserts a string. |
| %x | Inserts a number in hexadecimal notation. |
| %% | Inserts the literal '%' |
The values for the placeholders follow in the exact same order as parameters in the call.
You may optionally put a number between the '%' and the letter of the placeholder code. This number indicates the field width; if the size of the parameter to print at the position of the placeholder is smaller than the field width, the field is expanded with spaces. To cut the number of decimal places beeing shown of a float, you can add '.<max number>' between the '%' and the 'f'. (example: %.2f)
new result[128]; new number = 42; format(result,sizeof(result), "The number is %i.",number); //-> The number is 42. new string[]= "simple message"; format(result,sizeof(result), "This is a %s containing the number %i.", string, number); // This is a simple message containing the number 42.
new string[64]; format(string,sizeof(string),"Your score is: %d",GetPlayerScore(playerid)); SendClientMessage(playerid,0xFFFFFFAA,string);
A quite easy way to insert the literal percent sign (%) is by doing the following.
new string[35]; format(string,sizeof(string),"43%s of my shirts are black.","%%"); SendClientMessage(playerid,0xFFFFFAA,string);
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- Print: Print a basic message in the logs and console.
- Printf: Print a formatted message into the logs and console.
