Modules/bIRC/ircIsInChannel

	This function is provided by the external module Basic IRC Module. You must install this module to use this function.

This function can be used to check whether ircbot or a specified user is in a channel.

Syntax

bool ircIsInChannel ( ircbot theBot, string channel, [ string user ] )

Required Arguments

• theBot: The ircbot which presence in the channel is checked or is in the channel.
• channel: The channel which should be checked.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

• user: The name of the user whose presence in the channel you want to check. If not specified, checks if the ircbot is in the channel.

Returns

Returns true if the ircbot or specified user is in the channel, false otherwise.

Example

This example creates an ircbot called DummyBot makes it connect to a server and join a channel. It also includes an IRC command '!finduser' which can be used to check if a specified user in in the channel.

function resourceStart ( )
    theBot = ircCreateBot ( "DummyBot" )
    ircConnect ( theBot, "irc.gtanet.com", 6667 )
end
addEventHandler ( "onResourceStart", getResourceRootElement ( getThisResource() ), resourceStart )
 
function event_ircOnConnect ( theBot )
    setTimer ( ircJoinChannel, 2000, 1, theBot, "#testchannel" )
end

function event_ircOnText ( theBot, channel, sender, message )
    if message:find( "!finduser" ) then
        local user = message:sub( 11 ) -- subtract "!finduser " from the message
        if ircIsInChannel( theBot, channel, user ) then 
            ircSendMessage( theBot, channel, "Yes, " .. user .. " is here!" )
        else
            ircSendMessage( theBot, channel, "Nope, " .. user .. " isn't here!" )
        end
    end
end

See Also

Bot functions

Creation

• ircCreateBot
• ircDestroyBot

Connection

• ircConnect
• ircIsConnected
• ircRegister
• ircUnregister
• ircQuit

Other

• ircGetBotByName
• ircGetBots
• ircGetBotState
• ircGetName
• ircGetQuitMessage
• ircSetName
• ircSetQuitMessage

IRC functions

Channel

• ircGetChannelMode
• ircGetChannelTopic
• ircGetChannelUsers
• ircGetConnectedChannels
• ircJoinChannel
• ircPartChannel
• ircSetChannelMode
• ircSetChannelTopic

User

• ircGetUserHost
• ircGetUserMode
• ircIsInChannel

Communication

• ircBan
• ircInviteUser
• ircKick
• ircSendMessage
• ircSendNotice
• ircSendRaw

Other

• ircFormatHost
• ircStrip