[List] replace: [Number] length: [Number] with: [List]. | Manual

[List] replace: [Number] length: [Number] with: [List].

Returns a copy of the list with the specified elements replaced. The first argument indicates the start index to begin the replacement. Here, 0 means the beginning of the list. The second argument (length) must indicate the number of elements to delete in the copy, counting from the starting point. Finally, one has to provide the replacement list as the third argument. If the replacement list is empty, the specified elements will only be removed from the copy. If the replacement is not an array an error will be thrown.

 ☞ buy := cakes
     replace: 1
     length: 2
     with: ( List ← 'cinnamon' ; 'pineapple' ).

Welcome to the Citrine Online Manual Pages. This online manual has been generated automatically from source code comments using the shtml.ctr script. All Citrine documentation is also available as a UNIX manual file included in the download package. These pages are just a web version of the original Citrine Programming Language User Manual and Reference Guide.

Improve this manual

You can help to improve this manual. Any help is appreciated! If you spot an error in this manual or you want to contribute, just change the corresponding comment in the original Citrine Programming Language source code hosted on github and create a 'Pull Request'. After the documentation generation script has been invoked again the manual pages will be updated to reflect your contribution and so will these online manual pages.

About Citrine

Citrine is an easy to use programming language for everyone. Citrine is so simple it does not even need special syntax for loops or conditions. You can learn Citrine in just a couple of minutes. Citrine makes programming fun again! Visit the homepage for a quick tutorial.

back to homepage | back to manual menu | top of page