_lib---io.php.html 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <!-- template designed by Marco Von Ballmoos -->
  6. <title>Docs for page io.php</title>
  7. <link rel="stylesheet" href="../media/stylesheet.css" />
  8. <script src="../media/lib/classTree.js"></script>
  9. <script language="javascript" type="text/javascript">
  10. var imgPlus = new Image();
  11. var imgMinus = new Image();
  12. imgPlus.src = "../media/images/plus.png";
  13. imgMinus.src = "../media/images/minus.png";
  14. function showNode(Node){
  15. switch(navigator.family){
  16. case 'nn4':
  17. // Nav 4.x code fork...
  18. var oTable = document.layers["span" + Node];
  19. var oImg = document.layers["img" + Node];
  20. break;
  21. case 'ie4':
  22. // IE 4/5 code fork...
  23. var oTable = document.all["span" + Node];
  24. var oImg = document.all["img" + Node];
  25. break;
  26. case 'gecko':
  27. // Standards Compliant code fork...
  28. var oTable = document.getElementById("span" + Node);
  29. var oImg = document.getElementById("img" + Node);
  30. break;
  31. }
  32. oImg.src = imgMinus.src;
  33. oTable.style.display = "block";
  34. }
  35. function hideNode(Node){
  36. switch(navigator.family){
  37. case 'nn4':
  38. // Nav 4.x code fork...
  39. var oTable = document.layers["span" + Node];
  40. var oImg = document.layers["img" + Node];
  41. break;
  42. case 'ie4':
  43. // IE 4/5 code fork...
  44. var oTable = document.all["span" + Node];
  45. var oImg = document.all["img" + Node];
  46. break;
  47. case 'gecko':
  48. // Standards Compliant code fork...
  49. var oTable = document.getElementById("span" + Node);
  50. var oImg = document.getElementById("img" + Node);
  51. break;
  52. }
  53. oImg.src = imgPlus.src;
  54. oTable.style.display = "none";
  55. }
  56. function nodeIsVisible(Node){
  57. switch(navigator.family){
  58. case 'nn4':
  59. // Nav 4.x code fork...
  60. var oTable = document.layers["span" + Node];
  61. break;
  62. case 'ie4':
  63. // IE 4/5 code fork...
  64. var oTable = document.all["span" + Node];
  65. break;
  66. case 'gecko':
  67. // Standards Compliant code fork...
  68. var oTable = document.getElementById("span" + Node);
  69. break;
  70. }
  71. return (oTable && oTable.style.display == "block");
  72. }
  73. function toggleNodeVisibility(Node){
  74. if (nodeIsVisible(Node)){
  75. hideNode(Node);
  76. }else{
  77. showNode(Node);
  78. }
  79. }
  80. </script>
  81. </head>
  82. <body>
  83. <div class="page-body">
  84. <h2 class="file-name"><img src="../media/images/Page_logo.png" alt="File" style="vertical-align: middle">/lib/io.php</h2>
  85. <a name="sec-description"></a>
  86. <div class="info-box">
  87. <div class="info-box-title">Description</div>
  88. <div class="nav-bar">
  89. <span class="disabled">Description</span> |
  90. <a href="#sec-classes">Classes</a>
  91. | <a href="#sec-includes">Includes</a>
  92. | <a href="#sec-constants">Constants</a>
  93. | <a href="#sec-functions">Functions</a>
  94. </div>
  95. <div class="info-box-body">
  96. <!-- ========== Info from phpDoc block ========= -->
  97. <p class="short-description">Sloodle input/output library.</p>
  98. <p class="description"><p>Provides general request and response functionality for interacting with in-world LSL scripts.</p></p>
  99. <ul class="tags">
  100. <li><span class="field">copyright:</span> Copyright (c) 2007-8 Sloodle (various contributors)</li>
  101. <li><span class="field">contributor:</span> Peter R. Bloomfield</li>
  102. <li><span class="field">since:</span> Sloodle 0.2</li>
  103. <li><span class="field">filesource:</span> <a href="../__filesource/fsource_sloodle__libio.php.html">Source Code for this file</a></li>
  104. <li><span class="field">license:</span> <a href="http://www.gnu.org/licenses/gpl-3.0.html">GNU GPL v3</a></li>
  105. </ul>
  106. </div>
  107. </div>
  108. <a name="sec-classes"></a>
  109. <div class="info-box">
  110. <div class="info-box-title">Classes</div>
  111. <div class="nav-bar">
  112. <a href="#sec-description">Description</a> |
  113. <span class="disabled">Classes</span>
  114. | <a href="#sec-includes">Includes</a>
  115. | <a href="#sec-constants">Constants</a>
  116. | <a href="#sec-functions">Functions</a>
  117. </div>
  118. <div class="info-box-body">
  119. <table cellpadding="2" cellspacing="0" class="class-table">
  120. <tr>
  121. <th class="class-table-header">Class</th>
  122. <th class="class-table-header">Description</th>
  123. </tr>
  124. <tr>
  125. <td style="padding-right: 2em; vertical-align: top; white-space: nowrap">
  126. <img src="../media/images/Class.png"
  127. alt=" class"
  128. title=" class"/>
  129. <a href="../sloodle/SloodleResponse.html">SloodleResponse</a>
  130. </td>
  131. <td>
  132. A helper class to validate and structure data for output according to the <a href="http://slisweb.sjsu.edu/sl/index.php/Sloodle_communications_specification">Sloodle communications specification</a>.
  133. </td>
  134. </tr>
  135. <tr>
  136. <td style="padding-right: 2em; vertical-align: top; white-space: nowrap">
  137. <img src="../media/images/Class.png"
  138. alt=" class"
  139. title=" class"/>
  140. <a href="../sloodle/SloodleRequest.html">SloodleRequest</a>
  141. </td>
  142. <td>
  143. Handles incoming HTTP requests, typically from LSL if dealing with Second Life.
  144. </td>
  145. </tr>
  146. </table>
  147. </div>
  148. </div>
  149. <a name="sec-includes"></a>
  150. <div class="info-box">
  151. <div class="info-box-title">Includes</div>
  152. <div class="nav-bar">
  153. <a href="#sec-description">Description</a> |
  154. <a href="#sec-classes">Classes</a>
  155. | <span class="disabled">Includes</span>
  156. | <a href="#sec-constants">Constants</a>
  157. | <a href="#sec-functions">Functions</a>
  158. </div>
  159. <div class="info-box-body">
  160. <a name="_SLOODLE_DIRROOT_/lib/general_php"><!-- --></a>
  161. <div class="oddrow">
  162. <div>
  163. <img src="../media/images/Page.png" alt=" " />
  164. <span class="include-title">
  165. <span class="include-type">require_once</span>
  166. (<span class="include-name">SLOODLE_DIRROOT.'/lib/general.php'</span>)
  167. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a22">22</a></span>)
  168. </span>
  169. </div>
  170. <!-- ========== Info from phpDoc block ========= -->
  171. <p class="short-description">Include our general library.</p>
  172. </div>
  173. </div>
  174. </div>
  175. <a name="sec-constants"></a>
  176. <div class="info-box">
  177. <div class="info-box-title">Constants</div>
  178. <div class="nav-bar">
  179. <a href="#sec-description">Description</a> |
  180. <a href="#sec-classes">Classes</a>
  181. | <a href="#sec-includes">Includes</a>
  182. | <span class="disabled">Constants</span>
  183. | <a href="#sec-functions">Functions</a>
  184. </div>
  185. <div class="info-box-body">
  186. <a name="defineSLOODLE_PARAM_AVATAR_NAME"><!-- --></a>
  187. <div class="evenrow">
  188. <div>
  189. <img src="../media/images/Constant.png" />
  190. <span class="const-title">
  191. <span class="const-name">SLOODLE_PARAM_AVATAR_NAME</span> = 'sloodleavname'
  192. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a36">36</a></span>)
  193. </span>
  194. </div>
  195. <!-- ========== Info from phpDoc block ========= -->
  196. <p class="short-description">Defines the HTTP parameter name for an avatar name.</p>
  197. </div>
  198. <a name="defineSLOODLE_PARAM_AVATAR_UUID"><!-- --></a>
  199. <div class="oddrow">
  200. <div>
  201. <img src="../media/images/Constant.png" />
  202. <span class="const-title">
  203. <span class="const-name">SLOODLE_PARAM_AVATAR_UUID</span> = 'sloodleuuid'
  204. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a34">34</a></span>)
  205. </span>
  206. </div>
  207. <!-- ========== Info from phpDoc block ========= -->
  208. <p class="short-description">Defines the HTTP parameter name for an avatar UUID.</p>
  209. </div>
  210. <a name="defineSLOODLE_PARAM_CONTROLLER_ID"><!-- --></a>
  211. <div class="evenrow">
  212. <div>
  213. <img src="../media/images/Constant.png" />
  214. <span class="const-title">
  215. <span class="const-name">SLOODLE_PARAM_CONTROLLER_ID</span> = 'sloodlecontrollerid'
  216. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a30">30</a></span>)
  217. </span>
  218. </div>
  219. <!-- ========== Info from phpDoc block ========= -->
  220. <p class="short-description">Defines the HTTP parameter name for a Sloodle controller ID.</p>
  221. </div>
  222. <a name="defineSLOODLE_PARAM_COURSE_ID"><!-- --></a>
  223. <div class="oddrow">
  224. <div>
  225. <img src="../media/images/Constant.png" />
  226. <span class="const-title">
  227. <span class="const-name">SLOODLE_PARAM_COURSE_ID</span> = 'sloodlecourseid'
  228. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a28">28</a></span>)
  229. </span>
  230. </div>
  231. <!-- ========== Info from phpDoc block ========= -->
  232. <p class="short-description">Defines the HTTP parameter name for a course ID.</p>
  233. </div>
  234. <a name="defineSLOODLE_PARAM_IS_OBJECT"><!-- --></a>
  235. <div class="evenrow">
  236. <div>
  237. <img src="../media/images/Constant.png" />
  238. <span class="const-title">
  239. <span class="const-name">SLOODLE_PARAM_IS_OBJECT</span> = 'sloodleisobject'
  240. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a41">41</a></span>)
  241. </span>
  242. </div>
  243. <!-- ========== Info from phpDoc block ========= -->
  244. <p class="short-description">Defines the HTTP parameter name for indicating a request which relates to an object instead of a user.</p>
  245. </div>
  246. <a name="defineSLOODLE_PARAM_MODULE_ID"><!-- --></a>
  247. <div class="oddrow">
  248. <div>
  249. <img src="../media/images/Constant.png" />
  250. <span class="const-title">
  251. <span class="const-name">SLOODLE_PARAM_MODULE_ID</span> = 'sloodlemoduleid'
  252. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a32">32</a></span>)
  253. </span>
  254. </div>
  255. <!-- ========== Info from phpDoc block ========= -->
  256. <p class="short-description">Defines the HTTP parameter name for a module ID.</p>
  257. </div>
  258. <a name="defineSLOODLE_PARAM_PASSWORD"><!-- --></a>
  259. <div class="evenrow">
  260. <div>
  261. <img src="../media/images/Constant.png" />
  262. <span class="const-title">
  263. <span class="const-name">SLOODLE_PARAM_PASSWORD</span> = 'sloodlepwd'
  264. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a26">26</a></span>)
  265. </span>
  266. </div>
  267. <!-- ========== Info from phpDoc block ========= -->
  268. <p class="short-description">Defines the HTTP parameter name for a Sloodle password.</p>
  269. </div>
  270. <a name="defineSLOODLE_PARAM_REQUEST_DESC"><!-- --></a>
  271. <div class="oddrow">
  272. <div>
  273. <img src="../media/images/Constant.png" />
  274. <span class="const-title">
  275. <span class="const-name">SLOODLE_PARAM_REQUEST_DESC</span> = 'sloodlerequestdesc'
  276. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a39">39</a></span>)
  277. </span>
  278. </div>
  279. <!-- ========== Info from phpDoc block ========= -->
  280. <p class="short-description">Defines the HTTP parameter name for a request descriptor.</p>
  281. </div>
  282. <a name="defineSLOODLE_PARAM_SERVER_ACCESS_LEVEL"><!-- --></a>
  283. <div class="evenrow">
  284. <div>
  285. <img src="../media/images/Constant.png" />
  286. <span class="const-title">
  287. <span class="const-name">SLOODLE_PARAM_SERVER_ACCESS_LEVEL</span> = 'sloodleserveraccesslevel'
  288. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a43">43</a></span>)
  289. </span>
  290. </div>
  291. <!-- ========== Info from phpDoc block ========= -->
  292. <p class="short-description">Defines the HTTP parameter name for specifying server access level.</p>
  293. </div>
  294. </div>
  295. </div>
  296. <a name="sec-functions"></a>
  297. <div class="info-box">
  298. <div class="info-box-title">Functions</div>
  299. <div class="nav-bar">
  300. <a href="#sec-description">Description</a> |
  301. <a href="#sec-classes">Classes</a>
  302. | <a href="#sec-includes">Includes</a>
  303. | <a href="#sec-constants">Constants</a>
  304. | <span class="disabled">Functions</span>
  305. </div>
  306. <div class="info-box-body">
  307. <a name="functionsloodle_required_param" id="functionsloodle_required_param"><!-- --></a>
  308. <div class="oddrow">
  309. <div>
  310. <img src="../media/images/Function.png" />
  311. <span class="method-title">sloodle_required_param</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libio.php.html#a744">744</a></span>)
  312. </div>
  313. <!-- ========== Info from phpDoc block ========= -->
  314. <p class="short-description">Obtains a named HTTP request parameter, and terminates script with an error message if it was not provided.</p>
  315. <p class="description"><p>This is a 'Sloodle-friendly' version of the Moodle &quot;required_param&quot; function. Instead of terminate the script with an HTML-formatted error message, it will terminate with a message which conforms for the <a href="http://slisweb.sjsu.edu/sl/index.php/Sloodle_communications_specification">Sloodle communications specification</a>, making it suitable for use in <a href="http://slisweb.sjsu.edu/sl/index.php/Linker_Script">linker scripts</a>.</p></p>
  316. <ul class="tags">
  317. <li><span class="field">return:</span> The appropriately parsed and/or cleaned parameter value, if it was found.</li>
  318. <li><span class="field">deprecated:</span> </li>
  319. </ul>
  320. <div class="method-signature">
  321. <span class="method-result">mixed</span>
  322. <span class="method-name">
  323. sloodle_required_param
  324. </span>
  325. (<span class="var-type">string</span>&nbsp;<span class="var-name">$parname</span>, <span class="var-type">int</span>&nbsp;<span class="var-name">$type</span>)
  326. </div>
  327. <ul class="parameters">
  328. <li>
  329. <span class="var-type">string</span>
  330. <span class="var-name">$parname</span><span class="var-description">: Name of the HTTP request parameter to fetch.</span> </li>
  331. <li>
  332. <span class="var-type">int</span>
  333. <span class="var-name">$type</span><span class="var-description">: Type of parameter expected, such as &quot;PARAM_RAW&quot;. See Moodle documentation for a complete list.</span> </li>
  334. </ul>
  335. </div>
  336. </div>
  337. </div>
  338. <p class="notes" id="credit">
  339. Documentation generated on Fri, 17 Jul 2009 11:01:24 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
  340. </p>
  341. </div></body>
  342. </html>