Site Tools


key
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


key [2006/08/01 04:13] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +# $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]] [[on CHANNEL_SYNC|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