Number API Functions - Versionsgeschichte

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

2026-03-11T12:35:18Z

Reading from Streams / Converting from Strings

← Nächstältere Version		Version vom 11. März 2026, 12:35 Uhr
Zeile 783:		Zeile 783:

	:''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 ~~specifiers~~ 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. See [[#Scanf_Format_Specifier\|Scanf format specifier below]].

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

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

2026-03-11T12:34:19Z

Reading from Streams / Converting from Strings

← Nächstältere Version		Version vom 11. März 2026, 12:34 Uhr
Zeile 783:		Zeile 783:

	:''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.		:: ''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 specifiers below]]

	:''formatString'' '''scanf:''' ''aStream'' => collection		:''formatString'' '''scanf:''' ''aStream'' => collection
	:: like above, but the elements will be read from a character stream		:: like above, but the elements will be read from a character stream

	:To read binary numbers, refer to the stream API.		:To read binary numbers from a stream, refer to the stream API.

	=== Conversion ===		=== Conversion ===

Cg: /* Scanf Format Specifier */

2026-03-11T11:55:35Z

Scanf Format Specifier

← Nächstältere Version		Version vom 11. März 2026, 11:55 Uhr
Zeile 1.110:		Zeile 1.110:
	Length prefix:		Length prefix:

	* 'h' with float formats: reads as ShortFloat		* 'h' with float formats: reads as ShortFloat (Float32)
	* 'L' with float formats: reads as LongFloat		* 'L' with float formats: reads as LongFloat (Float80)
			* 'LQ' with float formats: reads as QDouble
			* 'LL' with float formats: reads as LargeFloat

	Examples:		Examples:
Zeile 1.124:		Zeile 1.126:
	('%hf' sscanf:'1234') first <small>-> 1234.0 (ShortFloat i.e. an IEEE single)</small>		('%hf' sscanf:'1234') first <small>-> 1234.0 (ShortFloat i.e. an IEEE single)</small>
	('%Lf' sscanf:'1234') first <small>-> 1234.0 (LongFloat i.e. an IEEE extended)</small>		('%Lf' sscanf:'1234') first <small>-> 1234.0 (LongFloat i.e. an IEEE extended)</small>
	('%~~LLf~~' sscanf:'1234') first <small>-> 1234.0 (QDouble)</small>		('%LQf' sscanf:'1234') first <small>-> 1234.0 (QDouble)</small>
			('%LLf' sscanf:'1234') first <small>-> 1234.0 (LargeFloat)</small>

	= See Also =		= See Also =

Cg: /* Format Overview */

2026-03-11T11:49:11Z

Format Overview

← Nächstältere Version		Version vom 11. März 2026, 11:49 Uhr
Zeile 990:		Zeile 990:
	* '0' fill with zeros		* '0' fill with zeros
	* <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
	* '_' with underline as thousands separator		* '_' with underline as thousands separator (new in expecco 26.2)
	* '+' print the sign		* '+' print the sign
	* '-' left justified		* '-' left justified

Cg: /* Examples */

2026-03-11T11:48:25Z

Examples

← Nächstältere Version		Version vom 11. März 2026, 11:48 Uhr
Zeile 1.048:		Zeile 1.048:
	Thousands separator (notice the escaped quote):		Thousands separator (notice the escaped quote):
	<nowiki>'\|%''d\|'</nowiki> printf: { 1234567 } -> <small>'\|1,234,567\|'</small>		<nowiki>'\|%''d\|'</nowiki> printf: { 1234567 } -> <small>'\|1,234,567\|'</small>
	c'\|%\'d\|' printf: { 1234567 } -> <small>'\|1,234,567\|'</small>		c'\|%\'d\|' printf: { 1234567 } -> <small>'\|1,234,567\|'</small>
			'\|%_d\|' printf: { 1234567 } -> <small>'\|1_234_567\|'</small> (expecco 26.2)

	Negative width will fill at the right:		Negative width will fill at the right:

Cg: /* Format Overview */

2026-03-11T11:47:00Z

Format Overview

← Nächstältere Version		Version vom 11. März 2026, 11:47 Uhr
Zeile 1.025:		Zeile 1.025:

	Special output specifier:		Special output specifier:
	* <n>! if the number's string is larger than the field width <n>, it will be filled with '#'s. Useful if you want to ensure tabular data to remain aligned. This is not a posix ~~printf~~ specified, but a Smalltalk/X extension.		* <n>! if the number's string is larger than the field width <n>, it will be filled with '#'s. Useful if you want to ensure tabular data to remain aligned. This is not a posix specified format, but a Smalltalk/X extension.

	==== Examples ====		==== Examples ====

Cg: /* Format Overview */

2026-03-11T11:46:19Z

Format Overview

← Nächstältere Version		Version vom 11. März 2026, 11:46 Uhr
Zeile 994:		Zeile 994:
	* '-' left justified		* '-' left justified
	* '#' depends:		* '#' depends:
	** %o, %x, %b: print base prefix		** with %o, %x, %b: print base prefix
	** %e always show decimal point		** with %e always show decimal point
	** %e, %E, %f, %g always show decimal point		** with %e, %E, %f, %g always show decimal point

	Conversions:		Conversions:

Cg: /* Format Overview */

2026-03-11T11:45:21Z

Format Overview

← Nächstältere Version		Version vom 11. März 2026, 11:45 Uhr
Zeile 990:		Zeile 990:
	* '0' fill with zeros		* '0' fill with zeros
	* <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
			* '_' with underline as thousands separator
	* '+' print the sign		* '+' print the sign
	* '-' left justified		* '-' left justified

Cg: /* Format Overview */

2026-03-11T11:11:52Z

Format Overview

← Nächstältere Version		Version vom 11. März 2026, 11:11 Uhr
Zeile 989:		Zeile 989:
	* ' ' fill with spaces		* ' ' fill with spaces
	* '0' fill with zeros		* '0' fill with zeros
	* <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
	* '+' print the sign		* '+' print the sign
	* '-' left justified		* '-' left justified
Zeile 1.024:		Zeile 1.024:

	Special output specifier:		Special output specifier:
	* <n>! if the number's string is larger than the field width <n>, it will be filled with '#'s. Useful if you want to ensure tabular data to remain aligned. This is not a posix printf specified, but a Smalltalk/X extension.		* <n>! if the number's string is larger than the field width <n>, it will be filled with '#'s. Useful if you want to ensure tabular data to remain aligned. This is not a posix printf specified, but a Smalltalk/X extension.

	==== Examples ====		==== Examples ====

Cg: /* Printf Format Specifier */

2026-03-11T11:11:07Z

Printf Format Specifier

← Nächstältere Version		Version vom 11. März 2026, 11:11 Uhr
Zeile 928:		Zeile 928:
	== Printf Format Specifier ==		== Printf Format Specifier ==

			==== General ====
	Characters not escaped by a '%' are printed as-is.		Characters not escaped by a '%' are printed as-is.
	Following a '%' there can be:		Following a '%' there can be:
Zeile 936:		Zeile 937:
	* required: character describing output behavior (POSIX: <<conversion specifier>>)		* required: character describing output behavior (POSIX: <<conversion specifier>>)

			==== Format Variants ====
	The format follows the ''official'' C-library printf formats; however, there are differences in		The format follows the ''official'' C-library printf formats; however, there are differences in
	the various printf implementations:		the various printf implementations:
Zeile 981:		Zeile 983:
	* 'S' for store-string (of any object)		* 'S' for store-string (of any object)
	* 'P' for print-string (of any object)		* 'P' for print-string (of any object)

			==== Format Overview ====

	Prefixes:		Prefixes:
	* ' ' fill with spaces		* ' ' fill with spaces
	* '0' fill with zeros		* '0' fill with zeros
	* '\' ' with thousands separator; the quote must be escaped or doubled		* <nowiki>''''</nowiki> with thousands separator; the quote must be escaped in a C-string or doubled
	* '+' print the sign		* '+' print the sign
	* '-' left justified		* '-' left justified
Zeile 1.021:		Zeile 1.025:
	Special output specifier:		Special output specifier:
	* <n>! if the number's string is larger than the field width <n>, it will be filled with '#'s. Useful if you want to ensure tabular data to remain aligned. This is not a posix printf specified, but a Smalltalk/X extension.		* <n>! if the number's string is larger than the field width <n>, it will be filled with '#'s. Useful if you want to ensure tabular data to remain aligned. This is not a posix printf specified, but a Smalltalk/X extension.

			==== Examples ====

	Examples <sup>1)</sup>:		Examples <sup>1)</sup>:
Zeile 1.040:		Zeile 1.046:

	Thousands separator (notice the escaped quote):		Thousands separator (notice the escaped quote):
	'\|%''d\|' printf: { 1234567 } -> <small>'\|1,234,567\|'</small>		<nowiki>'\|%''d\|'</nowiki> printf: { 1234567 } -> <small>'\|1,234,567\|'</small>
	c'\|%\'d\|' printf: { 1234567 } -> <small>'\|1,234,567\|'</small>		c'\|%\'d\|' printf: { 1234567 } -> <small>'\|1,234,567\|'</small>