1.42.3 Send methods

dict ->append: item=dict_item

Append the dict_item at the end (see dict<-members). Note that class dict_item defines a conversion function to create a dict_item from a key. See dict_item<-convert.

See also dict->insert_after and dict->insert.

Bugs: If there is already a dict_item with this dict_item<-key, the old entry is deleted from dict<-table. A subsequent dict<-member wil this return the last appended dict_item with this dict<-key.

See also

- dict->insert_after
- dict_item<-convert

dict ->clear:

Removes all dict_item objects from the dict. Informs a possibly related dict<-browser.

See also

dict->delete

dict ->delete: any|dict_item

Delete a dict_item object. The dict_item to be deleted may be specified using its dict_item<-key.

Diagnostics: Fails silently when the argument is not a member dict_item or and the key of a member dict_item.

See also

dict->clear

dict ->for_all: action=code, safe=[bool]

Invokes chain->for_all on the chain of dict<-members.

See also

dict<-find

dict ->for_some: action=code, safe=[bool]

Invokes chain->for_some on the chain of dict<-members.

See also

dict<-find

dict ->insert: item=dict_item

Insert dict_item according to dict<-sort_by. If dict<-sort_by is @nil, just dict->append. If dict<-sort_by is @default, insert the item before the first item that is alphabetically larger. It dict<-sort_by contains a code object, insert it before the first item for which executing the code (if it is a function) return larger.

See also chain->sort, dict->insert_after, dict->append, dict->sort and dict->sort_by.

dict ->insert_after: after=dict_item, item=any|dict_item*

Add a dict_item object (like dict->append) after the specified item (a dict_item or key). If the second argument is @nil, the dict_item is inserted as the first item.

See also

dict->append

dict ->member: any|dict_item

Test if the argument (a dict_item object or a dict_item<-key) is member of the is dict.

Bugs: Redundant. Use dict<-member instead.

See also

dict<-member

dict ->sort: [bool|code|function], ignore_blanks=[bool], reverse=[bool]

Sort the contents of the dict. The ordering information is kept in dict<-members. There are two possibilities:

• Alphabetical sorting When the first argument is not a code object, the dict will be sorted alphabetically on the dict_item<-label. The first argument requests to compare case-insensitive. The second to ignore leading and trailing blank space and to collapse multiple blanks in the middle to a single space character. (see also string->strip).
• Sorting on a comparison function. In this case the first argument is a code object. This code object is passed pairs of dict_item objects as @arg1 and @arg2. See chain->sort for details.

  If dict<-sort_by contains a code object, this will be used as the default. See also dict<-sort_by to maintain a list of sorted objects.

  Defaults: # case-insensitive: dict.sort_ignore_case

• ignore blanks dict.sort_ignore_blanks @see dict.sort_ignore_case @see dict.sort_ignore_blanks