There are many places where programs written using grace seem to be syntactically closer to languages like Python than to C. String formatting used to be not one of these places. Historically, formatting text with dynamic elements within grace was a matter of using either string::printf() or file::printf(). These are C-style printf formatters, which means they accept a variable argument list consisting of a ‘format string’ and one or more integer or pointer arguments. When dealing with value and string objects, this means liberally using explicit casts like cval() and ival() to convert those to printf-compatible types.
The library version inside the repository now supports a friendlier way of going about things, one that does away with all the explicit casting in the form of the %format pseudo-keyword. In its most simple incarnation, it works mostly the same as a normal printf formatting operation, except that it can deal with any objects that can be cast to value:
string test = "%i bottles of %s" %format (99, "beer");
One level up on the funky scale is referring to positioned arguments:
fout.writeln ("<%s>%s</%{0}s>" %format ("str","foo"));
Finally, you can access children of the first argument like this:
value v;
v["name"] = "John Smith";
v["email"] = "j.smith@example.net";
fout.writeln ("%[name]s <%[email]s>" %format (v));
This way of formatting, apart from being more flexible and less sensitive to formatting-related security problems (since it doesn’t need to follow arbitrary pointers), adds a lot of clarity to your source code, which is a major plus for keeping up maintainable code.