Modules/bIRC/ircRegister
|
This function is provided by the external module Basic IRC Module. You must install this module to use this function. |
This function is used to register an ircbot for the current resource. By registering an ircbot for current resource, you are able to use the callbacks called by that bot.
Note: It is required to register your ircbot to the module if you're willing to use callbacks with other resources than the one where specified ircbot was originally created. This function is automatically executed for that specific resource when creating a new ircbot using ircCreateBot so registering a newly created ircbot within same resource is not required.
Syntax
bool ircRegister ( ircbot theBot )
Required Arguments
- theBot: The ircbot which you want to call the callbacks for current resource.
Returns
Returns true if registering callbacks was succesful, false otherwise.
Example
This example creates an ircbot called DummyBot on when resource ircecho starts. DummyBot is now able to call the callback function event_ircOnText inside resource ircecho.
Once resource ircecho2 starts, it checks if ircbot named DummyBot exists and if it does, it registers that bot's callbacks for resource ircecho2. Now DummyBot is able to call the callback function event_ircOnText also inside resource ircecho2.
function resourceStart()
theBot = ircCreateBot ( "DummyBot" )
-- ircRegister ( theBot ) is automatically executed
end
addEventHandler ( "onResourceStart", getResourceRootElement ( getThisResource() ), resourceStart )
-- This function will be called!
function event_ircOnText ( theBot, channel, sender, message )
if channel == ircGetName( theBot ) then
outputServerLog ( "[IRC-ECHO] " .. ircGetName( theBot ) .. " received PM from " .. sender .. ": " .. message )
else
outputServerLog ( "[IRC-ECHO] " .. ircGetName( theBot ) .. " received text on " .. channel .. " from " .. sender .. ": " .. message )
end
end
function resourceStart()
if ircGetBotByName ( "DummyBot" ) then
ircRegister ( ircGetBotByName ( "DummyBot" ) )
end
end
addEventHandler ( "onResourceStart", getResourceRootElement ( getThisResource() ), resourceStart )
-- This function wouldn't be called if ircRegister wasn't executed!
function event_ircOnText ( theBot, channel, sender, message )
if channel == ircGetName( theBot ) then
outputServerLog ( "[IRC-ECHO] " .. ircGetName( theBot ) .. " received PM from " .. sender .. ": " .. message )
else
outputServerLog ( "[IRC-ECHO] " .. ircGetName( theBot ) .. " received text on " .. channel .. " from " .. sender .. ": " .. message )
end
end
See Also
Bot functions
Creation
Connection
Other
IRC functions
Channel
- ircGetChannelMode
- ircGetChannelTopic
- ircGetChannelUsers
- ircGetConnectedChannels
- ircJoinChannel
- ircPartChannel
- ircSetChannelMode
- ircSetChannelTopic