API JoinChannelByName

Joins the specified chat channel.
 type, name = JoinChannelByName(channelName [, password, frameID, hasVoice])
==Arguments==
:;channelName: - The name of the channel to join. You can't use the "-" character in channelName.
:;password: - The channel password, nil if none.
:;frameID: - The chat frame ID number to add the channel to. Use Frame:GetID() to retrieve it for chat frame objects.
:;hasVoice: - Enable voice chat for this channel.
==Returns==
:;type: - The type of channel. 0 for a undefined channel, 1 for the zone General channel, etc
:;name: - The name of the channel. 
==Example==
local channel_type, channel_name = JoinChannelByName("Mammoth", "thesane", ChatFrame1:GetID(), 1);