Difference between revisions of "Format"

From SDU
Jump to: navigation, search
(New page: formats a string string format(string expression, ... variables) eg. format("Change number is %s", chg_ref_num); format("Change number is %s and description is %s", chg_ref_num, descrip...)
 
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
formats a string
+
__NOTOC__
 +
[[Category:Customizations]]
 +
{{Global Header}}
 +
{{Global Announcement}}
  
string format(string expression, ... variables)
+
== Syntax ==
 +
'''string format(string expression, ... variables);'''
  
eg.
+
{| border="1" style="width:200px;"
format("Change number is %s", chg_ref_num);
+
|+ Escape Characters
format("Change number is %s and description is %s", chg_ref_num, description);
+
|-
 +
! Character
 +
! Description
 +
|-
 +
| %%
 +
| percent sign
 +
|-
 +
|%f
 +
|float
 +
|-
 +
| %d
 +
| int
 +
|-
 +
| %s
 +
| string
 +
|-
 +
|}
  
escape cahracters...
+
'''Example'''
%% = percent sign
+
<source lang="text">format("Change number is %s", chg_ref_num);
%= int
+
format("Change number is %s and description is %s", chg_ref_num, description);</source>
%s = string
+
 
 +
== Formatting a UUID as a string ==
 +
r11.x introduced a new data type known as the UUID which replaced the old integer ID in many areas, most notably with regards to Contacts. This change complicated the printing of the id which previously required only a %d. But since the UUID is not an integer, the %s is now the best solution.  
 +
 
 +
'''Examples'''<source lang="text">string MyResult;
 +
MyResult = format( "The uuid of %s is : %s), assignee.userid, (string)assignee.id);
 +
 
 +
MyResult = format("&{U'%s'=cnt.id->combo_name}", (string)assignee.id);
 +
 
 +
MyResult = format("&{0x%s=cnt.id->combo_name}", (string)assignee.id);</source>

Latest revision as of 13:29, 11 February 2010

To make corrections or additions to this article, select the edit tab above.
To discuss or ask questions about this article, select the discussion tab above.

Syntax

string format(string expression, ... variables);

Escape Characters
Character Description
 %% percent sign
%f float
 %d int
 %s string

Example <source lang="text">format("Change number is %s", chg_ref_num); format("Change number is %s and description is %s", chg_ref_num, description);</source>

Formatting a UUID as a string

r11.x introduced a new data type known as the UUID which replaced the old integer ID in many areas, most notably with regards to Contacts. This change complicated the printing of the id which previously required only a %d. But since the UUID is not an integer, the %s is now the best solution.

Examples<source lang="text">string MyResult; MyResult = format( "The uuid of %s is : %s), assignee.userid, (string)assignee.id);

MyResult = format("&{U'%s'=cnt.id->combo_name}", (string)assignee.id);

MyResult = format("&{0x%s=cnt.id->combo_name}", (string)assignee.id);</source>