OCLOperators insertAt
m ((username removed) (log details removed): Moving to Documentation namespace)
No edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<message>Write the content here to display this box</message>
=== insertAt ( index : Integer, object : T) : Sequence(T) ===
=== insertAt ( index : Integer, object : T) : Sequence(T) ===
Returns a Sequence containing ''self'' with ''object'' inserted at the *index* position.
Returns a Sequence containing ''self'' with ''object'' inserted at the *index* position.
Line 17: Line 18:
|''invalid''
|''invalid''
|}
|}
Insert an object in a specific place in a collection or association. <collection>.insertAt(<position>, <nowiki><object>)</nowiki>   
Insert an object in a specific place in a collection or association. <code><span class="col-black">'''<collection>.insertAt(<position>, <nowiki><object>)</nowiki>'''</span></code>   


Used when you don't want a new object at the end using [[OCLOperators add|add]].  
Used when you don't want a new object at the end using [[Documentation:OCLOperators add|add]].  


For associations, it only makes sense to use insertAt on ordered associations.
For associations, it only makes sense to use insertAt on ordered associations.
* Note that the position is 1-based, not 0.
* Note that the position is 1-based, not 0.
See also: [[Association]]
'''See also:''' [[Documentation:Association|Association]]
[[Category:OCLOperators]]
[[Category:OCLOperators]]
{{Edited|July|12|2025}}
[[Category:OCL Collection Operators]]

Latest revision as of 05:12, 10 February 2025

This page was created by Lars.olofsson@mdriven.net on 2022-07-30. Last edited by Stephanie@mdriven.net on 2025-02-10.

insertAt ( index : Integer, object : T) : Sequence(T)

Returns a Sequence containing self with object inserted at the *index* position.

Expression Result
Sequence{'a', 'b'}->insertAt(0, 'c') invalid
Sequence{'a', 'b'}->insertAt(1, 'c') Sequence{'c', 'a', 'b'}
Sequence{'a', 'b'}->insertAt(3, 'c') Sequence{'a', 'b', 'c'}
Sequence{'a', 'b'}->insertAt(4, 'c') invalid

Insert an object in a specific place in a collection or association. <collection>.insertAt(<position>, <object>)

Used when you don't want a new object at the end using add.

For associations, it only makes sense to use insertAt on ordered associations.

  • Note that the position is 1-based, not 0.

See also: Association