Number API Functions - Versionsgeschichte

Cg: /* Format Overview */

2026-05-24T17:06:36Z

Format Overview

← Nächstältere Version		Version vom 24. Mai 2026, 17:06 Uhr
Zeile 1.025:		Zeile 1.025:
	* 'n' (not implemented) stores number of characters written so far into arg		* 'n' (not implemented) stores number of characters written so far into arg
	* 'o' base-8 octal		* 'o' base-8 octal
	* 'p' (not implemented) pointer		* 'p' prints numbers as hex; (not implemented: pointer
	* 's' string		* 's' string
	* 't' type (i.e. class name)		* 't' type (i.e. class name)

Cg: /* Printing */

2026-05-24T17:02:35Z

Printing

← Nächstältere Version		Version vom 24. Mai 2026, 17:02 Uhr
Zeile 752:		Zeile 752:
	:''aNumber'' '''printStringRoman''' => string		:''aNumber'' '''printStringRoman''' => string
	::generates a roman string; eg. <code>2026 printStringRoman</code> => 'MMXXVI'.<br>This may be useful for reports and generated testresult documents.		::generates a roman string; eg. <code>2026 printStringRoman</code> => 'MMXXVI'.<br>This may be useful for reports and generated testresult documents.
	:''aNumber'' '''printRomanOn:''' ''aStream'' [ '''naive:''' ''aBoolean'' => void		:''aNumber'' '''printRomanOn:''' ''aStream'' [ '''naive:''' ''aBoolean'' ] => void
	::roman style number printed on ''aStream''. If the ''naive'' ~~arguent~~ is given as true, a 4 (four) is printed as 'IIII', whereas otherwise, its printed as 'IV'.		::roman style number printed on ''aStream''. If the ''naive'' argument is given as true, a 4 (four) is printed as 'IIII', whereas otherwise, its printed as 'IV'.
	::the complementary read method is <code>"Integer readFromRomanString:''aString''</code> which handles both ~~naive~~ and regular roman number strings.		::the complementary read method is <code>"Integer readFromRomanString:''aString''</code> which handles both naïve and regular roman number strings.

	=== Reading from Streams / Converting from Strings ===		=== Reading from Streams / Converting from Strings ===

Cg: /* Printing */

2026-05-24T16:59:52Z

Printing

← Nächstältere Version		Version vom 24. Mai 2026, 16:59 Uhr
Zeile 754:		Zeile 754:
	:''aNumber'' '''printRomanOn:''' ''aStream'' [ '''naive:''' ''aBoolean'' => void		:''aNumber'' '''printRomanOn:''' ''aStream'' [ '''naive:''' ''aBoolean'' => void
	::roman style number printed on ''aStream''. If the ''naive'' arguent is given as true, a 4 (four) is printed as 'IIII', whereas otherwise, its printed as 'IV'.		::roman style number printed on ''aStream''. If the ''naive'' arguent is given as true, a 4 (four) is printed as 'IIII', whereas otherwise, its printed as 'IV'.
			::the complementary read method is <code>"Integer readFromRomanString:''aString''</code> which handles both naive and regular roman number strings.

	=== Reading from Streams / Converting from Strings ===		=== Reading from Streams / Converting from Strings ===

Cg: /* Printing */

2026-05-24T16:56:47Z

Printing

← Nächstältere Version		Version vom 24. Mai 2026, 16:56 Uhr
Zeile 751:		Zeile 751:

	:''aNumber'' '''printStringRoman''' => string		:''aNumber'' '''printStringRoman''' => string
	::generates a roman string; eg. <code>2026 printStringRoman</code> => 'MMXXVI'. This is useful for reports and generated ~~overview~~ documents.		::generates a roman string; eg. <code>2026 printStringRoman</code> => 'MMXXVI'.<br>This may be useful for reports and generated testresult documents.
	:''aNumber'' '''printRomanOn:''' ''aStream'' [ '''naive:''' ''aBoolean'' => void		:''aNumber'' '''printRomanOn:''' ''aStream'' [ '''naive:''' ''aBoolean'' => void
	::roman style number printed on ''aStream''. If the ''naive'' arguent is given as true, a 4 (four) is printed as 'IIII', whereas otherwise, its printed as 'IV'.		::roman style number printed on ''aStream''. If the ''naive'' arguent is given as true, a 4 (four) is printed as 'IIII', whereas otherwise, its printed as 'IV'.

Cg: /* Printing */

2026-05-24T16:55:56Z

Printing

← Nächstältere Version		Version vom 24. Mai 2026, 16:55 Uhr
Zeile 751:		Zeile 751:

	:''aNumber'' '''printStringRoman''' => string		:''aNumber'' '''printStringRoman''' => string
	::generates a roman string; eg. <code>2026 printStringRoman</code> => 'MMXXVI'.		::generates a roman string; eg. <code>2026 printStringRoman</code> => 'MMXXVI'. This is useful for reports and generated overview documents.
	:''aNumber'' '''printRomanOn:''' ''aStream'' => void		:''aNumber'' '''printRomanOn:''' ''aStream'' [ '''naive:''' ''aBoolean'' => void
	::roman style number printed on ''aStream''.		::roman style number printed on ''aStream''. If the ''naive'' arguent is given as true, a 4 (four) is printed as 'IIII', whereas otherwise, its printed as 'IV'.

	=== Reading from Streams / Converting from Strings ===		=== Reading from Streams / Converting from Strings ===

Cg: /* Printing */

2026-05-24T16:53:07Z

Printing

← Nächstältere Version		Version vom 24. Mai 2026, 16:53 Uhr
Zeile 742:		Zeile 742:
	'%+.4f' printf:{Float pi negated} => '-3.1416' ('+' after % enforces sign)		'%+.4f' printf:{Float pi negated} => '-3.1416' ('+' after % enforces sign)
	</div>		</div>
	:: Please refer to a C-printf manual page (e.g. https://en.wikipedia.org/wiki/Printf_format_string) and the [[#Printf_Format_Specifier\|"Printf Format Specifier" ~~paragraph~~]] below.		:: Please refer to a C-printf manual page (e.g. https://en.wikipedia.org/wiki/Printf_format_string) and the [[#Printf_Format_Specifier\|"Printf Format Specifier"]] paragraph below.
	:: Notice that printf accepts C-style character escapes (which is not the case in general with Smalltalk string constants)		:: Notice that printf accepts C-style character escapes (which is not the case in general with Smalltalk string constants)

Cg: /* Reading from Streams / Converting from Strings */

2026-05-24T16:52:34Z

Reading from Streams / Converting from Strings

← Nächstältere Version		Version vom 24. Mai 2026, 16:52 Uhr
Zeile 788:		Zeile 788:

	:''formatString'' '''sscanf:''' ''aString'' => collection		:''formatString'' '''sscanf:''' ''aString'' => collection
	:: ''formatString'' is a printf/scanf-like format string; reads items from ''aString'' and returns a collection (i.e. an Array) of scanned objects.<br>For example,<br><code> '%d %x %f' sscanf: '1234 FF 3.1415'</code><br>will return an array-like collection with 3 elements, the integer 1234, the integer 255 and the float 3.14159. See [[#Scanf_Format_Specifier\|Scanf ~~format~~ ~~specifier~~ below]].		:: ''formatString'' is a printf/scanf-like format string; reads items from ''aString'' and returns a collection (i.e. an Array) of scanned objects.<br>For example,<br><code> '%d %x %f' sscanf: '1234 FF 3.1415'</code><br>will return an array-like collection with 3 elements, the integer 1234, the integer 255 and the float 3.14159.<br>See [[#Scanf_Format_Specifier\|"Scanf Format Specifier"]] below.

	:''formatString'' '''scanf:''' ''aStream'' => collection		:''formatString'' '''scanf:''' ''aStream'' => collection

Cg: /* Printing */

2026-05-24T16:51:39Z

Printing

← Nächstältere Version		Version vom 24. Mai 2026, 16:51 Uhr
Zeile 742:		Zeile 742:
	'%+.4f' printf:{Float pi negated} => '-3.1416' ('+' after % enforces sign)		'%+.4f' printf:{Float pi negated} => '-3.1416' ('+' after % enforces sign)
	</div>		</div>
	:: Please refer to a C-printf manual page (e.g. https://en.wikipedia.org/wiki/Printf_format_string) and the [[#Printf_Format_Specifier\|~~printf~~ ~~format~~ ~~specifier~~ paragraph]] below.		:: Please refer to a C-printf manual page (e.g. https://en.wikipedia.org/wiki/Printf_format_string) and the [[#Printf_Format_Specifier\|"Printf Format Specifier" paragraph]] below.
	:: Notice that printf accepts C-style character escapes (which is not the case in general with Smalltalk string constants)		:: Notice that printf accepts C-style character escapes (which is not the case in general with Smalltalk string constants)

Cg: /* Examples */

2026-05-24T16:48:25Z

Examples

← Nächstältere Version		Version vom 24. Mai 2026, 16:48 Uhr
Zeile 1.048:		Zeile 1.048:
	'\|%-5d\|' printf: { 123 } -> <small>'\|123 \|'</small>		'\|%-5d\|' printf: { 123 } -> <small>'\|123 \|'</small>

			'\|%x\|' printf: { 123 } -> <small>'\|7b\|'</small>
			'\|%05x\|' printf: { 123 } -> <small>'\|0007b\|'</small>
			'\|%#x\|' printf: { 123 } -> <small>'\|0x7b\|'</small>
			'\|%#05x\|' printf: { 123 } -> <small>'\|0x07b\|'</small>
			'\|%#08x\|' printf: { 123 } -> <small>'\|0x00007b\|'</small>

	'\|%s\|' printf: { 'abc' } -> <small>'\|abc\|'</small>		'\|%s\|' printf: { 'abc' } -> <small>'\|abc\|'</small>
	'\|%5s\|' printf: { 'abc' } -> <small>'\| abc\|'</small>		'\|%5s\|' printf: { 'abc' } -> <small>'\| abc\|'</small>

Cg: /* Format Overview */

2026-05-24T16:45:03Z

Format Overview

← Nächstältere Version		Version vom 24. Mai 2026, 16:45 Uhr
Zeile 1.001:		Zeile 1.001:

	Prefixes:		Prefixes:
	* ' ' fill with spaces		* ' ' fill with spaces (a space as prefix, as in '% 5d')
	* '0' fill with zeros		* '0' fill with zeros (as in '%05d')
	* <nowiki>''''</nowiki> with thousands separator; the quote must be escaped in a C-string or doubled		* <nowiki>''''</nowiki> with thousands separator; the quote must be escaped in a C-string or doubled in a raw string
	* '_' with underline as thousands separator (new in expecco 26.2)		* '_' with underline as thousands separator (new in expecco 26.2)
	* '+' print the sign		* '+' print the sign
	* '-' left justified		* '-' left justified
	* '#' depends:		* '#' depends:
	** with %o, %x, %b: print base prefix		** with %o, %x, %b: print base prefix (as in '%#x')
	** with %e always show decimal point		** with %e always show decimal point (as in '%#e')
	** with %e, %E, %f, %g always show decimal point		** with %e, %E, %f, %g always show decimal point

← Nächstältere Version		Version vom 24. Mai 2026, 16:48 Uhr
Zeile 1.048:		Zeile 1.048:
	'\|%-5d\|' printf: { 123 } -> <small>'\|123 \|'</small>		'\|%-5d\|' printf: { 123 } -> <small>'\|123 \|'</small>

			'\|%x\|' printf: { 123 } -> <small>'\|7b\|'</small>
			'\|%05x\|' printf: { 123 } -> <small>'\|0007b\|'</small>
			'\|%#x\|' printf: { 123 } -> <small>'\|0x7b\|'</small>
			'\|%#05x\|' printf: { 123 } -> <small>'\|0x07b\|'</small>
			'\|%#08x\|' printf: { 123 } -> <small>'\|0x00007b\|'</small>

	'\|%s\|' printf: { 'abc' } -> <small>'\|abc\|'</small>		'\|%s\|' printf: { 'abc' } -> <small>'\|abc\|'</small>
	'\|%5s\|' printf: { 'abc' } -> <small>'\| abc\|'</small>		'\|%5s\|' printf: { 'abc' } -> <small>'\| abc\|'</small>