Collection API Functions - Versionsgeschichte

Sv: Änderung übernommen aus altem Wiki von cg, 16.2.26

2026-02-23T10:45:34Z

Änderung übernommen aus altem Wiki von cg, 16.2.26

Cg: /* Copy and Replacing */

2023-10-26T10:33:46Z

Copy and Replacing

← Nächstältere Version		Version vom 26. Oktober 2023, 10:33 Uhr
Zeile 127:		Zeile 127:
	::Giving an empty replacement collection has the same effect as '''copyWithout:'''.		::Giving an empty replacement collection has the same effect as '''copyWithout:'''.
	::Examples:		::Examples:
	<div style="margin-left: 4em;">~~::: 'abcdefabc' copyReplaceAll: $a withAll: 'XXX' => 'XXXbcdefXXXbc'~~		<div style="margin-left: 4em;">
			'abcdefabc' copyReplaceAll: $a withAll: 'XXX'
			=> 'XXXbcdefXXXbc'

	'abcdefabc' copyReplaceAll: $a withAll: ''		'abcdefabc' copyReplaceAll: $a withAll: ''
	=> 'bcdefbc'		=> 'bcdefbc'

Cg: /* Creation */

2023-10-26T10:33:00Z

Creation

@@ Zeile 25: / Zeile 25: @@
 ::For OrderedCollections, the size argument defines the number of preallocated slots in the collection; however, the logical size of it is zero (i.e. it is empty).
 ::
-::This is a somewhat irritating behavior due to historic reasons within the Smalltalk language (backward compatibility)
+::This is a somewhat irritating behavior due to historic reasons within the Smalltalk language (backward compatibility).
 ::Examples:
 <div style="margin-left: 4em;">
@@ Zeile 38: / Zeile 34: @@
   => #(nil nil nil nil nil)
   a := Array new:3 withAll:0.
+  a
   => #(0 0 0)
 </div>
 === Accessing ===

Cg: /* Creation */

2023-10-26T10:30:20Z

Creation

@@ Zeile 32: / Zeile 32: @@
 Or by taking the contents from another collection:
 :<CODE>OrderedCollection</CODE> '''newFrom:''' ''anotherCollection''
 === Accessing ===

Cg: /* Accessing */

2023-10-26T10:28:41Z

Accessing

← Nächstältere Version		Version vom 26. Oktober 2023, 10:28 Uhr
Zeile 54:		Zeile 54:
	<div style="margin-left: 4em;">		<div style="margin-left: 4em;">
	'hello world' at:2		'hello world' at:2
	=> $e <SMALL>(Notice: the dollar-char notation represents a character constant in Smalltalk)</SMALL>		=> $e <SMALL>"/ (Notice: the dollar-char notation represents a character constant in Smalltalk)</SMALL>

	'hello world'[5]		'hello world'[5]
Zeile 70:		Zeile 70:
	::Depending on the type of collection, this will be a numeric index (Array, OrderedCollection) or a general access key (Dictionary, OrderedDictionary).<br>Example:		::Depending on the type of collection, this will be a numeric index (Array, OrderedCollection) or a general access key (Dictionary, OrderedDictionary).<br>Example:
	<div style="margin-left: 4em;">		<div style="margin-left: 4em;">
	s := 'hello world' copy. <SMALL>(Notice: use a copy here, because constants are immutable)</SMALL>		s := 'hello world' copy. <SMALL>"/ (Notice: use a copy here, because constants are immutable)</SMALL>
	s at:2 put:$*.		s at:2 put:$*.
	s		s
Zeile 80:		Zeile 80:
	=> OrderedCollection(90 -1 50 20 99)		=> OrderedCollection(90 -1 50 20 99)

	s := 'hello world' copy. <SMALL>(Notice: use a copy here, because constants are immutable)</SMALL>		s := 'hello world' copy. <SMALL>"/ (Notice: use a copy here, because constants are immutable)</SMALL>
	s[5] := $O.		s[5] := $O.
	s		s

Cg: /* Accessing */

2023-10-26T10:27:57Z

Accessing

← Nächstältere Version		Version vom 26. Oktober 2023, 10:27 Uhr
Zeile 70:		Zeile 70:
	::Depending on the type of collection, this will be a numeric index (Array, OrderedCollection) or a general access key (Dictionary, OrderedDictionary).<br>Example:		::Depending on the type of collection, this will be a numeric index (Array, OrderedCollection) or a general access key (Dictionary, OrderedDictionary).<br>Example:
	<div style="margin-left: 4em;">		<div style="margin-left: 4em;">
	s := 'hello world' copy.		s := 'hello world' copy. <SMALL>(Notice: use a copy here, because constants are immutable)</SMALL>
	s at:2 put:$*.		s at:2 put:$*.
	s		s

Cg: /* Copy and Replacing */

2023-10-26T10:27:07Z

Copy and Replacing

← Nächstältere Version		Version vom 26. Oktober 2023, 10:27 Uhr
Zeile 93:		Zeile 93:
	::returns a copy of ''aCollection'' where all occurrences of ''oldElement'' have been replaced by ''newElement''.		::returns a copy of ''aCollection'' where all occurrences of ''oldElement'' have been replaced by ''newElement''.
	::Examples:		::Examples:
			<div style="margin-left: 4em;">
⚫	~~:::~~ ~~'abcdefabc'~~ copyReplaceAll: $a with: ~~$A =>~~ ~~'AbcdefAbc'~~
	~~:::~~ ~~#(1 2 3 4)~~ copyReplaceAll: 1 with: ~~100 => #(100~~ 2 3 4)		'abcdefabc' copyReplaceAll: $a with: $A
			=> 'AbcdefAbc'

		⚫	#(1 2 3 4) copyReplaceAll: 1 with: 100
			=> #(100 2 3 4)
			</div>

	:''aCollection'' '''copyReplaceAll:''' ''element'' '''withAll:''' ''newElements''		:''aCollection'' '''copyReplaceAll:''' ''element'' '''withAll:''' ''newElements''
Zeile 100:		Zeile 105:
	::Giving an empty replacement collection has the same effect as '''copyWithout:'''.		::Giving an empty replacement collection has the same effect as '''copyWithout:'''.
	::Examples:		::Examples:
	::: 'abcdefabc' copyReplaceAll: $a withAll: 'XXX' => 'XXXbcdefXXXbc'		<div style="margin-left: 4em;">::: 'abcdefabc' copyReplaceAll: $a withAll: 'XXX' => 'XXXbcdefXXXbc'
	~~:::~~ 'abcdefabc' copyReplaceAll: $a withAll: '~~' => 'bcdefbc~~'		'abcdefabc' copyReplaceAll: $a withAll: ''
			=> 'bcdefbc'
⚫	~~:::~~ #(1 2 3 4) copyReplaceAll: 1 withAll: #(100 200 300~~) => #(100 200 300 2 3 4~~)

		⚫	#(1 2 3 4) copyReplaceAll: 1 withAll: #(100 200 300)
			=> #(100 200 300 2 3 4)
			</div>

	:''aCollection'' '''copyWithout:''' ''element''		:''aCollection'' '''copyWithout:''' ''element''
	::returns a copy of ''aCollection'' where ''element'' have been removed.		::returns a copy of ''aCollection'' where ''element'' have been removed.
	::Examples:		::Examples:
			<div style="margin-left: 4em;">
	::: 'abcdefabc' copyWithout: $a => 'bcdefbc'
	~~::: #(1 2 3 4)~~ copyWithout: ~~1 => #(2 3 4)~~		'abcdefabc' copyWithout: $a
			=> 'bcdefbc'

			#(1 2 3 4) copyWithout: 1
			=> #(2 3 4)
			</div>

	=== Copying by Numeric Index ===		=== Copying by Numeric Index ===

Cg: /* Copy and Replacing */

2023-10-26T10:24:29Z

Copy and Replacing

← Nächstältere Version		Version vom 26. Oktober 2023, 10:24 Uhr
Zeile 87:		Zeile 87:

	=== Copy and Replacing ===		=== Copy and Replacing ===
			These are functional (i.e. non-destructive) operations, meaning that a new collection instance is returned and the original is not modified.
			<br>There are also destructive variants (without a 'copy' in the name), which are not documented here, as their use is considered to be "bad style".

	:''aCollection'' '''copyReplaceAll:''' ''element'' '''with:''' ''newElement''		:''aCollection'' '''copyReplaceAll:''' ''element'' '''with:''' ''newElement''
	::returns a copy of ''aCollection'' where all occurrences of ''oldElement'' have been replaced by ''newElement''.		::returns a copy of ''aCollection'' where all occurrences of ''oldElement'' have been replaced by ''newElement''.
	::Examples:		::Examples:
	::: 'abcdefabc' copyReplaceAll: $a with: $A => 'AbcdefAbc'		::: 'abcdefabc' copyReplaceAll: $a with: $A => 'AbcdefAbc'
	::: #(1 2 3 4) copyReplaceAll: 1 with: 100 => #(100 2 3 4)		::: #(1 2 3 4) copyReplaceAll: 1 with: 100 => #(100 2 3 4)

			:''aCollection'' '''copyReplaceAll:''' ''element'' '''withAll:''' ''newElements''
			::returns a copy of ''aCollection'' where ''newElements'' have been sliced in, whereever ''oldElement'' was encountered.
			::Giving an empty replacement collection has the same effect as '''copyWithout:'''.
			::Examples:
			::: 'abcdefabc' copyReplaceAll: $a withAll: 'XXX' => 'XXXbcdefXXXbc'
			::: 'abcdefabc' copyReplaceAll: $a withAll: '' => 'bcdefbc'
			::: #(1 2 3 4) copyReplaceAll: 1 withAll: #(100 200 300) => #(100 200 300 2 3 4)

			:''aCollection'' '''copyWithout:''' ''element''
			::returns a copy of ''aCollection'' where ''element'' have been removed.
			::Examples:
			::: 'abcdefabc' copyWithout: $a => 'bcdefbc'
			::: #(1 2 3 4) copyWithout: 1 => #(2 3 4)

	=== Copying by Numeric Index ===		=== Copying by Numeric Index ===

Cg: /* Copying by Numeric Index */

2023-10-26T10:19:14Z

Copying by Numeric Index

← Nächstältere Version		Version vom 26. Oktober 2023, 10:19 Uhr
Zeile 95:		Zeile 95:
	=== Copying by Numeric Index ===		=== Copying by Numeric Index ===
	These functions are applicable to collections with a numeric index (i.e. Array, OrderedCollection, ByteArray, String, SortedCollection, FloatArray, DoubleArray, etc.).		These functions are applicable to collections with a numeric index (i.e. Array, OrderedCollection, ByteArray, String, SortedCollection, FloatArray, DoubleArray, etc.).
	<br>They are functional (i.e. non-destructive), meaning that a new collection instance is returned and the original is not modified.

	:''aCollection'' '''copyFrom:''' ''startIndex'' '''to:''' ''endIndex''		:''aCollection'' '''copyFrom:''' ''startIndex'' '''to:''' ''endIndex''

Cg: /* Copying by Numeric Index */

2023-10-26T10:18:58Z

Copying by Numeric Index

← Nächstältere Version		Version vom 26. Oktober 2023, 10:18 Uhr
Zeile 95:		Zeile 95:
	=== Copying by Numeric Index ===		=== Copying by Numeric Index ===
	These functions are applicable to collections with a numeric index (i.e. Array, OrderedCollection, ByteArray, String, SortedCollection, FloatArray, DoubleArray, etc.).		These functions are applicable to collections with a numeric index (i.e. Array, OrderedCollection, ByteArray, String, SortedCollection, FloatArray, DoubleArray, etc.).
			<br>They are functional (i.e. non-destructive), meaning that a new collection instance is returned and the original is not modified.

	:''aCollection'' '''copyFrom:''' ''startIndex'' '''to:''' ''endIndex''		:''aCollection'' '''copyFrom:''' ''startIndex'' '''to:''' ''endIndex''