wiki:Documentation/ARexxAPI/ADDRLOAD

Version 2 (modified by AmigaPhil, 7 months ago) (diff)

--

Languages:

ADDRLOAD

NAME

AddrLoad -- Load an address book from disk. (V2.0)

TEMPLATE

FILENAME/A

FUNCTION

Loads the specified address book from disk, replacing the current address book in RAM.

INPUTS

FILENAME/A - address book to be loaded

RETURNS

RC is set to 10 if the filename cannot be opened.

As of V2.4, this condition also triggers an error requester.

NOTES

Loading a new address book from disk does not count as a change in the address book itself, which means you won't be warned if you try to quit YAM after loading that file, and thus will lose the new information if you forget to save it.

As of V2.4, YAM pays attention to the contents of the supplied file. If the file is not recognised as a valid address book, a requester will open to let the user select whether he wants it to be loaded as a list of email addresses where items can be specified as

<email@…> Real name

or

email@…

because names are optional. YAM will automatically create aliases for the new items, and the command will not return until the requester is satisfied.

EXAMPLE

/* Load an address book from disk */

ADDRLOAD 'mail:addresslist'

BUGS

SEE ALSO