Obsolete test build - format() - 1.1.16.05-13+g79cee0b

[lexikos]

Obsolete: see v1.1.17.

I have uploaded a test build with a new function:

string := Format(format, values*)

The format string should contain placeholders of the form {param:format}.
param: An integer corresponding to the position of a value in the parameter list, where 1 is the first parameter after format. If omitted, the number of the last placeholder + 1 is used (or 1 for the first placeholder).
format: A string controlling how the value will be formatted. The following subset of the printf format specification is supported:

• flags: - + 0 space #
  width: decimal integer only
  .precision: decimal integer only
  type: d i o u x X e E f g G a A c C p s (not n S Z)

Size prefixes are not supported - numbers are always 64-bit, except the character and pointer types.

type defaults to 's' if omitted. 's' is a string value, not a pointer to a string.

As with Send, {{} and {}} produce literal braces. Any invalid placeholders are put into the output as is. Whitespace inside the braces is not permitted (except as a flag).

Examples:

Code: Select all

; Simple substitution
s .= format("{2}, {1}!`r`n", "World", "Hello")
; Padding with spaces
s .= format("|{:-10}|`r`n|{:10}|`r`n", "Left", "Right")
; Hexadecimal
s .= format("{1:#x} {2:X} 0x{3:x}`r`n", 3735928559, 195948557, 0)
; Floating-point
s .= format("{1:0.3f} {1:.10f}", 4*atan(1))

ListVars
WinWaitActive ahk_class AutoHotkey
ControlSetText Edit1, %s%
WinWaitClose

The differences from format() distributed with v2 alpha include:

• The parameter index can be omitted, as in {} or {:02i}
• The type can be omitted (defaults to 's'), as in {1:5}.
• Size prefixes aren't supported, as mentioned above.

This also contains everything from the previous test build.

Download

---

Hexadecimal integers are always unsigned, as per normal printf behaviour but inconsistent with AutoHotkey's normal hexadecimal formatting. The '#' flag adds the 0x prefix only for non-zero values, again inconsistent with the norm. This is because the formatting of each value is done entirely by printf (to do otherwise would mean potentially much larger code and longer development time).

[fincs]

I'm glad you rebased the changes of your earlier test build on top of the latest v1.1 release. The built-in Format() function will be really useful (no more ugly SetFormat temp hacks!).

BTW: for consistency, shouldn't it be called StrFormat()?

[arcticir]

See this update, I am reminded of another function on the string, I always want to achieve it.
StringToObj()

Such as:

Code: Select all

Test:="key2"
Test2:="3"
;obj:={1:"key1",2:Test,(Test2):"key3"}	;It is not JSON rules, is AHK obj rules.
s={1:"key1",2:Test,(Test2):"key3"}
obj:=StringToObj(s)
MsgBox % ObjTree(obj)

[lexikos]

BTW: for consistency, shouldn't it be called StrFormat()?

I thought about that, but it doesn't seem necessary, just inconvenient. We also have FormatTime, which also produces a formatted string, and SplitPath and Sort, which manipulate strings but don't begin with "Str". Aside from that, it doesn't format a string; it produces a formatted string from zero, one or more values.

Edit: I'm also thinking about adding a simple hex() function, since there's a fairly common need and format("0x{:x}", v) is a bit awkward. (format("{:#x}", v) is slightly better but produces 0 instead of 0x0.)

[joedf]

A built in Str2hex or hex() function would be very useful