$chan
Indice
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
- mIRC Installation
- Virtual profile
- Playing music
- Unicode
- IPv6
- Optimization
- Threads
- DCC Protocols
- Line Lenght Limit
- Font rendering”)
The $chan identifier is filled during events which trigger on a channel.
The $chan identifier can also be used to get information regarding a specific channel the local mIRC client is in.
Contents
Synopsis
$chan[(@wid/#/N).property]Parameters
**(@wid/#/N)**The window id of the channel, a specific channel, or a channel number referencing the channel.
Properties
| Property | Description |
|---|---|
| banlist | Returns $true if mode +b has been seen already, or $false if not, or $inmode if currently in a mode +b listing. |
| cid | Returns the connection ID for the channel. |
| hwnd | Returns the operating system’s”) actual window handle”) for the channel. |
| ial | Returns $true or $false if the IAL”) has been updated for the channel. |
| ibl | Returns the same as banlist |
| iql | Returns $true or $false if the IQL”) has been updated for the channel |
| idle | Returns the amount of time the channel has been idle. This does not include entries made from the local mIRC client. |
| iel | Returns $true or $false if the local mIRC client is on the channel’s internal exempt list. |
| iil | Returns $true or $false if local mIRC client is on the channel’s internal invite list. |
| inwho | Returns $true or $false if a /who command has been performed on the channel, and the results are still being processed. |
| key | Returns the channel’s key. |
| limit | Returns the amount of users the channel is limited to. |
| logfile | Returns the location of the current channel’s log file”), if any. |
| mode | Returns the current modes set in the channel. |
| stamp | Returns $true or $false if time stamping”) is enabled on the channel. |
| status | Returns: joining, joined, or kicked. |
| topic | Returns the channel topic. |
| wid | Returns the mIRC application’s window id”) for the channel window. |
Examples
Create an alias that opens a custom @window which loads some basic information about the active channel:
alias getDetails {
if ($active ischan) {
var %c = $active
window @getDetails 350 350 650 200
clear @getDetails
echo @getDetails Channel: %c
echo @getDetails $crlf $crlf
echo @getDetails Topic: $chan(%c).topic
echo @getDetails $crlf $crlf
echo @getDetails Modes: $chan(%c).mode
echo @getDetails $crlf $crlf
echo @getDetails Key: $iif($chan(%c).key,$v1,No key set)
}
}This custom alias can now be executed using the following command in a channel command-line:
/getDetailsThe results of this command will look similar to the results below:
Compatibility
Added: mIRC v4.7
Added on: 09 Dec 1996
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.
See Also
mIRC identifier list