[[TranslatedPages]]
[[TOC(sectionindex, heading=ARexx Function List, notitle, depth=1, Documentation/ARexxAPI/)]]
== 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
` 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::
{{{#!arexx
/* Load an address book from disk */
ADDRLOAD 'mail:addresslist'
}}}
BUGS::
SEE ALSO::