LibIRCClient 1.10 Used by Probotic
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.

731 lines
30KB

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
  3. <title>IRCClient: IRCClientSession Class Reference</title>
  4. <link href="doxygen.css" rel="stylesheet" type="text/css">
  5. <link href="tabs.css" rel="stylesheet" type="text/css">
  6. </head><body>
  7. <!-- Generated by Doxygen 1.5.7.1 -->
  8. <div class="navigation" id="top">
  9. <div class="tabs">
  10. <ul>
  11. <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
  12. <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
  13. <li><a href="files.html"><span>Files</span></a></li>
  14. </ul>
  15. </div>
  16. <div class="tabs">
  17. <ul>
  18. <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
  19. <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
  20. <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
  21. </ul>
  22. </div>
  23. </div>
  24. <div class="contents">
  25. <h1>IRCClientSession Class Reference</h1><!-- doxytag: class="IRCClientSession" --><!-- doxytag: inherits="NSObject" -->Represents a connected IRC Session.
  26. <a href="#_details">More...</a>
  27. <p>
  28. <code>#import &lt;<a class="el" href="_i_r_c_client_session_8h-source.html">IRCClientSession.h</a>&gt;</code>
  29. <p>
  30. <div class="dynheader">
  31. Inheritance diagram for IRCClientSession:</div>
  32. <div class="dynsection">
  33. <p><center><img src="interface_i_r_c_client_session.png" usemap="#IRCClientSession_map" border="0" alt=""></center>
  34. <map name="IRCClientSession_map">
  35. </map>
  36. </div>
  37. <p>
  38. <a href="class_i_r_c_client_session-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
  39. <tr><td></td></tr>
  40. <tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
  41. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#c9a0b7a41adeb92cf89fc53038ebc00b">connect</a></td></tr>
  42. <tr><td class="memItemLeft" nowrap align="right" valign="top">(void)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#9cb82eac49784ccafbd6cf7dd262a766">disconnect</a></td></tr>
  43. <tr><td class="memItemLeft" nowrap align="right" valign="top">(bool)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#2295d13bd62cbc7a0bd722953c3f4c64">isConnected</a></td></tr>
  44. <tr><td class="memItemLeft" nowrap align="right" valign="top">(void)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#5ba88ff09ef13c00d8b7379b30c9eced">run</a></td></tr>
  45. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#dcb54b817c20fa3c3beba65a944bca19">sendRawWithFormat:</a></td></tr>
  46. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#bfa66744f91a4408f40efaf752fe6071">quit:</a></td></tr>
  47. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#12ce6d4e08abe1ac26d0a1c0e9c5387e">join:key:</a></td></tr>
  48. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#77e26b8a7488ac2e8298fe01eb1f729c">list:</a></td></tr>
  49. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#869e09863a186b409d140c8f8161a93a">userMode:</a></td></tr>
  50. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#608235f250367bdb74c05b8caa404d11">nick:</a></td></tr>
  51. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#20ded6131f5bf067363a4701d2164907">whois:</a></td></tr>
  52. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#613d3215bf84eb7f99c088284321eb0d">message:to:</a></td></tr>
  53. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#c8c975193f7798f195d69b984aaa21fd">action:to:</a></td></tr>
  54. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#2657fa7a70ddb705819b8b176692e6a0">notice:to:</a></td></tr>
  55. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#6388c4f1f5cf3ffc14057984e29a4635">ctcpRequest:target:</a></td></tr>
  56. <tr><td class="memItemLeft" nowrap align="right" valign="top">(int)&nbsp;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_i_r_c_client_session.html#2cef231ee53c6ad6a5d9d96283084996">ctcpReply:target:</a></td></tr>
  57. <tr><td colspan="2"><br><h2>Properties</h2></td></tr>
  58. <tr><td class="memItemLeft" nowrap align="right" valign="top">id&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#ff1874c72e785b2097b9ef7ea8856557">delegate</a></td></tr>
  59. <tr><td class="memItemLeft" nowrap align="right" valign="top">irc_session_t *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#7f3f3efa9e35c82bc92d89b2f264ca88">session</a></td></tr>
  60. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSString *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#6d2142efde508caf40c8b86e7dd1756c">version</a></td></tr>
  61. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSString *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#cb1376cfad37cc503c21fa1235f39fa0">server</a></td></tr>
  62. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSString *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#f4d8a5d0747ecb6ed2f55f282582e8cf">port</a></td></tr>
  63. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSString *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#6e304e45ddb942ead5b3c044a2b09e0b">password</a></td></tr>
  64. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSString *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#4f678f5ad868a7e3d739b1e9ad415249">nickname</a></td></tr>
  65. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSString *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#281dfe78f639e87899d3aff71983484e">username</a></td></tr>
  66. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSString *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#c124ffbdf87a785981c3e330f5a90088">realname</a></td></tr>
  67. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSMutableDictionary *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#fd38f656f1f7b03495e26fe982bb9e2a">channels</a></td></tr>
  68. <tr><td class="memItemLeft" nowrap align="right" valign="top">NSStringEncoding&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="interface_i_r_c_client_session.html#2b8b240d57a57acce3186768308c667c">encoding</a></td></tr>
  69. </table>
  70. <hr><a name="_details"></a><h2>Detailed Description</h2>
  71. Represents a connected IRC Session.
  72. <p>
  73. <a class="el" href="interface_i_r_c_client_session.html" title="Represents a connected IRC Session.">IRCClientSession</a> represents a single connection to an IRC server. On initialising the object, and setting the delegate, server, port, password, nickname, username and realname properties, you call the connect: and run: methods to connect to the IRC server and start a new thread.<p>
  74. This thread then sends messages back to the main runloop to the IRC server delegate, or to the <a class="el" href="interface_i_r_c_client_channel.html" title="Represents a connected IRC Channel.">IRCClientChannel</a> delegate as required. <hr><h2>Member Function Documentation</h2>
  75. <a class="anchor" name="c8c975193f7798f195d69b984aaa21fd"></a><!-- doxytag: member="IRCClientSession::action:to:" ref="c8c975193f7798f195d69b984aaa21fd" args="(NSString *action,[to] NSString *target)" -->
  76. <div class="memitem">
  77. <div class="memproto">
  78. <table class="memname">
  79. <tr>
  80. <td class="memname">- (int) action: </td>
  81. <td></td>
  82. <td class="paramtype">(NSString *)&nbsp;</td>
  83. <td class="paramname"> <em>action</em></td>
  84. </tr>
  85. <tr>
  86. <td class="paramkey">to:</td>
  87. <td></td>
  88. <td class="paramtype">(NSString *)&nbsp;</td>
  89. <td class="paramname"> <em>target</em></td><td>&nbsp;</td>
  90. </tr>
  91. <tr>
  92. <td></td>
  93. <td></td>
  94. <td></td><td></td><td></td>
  95. </tr>
  96. </table>
  97. </div>
  98. <div class="memdoc">
  99. <p>
  100. send a CTCP ACTION to another IRC client<p>
  101. <dl compact><dt><b>Parameters:</b></dt><dd>
  102. <table border="0" cellspacing="2" cellpadding="0">
  103. <tr><td valign="top"></td><td valign="top"><em>action</em>&nbsp;</td><td>the action message to send </td></tr>
  104. <tr><td valign="top"></td><td valign="top"><em>target</em>&nbsp;</td><td>the nickname of the irc client to send the message to. </td></tr>
  105. </table>
  106. </dl>
  107. </div>
  108. </div><p>
  109. <a class="anchor" name="c9a0b7a41adeb92cf89fc53038ebc00b"></a><!-- doxytag: member="IRCClientSession::connect" ref="c9a0b7a41adeb92cf89fc53038ebc00b" args="()" -->
  110. <div class="memitem">
  111. <div class="memproto">
  112. <table class="memname">
  113. <tr>
  114. <td class="memname">- (int) connect </td>
  115. <td></td>
  116. <td class="paramname"> </td>
  117. <td>&nbsp;</td>
  118. <td></td>
  119. </tr>
  120. </table>
  121. </div>
  122. <div class="memdoc">
  123. <p>
  124. Connect to the IRC server.<p>
  125. Note that this performs the initial DNS lookup and the TCP connection, so if there are any problems you will be notified via the return code of the message.<p>
  126. Look at the libircclient documentation for the different return codes.
  127. </div>
  128. </div><p>
  129. <a class="anchor" name="2cef231ee53c6ad6a5d9d96283084996"></a><!-- doxytag: member="IRCClientSession::ctcpReply:target:" ref="2cef231ee53c6ad6a5d9d96283084996" args="(NSString *reply,[target] NSString *target)" -->
  130. <div class="memitem">
  131. <div class="memproto">
  132. <table class="memname">
  133. <tr>
  134. <td class="memname">- (int) ctcpReply: </td>
  135. <td></td>
  136. <td class="paramtype">(NSString *)&nbsp;</td>
  137. <td class="paramname"> <em>reply</em></td>
  138. </tr>
  139. <tr>
  140. <td class="paramkey">target:</td>
  141. <td></td>
  142. <td class="paramtype">(NSString *)&nbsp;</td>
  143. <td class="paramname"> <em>target</em></td><td>&nbsp;</td>
  144. </tr>
  145. <tr>
  146. <td></td>
  147. <td></td>
  148. <td></td><td></td><td></td>
  149. </tr>
  150. </table>
  151. </div>
  152. <div class="memdoc">
  153. <p>
  154. send a CTCP reply to another IRC client<p>
  155. <dl compact><dt><b>Parameters:</b></dt><dd>
  156. <table border="0" cellspacing="2" cellpadding="0">
  157. <tr><td valign="top"></td><td valign="top"><em>reply</em>&nbsp;</td><td>the CTCP reply string to send </td></tr>
  158. <tr><td valign="top"></td><td valign="top"><em>target</em>&nbsp;</td><td>the nickname of the IRC client to send the reply to. </td></tr>
  159. </table>
  160. </dl>
  161. </div>
  162. </div><p>
  163. <a class="anchor" name="6388c4f1f5cf3ffc14057984e29a4635"></a><!-- doxytag: member="IRCClientSession::ctcpRequest:target:" ref="6388c4f1f5cf3ffc14057984e29a4635" args="(NSString *request,[target] NSString *target)" -->
  164. <div class="memitem">
  165. <div class="memproto">
  166. <table class="memname">
  167. <tr>
  168. <td class="memname">- (int) ctcpRequest: </td>
  169. <td></td>
  170. <td class="paramtype">(NSString *)&nbsp;</td>
  171. <td class="paramname"> <em>request</em></td>
  172. </tr>
  173. <tr>
  174. <td class="paramkey">target:</td>
  175. <td></td>
  176. <td class="paramtype">(NSString *)&nbsp;</td>
  177. <td class="paramname"> <em>target</em></td><td>&nbsp;</td>
  178. </tr>
  179. <tr>
  180. <td></td>
  181. <td></td>
  182. <td></td><td></td><td></td>
  183. </tr>
  184. </table>
  185. </div>
  186. <div class="memdoc">
  187. <p>
  188. send a CTCP request to another IRC client<p>
  189. <dl compact><dt><b>Parameters:</b></dt><dd>
  190. <table border="0" cellspacing="2" cellpadding="0">
  191. <tr><td valign="top"></td><td valign="top"><em>request</em>&nbsp;</td><td>the CTCP request string to send </td></tr>
  192. <tr><td valign="top"></td><td valign="top"><em>target</em>&nbsp;</td><td>the nickname of the IRC client to send the request to. </td></tr>
  193. </table>
  194. </dl>
  195. </div>
  196. </div><p>
  197. <a class="anchor" name="9cb82eac49784ccafbd6cf7dd262a766"></a><!-- doxytag: member="IRCClientSession::disconnect" ref="9cb82eac49784ccafbd6cf7dd262a766" args="()" -->
  198. <div class="memitem">
  199. <div class="memproto">
  200. <table class="memname">
  201. <tr>
  202. <td class="memname">- (void) disconnect </td>
  203. <td></td>
  204. <td class="paramname"> </td>
  205. <td>&nbsp;</td>
  206. <td></td>
  207. </tr>
  208. </table>
  209. </div>
  210. <div class="memdoc">
  211. <p>
  212. Disconnect from the IRC server.<p>
  213. This always works, as it simply shuts down the socket. If you want to disconnect in a friendly way, you should use the quit: message.
  214. </div>
  215. </div><p>
  216. <a class="anchor" name="2295d13bd62cbc7a0bd722953c3f4c64"></a><!-- doxytag: member="IRCClientSession::isConnected" ref="2295d13bd62cbc7a0bd722953c3f4c64" args="()" -->
  217. <div class="memitem">
  218. <div class="memproto">
  219. <table class="memname">
  220. <tr>
  221. <td class="memname">- (bool) isConnected </td>
  222. <td></td>
  223. <td class="paramname"> </td>
  224. <td>&nbsp;</td>
  225. <td></td>
  226. </tr>
  227. </table>
  228. </div>
  229. <div class="memdoc">
  230. <p>
  231. returns YES if the server is currently connected successfully, and NO if it is not.
  232. </div>
  233. </div><p>
  234. <a class="anchor" name="12ce6d4e08abe1ac26d0a1c0e9c5387e"></a><!-- doxytag: member="IRCClientSession::join:key:" ref="12ce6d4e08abe1ac26d0a1c0e9c5387e" args="(NSString *channel,[key] NSString *key)" -->
  235. <div class="memitem">
  236. <div class="memproto">
  237. <table class="memname">
  238. <tr>
  239. <td class="memname">- (int) join: </td>
  240. <td></td>
  241. <td class="paramtype">(NSString *)&nbsp;</td>
  242. <td class="paramname"> <em>channel</em></td>
  243. </tr>
  244. <tr>
  245. <td class="paramkey">key:</td>
  246. <td></td>
  247. <td class="paramtype">(NSString *)&nbsp;</td>
  248. <td class="paramname"> <em>key</em></td><td>&nbsp;</td>
  249. </tr>
  250. <tr>
  251. <td></td>
  252. <td></td>
  253. <td></td><td></td><td></td>
  254. </tr>
  255. </table>
  256. </div>
  257. <div class="memdoc">
  258. <p>
  259. Joins a channel with a given name and key<p>
  260. <dl compact><dt><b>Parameters:</b></dt><dd>
  261. <table border="0" cellspacing="2" cellpadding="0">
  262. <tr><td valign="top"></td><td valign="top"><em>channel</em>&nbsp;</td><td>the channel to join </td></tr>
  263. <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>they key for the channel (may be nil) </td></tr>
  264. </table>
  265. </dl>
  266. </div>
  267. </div><p>
  268. <a class="anchor" name="77e26b8a7488ac2e8298fe01eb1f729c"></a><!-- doxytag: member="IRCClientSession::list:" ref="77e26b8a7488ac2e8298fe01eb1f729c" args="(NSString *channel)" -->
  269. <div class="memitem">
  270. <div class="memproto">
  271. <table class="memname">
  272. <tr>
  273. <td class="memname">- (int) list: </td>
  274. <td></td>
  275. <td class="paramtype">(NSString *)&nbsp;</td>
  276. <td class="paramname"> <em>channel</em> </td>
  277. <td>&nbsp;</td>
  278. <td></td>
  279. </tr>
  280. </table>
  281. </div>
  282. <div class="memdoc">
  283. <p>
  284. lists channels on the IRC server.<p>
  285. <dl compact><dt><b>Parameters:</b></dt><dd>
  286. <table border="0" cellspacing="2" cellpadding="0">
  287. <tr><td valign="top"></td><td valign="top"><em>channel</em>&nbsp;</td><td>a channel name or string to pass to the LIST command. Implementation specific. </td></tr>
  288. </table>
  289. </dl>
  290. </div>
  291. </div><p>
  292. <a class="anchor" name="613d3215bf84eb7f99c088284321eb0d"></a><!-- doxytag: member="IRCClientSession::message:to:" ref="613d3215bf84eb7f99c088284321eb0d" args="(NSString *message,[to] NSString *target)" -->
  293. <div class="memitem">
  294. <div class="memproto">
  295. <table class="memname">
  296. <tr>
  297. <td class="memname">- (int) message: </td>
  298. <td></td>
  299. <td class="paramtype">(NSString *)&nbsp;</td>
  300. <td class="paramname"> <em>message</em></td>
  301. </tr>
  302. <tr>
  303. <td class="paramkey">to:</td>
  304. <td></td>
  305. <td class="paramtype">(NSString *)&nbsp;</td>
  306. <td class="paramname"> <em>target</em></td><td>&nbsp;</td>
  307. </tr>
  308. <tr>
  309. <td></td>
  310. <td></td>
  311. <td></td><td></td><td></td>
  312. </tr>
  313. </table>
  314. </div>
  315. <div class="memdoc">
  316. <p>
  317. send a PRIVMSG to another IRC client<p>
  318. <dl compact><dt><b>Parameters:</b></dt><dd>
  319. <table border="0" cellspacing="2" cellpadding="0">
  320. <tr><td valign="top"></td><td valign="top"><em>message</em>&nbsp;</td><td>message to send </td></tr>
  321. <tr><td valign="top"></td><td valign="top"><em>target</em>&nbsp;</td><td>the other IRC client to send the message to. </td></tr>
  322. </table>
  323. </dl>
  324. </div>
  325. </div><p>
  326. <a class="anchor" name="608235f250367bdb74c05b8caa404d11"></a><!-- doxytag: member="IRCClientSession::nick:" ref="608235f250367bdb74c05b8caa404d11" args="(NSString *newnick)" -->
  327. <div class="memitem">
  328. <div class="memproto">
  329. <table class="memname">
  330. <tr>
  331. <td class="memname">- (int) nick: </td>
  332. <td></td>
  333. <td class="paramtype">(NSString *)&nbsp;</td>
  334. <td class="paramname"> <em>newnick</em> </td>
  335. <td>&nbsp;</td>
  336. <td></td>
  337. </tr>
  338. </table>
  339. </div>
  340. <div class="memdoc">
  341. <p>
  342. sets the IRC client nickname. On success, an onNick event will be sent to the delegate<p>
  343. <dl compact><dt><b>Parameters:</b></dt><dd>
  344. <table border="0" cellspacing="2" cellpadding="0">
  345. <tr><td valign="top"></td><td valign="top"><em>newnick</em>&nbsp;</td><td>new nickname to set. </td></tr>
  346. </table>
  347. </dl>
  348. </div>
  349. </div><p>
  350. <a class="anchor" name="2657fa7a70ddb705819b8b176692e6a0"></a><!-- doxytag: member="IRCClientSession::notice:to:" ref="2657fa7a70ddb705819b8b176692e6a0" args="(NSString *notice,[to] NSString *target)" -->
  351. <div class="memitem">
  352. <div class="memproto">
  353. <table class="memname">
  354. <tr>
  355. <td class="memname">- (int) notice: </td>
  356. <td></td>
  357. <td class="paramtype">(NSString *)&nbsp;</td>
  358. <td class="paramname"> <em>notice</em></td>
  359. </tr>
  360. <tr>
  361. <td class="paramkey">to:</td>
  362. <td></td>
  363. <td class="paramtype">(NSString *)&nbsp;</td>
  364. <td class="paramname"> <em>target</em></td><td>&nbsp;</td>
  365. </tr>
  366. <tr>
  367. <td></td>
  368. <td></td>
  369. <td></td><td></td><td></td>
  370. </tr>
  371. </table>
  372. </div>
  373. <div class="memdoc">
  374. <p>
  375. send a NOTICE to another IRC client<p>
  376. <dl compact><dt><b>Parameters:</b></dt><dd>
  377. <table border="0" cellspacing="2" cellpadding="0">
  378. <tr><td valign="top"></td><td valign="top"><em>notice</em>&nbsp;</td><td>the message text to send </td></tr>
  379. <tr><td valign="top"></td><td valign="top"><em>target</em>&nbsp;</td><td>the nickname of the irc client to send the notice to. </td></tr>
  380. </table>
  381. </dl>
  382. </div>
  383. </div><p>
  384. <a class="anchor" name="bfa66744f91a4408f40efaf752fe6071"></a><!-- doxytag: member="IRCClientSession::quit:" ref="bfa66744f91a4408f40efaf752fe6071" args="(NSString *reason)" -->
  385. <div class="memitem">
  386. <div class="memproto">
  387. <table class="memname">
  388. <tr>
  389. <td class="memname">- (int) quit: </td>
  390. <td></td>
  391. <td class="paramtype">(NSString *)&nbsp;</td>
  392. <td class="paramname"> <em>reason</em> </td>
  393. <td>&nbsp;</td>
  394. <td></td>
  395. </tr>
  396. </table>
  397. </div>
  398. <div class="memdoc">
  399. <p>
  400. quits the IRC server with the given reason. On success, an onQuit event will be sent to the <a class="el" href="protocol_i_r_c_client_session_delegate-p.html">IRCClientSessionDelegate</a> with the nickname of the IRC client.<p>
  401. The format is a standard NSString format string, followed by optional arguments.
  402. </div>
  403. </div><p>
  404. <a class="anchor" name="5ba88ff09ef13c00d8b7379b30c9eced"></a><!-- doxytag: member="IRCClientSession::run" ref="5ba88ff09ef13c00d8b7379b30c9eced" args="()" -->
  405. <div class="memitem">
  406. <div class="memproto">
  407. <table class="memname">
  408. <tr>
  409. <td class="memname">- (void) run </td>
  410. <td></td>
  411. <td class="paramname"> </td>
  412. <td>&nbsp;</td>
  413. <td></td>
  414. </tr>
  415. </table>
  416. </div>
  417. <div class="memdoc">
  418. <p>
  419. Starts a new thread and starts the libircclient runloop, processing events and firing messages back to the main runloop as required. Calling this again will do nothing other than raise a warning in your logs.
  420. </div>
  421. </div><p>
  422. <a class="anchor" name="dcb54b817c20fa3c3beba65a944bca19"></a><!-- doxytag: member="IRCClientSession::sendRawWithFormat:" ref="dcb54b817c20fa3c3beba65a944bca19" args="(NSString *format,[,]...)" -->
  423. <div class="memitem">
  424. <div class="memproto">
  425. <table class="memname">
  426. <tr>
  427. <td class="memname">- (int) sendRawWithFormat: </td>
  428. <td></td>
  429. <td class="paramtype">(NSString *)&nbsp;</td>
  430. <td class="paramname"> <em>format</em></td>
  431. </tr>
  432. <tr>
  433. <td class="paramkey">,</td>
  434. <td></td>
  435. <td class="paramtype">&nbsp;</td>
  436. <td class="paramname"> <em>...</em></td><td>&nbsp;</td>
  437. </tr>
  438. <tr>
  439. <td></td>
  440. <td></td>
  441. <td></td><td></td><td></td>
  442. </tr>
  443. </table>
  444. </div>
  445. <div class="memdoc">
  446. <p>
  447. Sends a raw message to the IRC server. Please consult rfc1459 for the format of IRC commands.
  448. </div>
  449. </div><p>
  450. <a class="anchor" name="869e09863a186b409d140c8f8161a93a"></a><!-- doxytag: member="IRCClientSession::userMode:" ref="869e09863a186b409d140c8f8161a93a" args="(NSString *mode)" -->
  451. <div class="memitem">
  452. <div class="memproto">
  453. <table class="memname">
  454. <tr>
  455. <td class="memname">- (int) userMode: </td>
  456. <td></td>
  457. <td class="paramtype">(NSString *)&nbsp;</td>
  458. <td class="paramname"> <em>mode</em> </td>
  459. <td>&nbsp;</td>
  460. <td></td>
  461. </tr>
  462. </table>
  463. </div>
  464. <div class="memdoc">
  465. <p>
  466. sets the user mode for the IRC client<p>
  467. <dl compact><dt><b>Parameters:</b></dt><dd>
  468. <table border="0" cellspacing="2" cellpadding="0">
  469. <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>string to set </td></tr>
  470. </table>
  471. </dl>
  472. </div>
  473. </div><p>
  474. <a class="anchor" name="20ded6131f5bf067363a4701d2164907"></a><!-- doxytag: member="IRCClientSession::whois:" ref="20ded6131f5bf067363a4701d2164907" args="(NSString *nick)" -->
  475. <div class="memitem">
  476. <div class="memproto">
  477. <table class="memname">
  478. <tr>
  479. <td class="memname">- (int) whois: </td>
  480. <td></td>
  481. <td class="paramtype">(NSString *)&nbsp;</td>
  482. <td class="paramname"> <em>nick</em> </td>
  483. <td>&nbsp;</td>
  484. <td></td>
  485. </tr>
  486. </table>
  487. </div>
  488. <div class="memdoc">
  489. <p>
  490. sends a WHOIS request to the IRC server<p>
  491. <dl compact><dt><b>Parameters:</b></dt><dd>
  492. <table border="0" cellspacing="2" cellpadding="0">
  493. <tr><td valign="top"></td><td valign="top"><em>nick</em>&nbsp;</td><td>nickname of the irc client to whois. </td></tr>
  494. </table>
  495. </dl>
  496. </div>
  497. </div><p>
  498. <hr><h2>Property Documentation</h2>
  499. <a class="anchor" name="fd38f656f1f7b03495e26fe982bb9e2a"></a><!-- doxytag: member="IRCClientSession::channels" ref="fd38f656f1f7b03495e26fe982bb9e2a" args="" -->
  500. <div class="memitem">
  501. <div class="memproto">
  502. <table class="memname">
  503. <tr>
  504. <td class="memname">- (NSMutableDictionary *) channels<code> [read, assign]</code> </td>
  505. </tr>
  506. </table>
  507. </div>
  508. <div class="memdoc">
  509. <p>
  510. An NSMutableDictionary of channels that the client is currently connected to.<p>
  511. You should not modify this.
  512. </div>
  513. </div><p>
  514. <a class="anchor" name="ff1874c72e785b2097b9ef7ea8856557"></a><!-- doxytag: member="IRCClientSession::delegate" ref="ff1874c72e785b2097b9ef7ea8856557" args="" -->
  515. <div class="memitem">
  516. <div class="memproto">
  517. <table class="memname">
  518. <tr>
  519. <td class="memname">- (id) delegate<code> [read, write, assign]</code> </td>
  520. </tr>
  521. </table>
  522. </div>
  523. <div class="memdoc">
  524. <p>
  525. delegate to send events to.
  526. </div>
  527. </div><p>
  528. <a class="anchor" name="2b8b240d57a57acce3186768308c667c"></a><!-- doxytag: member="IRCClientSession::encoding" ref="2b8b240d57a57acce3186768308c667c" args="" -->
  529. <div class="memitem">
  530. <div class="memproto">
  531. <table class="memname">
  532. <tr>
  533. <td class="memname">- (NSStringEncoding) encoding<code> [read, write, assign]</code> </td>
  534. </tr>
  535. </table>
  536. </div>
  537. <div class="memdoc">
  538. <p>
  539. The default text encoding for messages on this server.<p>
  540. This affects messages received via PRIVMSG and NOTICE, and TOPIC in a channel. You may change this at any time.
  541. </div>
  542. </div><p>
  543. <a class="anchor" name="4f678f5ad868a7e3d739b1e9ad415249"></a><!-- doxytag: member="IRCClientSession::nickname" ref="4f678f5ad868a7e3d739b1e9ad415249" args="" -->
  544. <div class="memitem">
  545. <div class="memproto">
  546. <table class="memname">
  547. <tr>
  548. <td class="memname">- (NSString *) nickname<code> [read, write, copy]</code> </td>
  549. </tr>
  550. </table>
  551. </div>
  552. <div class="memdoc">
  553. <p>
  554. Nickname of the connected client. Note that setting this after connection will not result in the client renaming on IRC. You need to send a nick: message instead.
  555. </div>
  556. </div><p>
  557. <a class="anchor" name="6e304e45ddb942ead5b3c044a2b09e0b"></a><!-- doxytag: member="IRCClientSession::password" ref="6e304e45ddb942ead5b3c044a2b09e0b" args="" -->
  558. <div class="memitem">
  559. <div class="memproto">
  560. <table class="memname">
  561. <tr>
  562. <td class="memname">- (NSString *) password<code> [read, write, copy]</code> </td>
  563. </tr>
  564. </table>
  565. </div>
  566. <div class="memdoc">
  567. <p>
  568. Server password to provide on connect (may be left empty or nil)
  569. </div>
  570. </div><p>
  571. <a class="anchor" name="f4d8a5d0747ecb6ed2f55f282582e8cf"></a><!-- doxytag: member="IRCClientSession::port" ref="f4d8a5d0747ecb6ed2f55f282582e8cf" args="" -->
  572. <div class="memitem">
  573. <div class="memproto">
  574. <table class="memname">
  575. <tr>
  576. <td class="memname">- (NSString *) port<code> [read, write, copy]</code> </td>
  577. </tr>
  578. </table>
  579. </div>
  580. <div class="memdoc">
  581. <p>
  582. IRC port to connect to
  583. </div>
  584. </div><p>
  585. <a class="anchor" name="c124ffbdf87a785981c3e330f5a90088"></a><!-- doxytag: member="IRCClientSession::realname" ref="c124ffbdf87a785981c3e330f5a90088" args="" -->
  586. <div class="memitem">
  587. <div class="memproto">
  588. <table class="memname">
  589. <tr>
  590. <td class="memname">- (NSString *) realname<code> [read, write, copy]</code> </td>
  591. </tr>
  592. </table>
  593. </div>
  594. <div class="memdoc">
  595. <p>
  596. Realname of the connected client.<p>
  597. Setting this after connection does nothing.
  598. </div>
  599. </div><p>
  600. <a class="anchor" name="cb1376cfad37cc503c21fa1235f39fa0"></a><!-- doxytag: member="IRCClientSession::server" ref="cb1376cfad37cc503c21fa1235f39fa0" args="" -->
  601. <div class="memitem">
  602. <div class="memproto">
  603. <table class="memname">
  604. <tr>
  605. <td class="memname">- (NSString *) server<code> [read, write, copy]</code> </td>
  606. </tr>
  607. </table>
  608. </div>
  609. <div class="memdoc">
  610. <p>
  611. IRC server to connect to
  612. </div>
  613. </div><p>
  614. <a class="anchor" name="7f3f3efa9e35c82bc92d89b2f264ca88"></a><!-- doxytag: member="IRCClientSession::session" ref="7f3f3efa9e35c82bc92d89b2f264ca88" args="" -->
  615. <div class="memitem">
  616. <div class="memproto">
  617. <table class="memname">
  618. <tr>
  619. <td class="memname">- (irc_session_t *) session<code> [read, write, assign]</code> </td>
  620. </tr>
  621. </table>
  622. </div>
  623. <div class="memdoc">
  624. <p>
  625. The underlying libircclient handle
  626. </div>
  627. </div><p>
  628. <a class="anchor" name="281dfe78f639e87899d3aff71983484e"></a><!-- doxytag: member="IRCClientSession::username" ref="281dfe78f639e87899d3aff71983484e" args="" -->
  629. <div class="memitem">
  630. <div class="memproto">
  631. <table class="memname">
  632. <tr>
  633. <td class="memname">- (NSString *) username<code> [read, write, copy]</code> </td>
  634. </tr>
  635. </table>
  636. </div>
  637. <div class="memdoc">
  638. <p>
  639. Username of the connected client. Also known as the ident.<p>
  640. Setting this after connection does nothing.
  641. </div>
  642. </div><p>
  643. <a class="anchor" name="6d2142efde508caf40c8b86e7dd1756c"></a><!-- doxytag: member="IRCClientSession::version" ref="6d2142efde508caf40c8b86e7dd1756c" args="" -->
  644. <div class="memitem">
  645. <div class="memproto">
  646. <table class="memname">
  647. <tr>
  648. <td class="memname">- (NSString *) version<code> [read, write, copy]</code> </td>
  649. </tr>
  650. </table>
  651. </div>
  652. <div class="memdoc">
  653. <p>
  654. The version string for the client to send back on CTCP VERSION requests
  655. </div>
  656. </div><p>
  657. <hr>The documentation for this class was generated from the following files:<ul>
  658. <li><a class="el" href="_i_r_c_client_session_8h-source.html">IRCClientSession.h</a><li>IRCClientSession.m</ul>
  659. </div>
  660. <hr size="1"><address style="text-align: right;"><small>Generated on Sat Jan 10 18:10:37 2009 for IRCClient by&nbsp;
  661. <a href="http://www.doxygen.org/index.html">
  662. <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.7.1 </small></address>
  663. </body>
  664. </html>