wiki:Documentation/ARexxAPI/ADDRLOAD

Languages:

ADDRLOAD

NAME
AddrLoad -- Load an address book from disk. (V2.0)
TEMPLATE
FILENAME/A,OPEN/S
FUNCTION
Loads the specified address book from disk, replacing the current address book in RAM.
INPUTS
FILENAME/A - address book to be loaded
OPEN/S - immediately open the address book window after the address book file has been loaded successfully (V2.8p1)
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@example.com> Real name

or

email@example.com

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
Last modified 7 months ago Last modified on Apr 5, 2014 9:50:09 AM