Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

itemcontainer.delete - Function

	Package	utility
	Module	misc
	Tool	itemcontainer

Remove the item from the container

Synopsis
delete(item)

Arguments

item		Item
		Allowed:	String or Integer

Returns

Description

This tool function removes the specified item from the container. Item can be an item name or the number of an item. (It does not remove the field from the container to preserve indexing, but sets the item's value to illegal.)

Example

- include 'quanta.g';
T
- const i1 := itemcontainer();
- idx := i1.add(dq.quantity(10,'arcsec'));
- x := i1.get(idx);
- x;
[value=10, unit=arcsec]
- i1.delete(idx);
T
- i1.get(idx);
<fail>: Requested item "1" is not present
        File:   ./itemcontainer.g, Line 152
        Stack:  .() 
-