$key(<channel list>)

• If the <channel list> argument is omitted, the current channel is used. THIS MAY NOT BE THE CORRECT CHANNEL IN AN /ON!
• <channel list> is taken as a word list (space separated) of channel names. The asterisk (“*”) is a special channel name that refers to the current window's current channel. THIS MAY NOT BE THE CORRECT CHANNEL IN AN /ON!
• The return value is a word list of channel keys corresponding in order to <channel list>. If a specified channel in <channel list> does not have a key, the asterisk (“*”) character will indicate that there is “no key”.
• You must be on the channel.
• Before the /ON CHANNEL_SYNC for the channel is thrown, this function may return “no key” (“*”);
• Keys are not supposed to support spaces, so we don't worry about surrounding the keys with double quotes.

This function is used to fetch a channel's key. Any number of channels may be specified, though the output could be confusing if only some actually have a key. You must be on the channel(s) specified for the function to have any effect.

A list of channel keys for a list of given channels. The “*” is used as an indicator of “no key” for the channel. There shouldn't be any error condition returned by this function.

This function first appeared in “+4” (post-ircII, pre-EPIC). Support for the default argument and for “*” first appeared in “+5”.