Site Tools


key

# $EPIC: key.txt,v 1.2 2006/08/01 03:55:07 sthalik Exp $

Synopsis:

$key(<channel list>)

Technical:

  • 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.

Practical:

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.

Returns:

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.

History:

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

key.txt · Last modified: 2006/08/01 04:13 by 127.0.0.1