SloodleLSLResponse.html 50 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219
  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 Class SloodleLSLResponse</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="class-name"><img src="../media/images/Class_logo.png"
  85. alt=" Class"
  86. title=" Class"
  87. style="vertical-align: middle"> SloodleLSLResponse</h2>
  88. <a name="sec-description"></a>
  89. <div class="info-box">
  90. <div class="info-box-title">Description</div>
  91. <div class="nav-bar">
  92. <span class="disabled">Description</span> |
  93. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  94. | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  95. </div>
  96. <div class="info-box-body">
  97. <!-- ========== Info from phpDoc block ========= -->
  98. <p class="short-description">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>.</p>
  99. <ul class="tags">
  100. <li><span class="field">usedby:</span> <a href="../sloodle/SloodleLSLRequest.html">SloodleLSLRequest</a> - Outputs error messages in appropriate format if an error occurs.</li>
  101. </ul>
  102. <p class="notes">
  103. Located in <a class="field" href="_lib---sl_iolib.php.html">/lib/sl_iolib.php</a> (line <span class="field"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a41">41</a></span>)
  104. </p>
  105. <pre></pre>
  106. </div>
  107. </div>
  108. <a name="sec-var-summary"></a>
  109. <div class="info-box">
  110. <div class="info-box-title">Variable Summary</span></div>
  111. <div class="nav-bar">
  112. <a href="#sec-description">Description</a> |
  113. <span class="disabled">Vars</span> (<a href="#sec-vars">details</a>)
  114. |
  115. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  116. </div>
  117. <div class="info-box-body">
  118. <div class="var-summary">
  119. <div class="var-title">
  120. <img src="../media/images/PrivateVariable.png" alt=" " />
  121. <span class="var-type">mixed</span>
  122. <a href="#$data" title="details" class="var-name">$data</a>
  123. </div>
  124. <div class="var-title">
  125. <img src="../media/images/PrivateVariable.png" alt=" " />
  126. <span class="var-type">integer</span>
  127. <a href="#$page_number" title="details" class="var-name">$page_number</a>
  128. </div>
  129. <div class="var-title">
  130. <img src="../media/images/PrivateVariable.png" alt=" " />
  131. <span class="var-type">integer</span>
  132. <a href="#$page_total" title="details" class="var-name">$page_total</a>
  133. </div>
  134. <div class="var-title">
  135. <img src="../media/images/PrivateVariable.png" alt=" " />
  136. <span class="var-type">string</span>
  137. <a href="#$request_descriptor" title="details" class="var-name">$request_descriptor</a>
  138. </div>
  139. <div class="var-title">
  140. <img src="../media/images/PrivateVariable.png" alt=" " />
  141. <span class="var-type">integer</span>
  142. <a href="#$request_timestamp" title="details" class="var-name">$request_timestamp</a>
  143. </div>
  144. <div class="var-title">
  145. <img src="../media/images/PrivateVariable.png" alt=" " />
  146. <span class="var-type">integer</span>
  147. <a href="#$response_timestamp" title="details" class="var-name">$response_timestamp</a>
  148. </div>
  149. <div class="var-title">
  150. <img src="../media/images/PrivateVariable.png" alt=" " />
  151. <span class="var-type">mixed</span>
  152. <a href="#$side_effects" title="details" class="var-name">$side_effects</a>
  153. </div>
  154. <div class="var-title">
  155. <img src="../media/images/PrivateVariable.png" alt=" " />
  156. <span class="var-type">int</span>
  157. <a href="#$status_code" title="details" class="var-name">$status_code</a>
  158. </div>
  159. <div class="var-title">
  160. <img src="../media/images/PrivateVariable.png" alt=" " />
  161. <span class="var-type">string</span>
  162. <a href="#$status_descriptor" title="details" class="var-name">$status_descriptor</a>
  163. </div>
  164. <div class="var-title">
  165. <img src="../media/images/PrivateVariable.png" alt=" " />
  166. <span class="var-type">mixed</span>
  167. <a href="#$tracking_code" title="details" class="var-name">$tracking_code</a>
  168. </div>
  169. <div class="var-title">
  170. <img src="../media/images/PrivateVariable.png" alt=" " />
  171. <span class="var-type">string</span>
  172. <a href="#$user_key" title="details" class="var-name">$user_key</a>
  173. </div>
  174. </div>
  175. </div>
  176. </div>
  177. <a name="sec-method-summary"></a>
  178. <div class="info-box">
  179. <div class="info-box-title">Method Summary</span></div>
  180. <div class="nav-bar">
  181. <a href="#sec-description">Description</a> |
  182. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  183. |
  184. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  185. </div>
  186. <div class="info-box-body">
  187. <div class="method-summary">
  188. <div class="method-definition">
  189. <img src="../media/images/Constructor.png" alt=" "/>
  190. <span class="method-result">void</span>
  191. <a href="#SloodleLSLResponse" title="details" class="method-name">SloodleLSLResponse</a>
  192. ([<span class="var-type">int</span>&nbsp;<span class="var-name">$status_code</span> = <span class="var-default">NULL</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$status_descriptor</span> = <span class="var-default">NULL</span>], [<span class="var-type">mixed</span>&nbsp;<span class="var-name">$data</span> = <span class="var-default">NULL</span>])
  193. </div>
  194. <div class="method-definition">
  195. <img src="../media/images/Method.png" alt=" "/>
  196. <span class="method-result">void</span>
  197. <a href="#add_data_line" title="details" class="method-name">add_data_line</a>
  198. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  199. </div>
  200. <div class="method-definition">
  201. <img src="../media/images/Method.png" alt=" "/>
  202. <span class="method-result">void</span>
  203. <a href="#add_side_effect" title="details" class="method-name">add_side_effect</a>
  204. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  205. </div>
  206. <div class="method-definition">
  207. <img src="../media/images/Method.png" alt=" "/>
  208. <span class="method-result">void</span>
  209. <a href="#add_side_effects" title="details" class="method-name">add_side_effects</a>
  210. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  211. </div>
  212. <div class="method-definition">
  213. <img src="../media/images/Method.png" alt=" "/>
  214. <span class="method-result">void</span>
  215. <a href="#clear_data" title="details" class="method-name">clear_data</a>
  216. ()
  217. </div>
  218. <div class="method-definition">
  219. <img src="../media/images/Method.png" alt=" "/>
  220. <span class="method-result">void</span>
  221. <a href="#quick_output" title="details" class="method-name">quick_output</a>
  222. (<span class="var-type">int</span>&nbsp;<span class="var-name">$status_code</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$status_descriptor</span> = <span class="var-default">NULL</span>], [<span class="var-type">mixed</span>&nbsp;<span class="var-name">$data</span> = <span class="var-default">NULL</span>], [<span class="var-type">bool</span>&nbsp;<span class="var-name">$static</span> = <span class="var-default">TRUE</span>])
  223. </div>
  224. <div class="method-definition">
  225. <img src="../media/images/Method.png" alt=" "/>
  226. <span class="method-result">void</span>
  227. <a href="#render_to_output" title="details" class="method-name">render_to_output</a>
  228. ()
  229. </div>
  230. <div class="method-definition">
  231. <img src="../media/images/Method.png" alt=" "/>
  232. <span class="method-result">void</span>
  233. <a href="#render_to_string" title="details" class="method-name">render_to_string</a>
  234. (<span class="var-type">string</span>&nbsp;<span class="var-name">&$str</span>)
  235. </div>
  236. <div class="method-definition">
  237. <img src="../media/images/Method.png" alt=" "/>
  238. <span class="method-result">void</span>
  239. <a href="#set_data" title="details" class="method-name">set_data</a>
  240. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  241. </div>
  242. <div class="method-definition">
  243. <img src="../media/images/Method.png" alt=" "/>
  244. <span class="method-result">void</span>
  245. <a href="#set_page_number" title="details" class="method-name">set_page_number</a>
  246. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  247. </div>
  248. <div class="method-definition">
  249. <img src="../media/images/Method.png" alt=" "/>
  250. <span class="method-result">void</span>
  251. <a href="#set_page_total" title="details" class="method-name">set_page_total</a>
  252. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  253. </div>
  254. <div class="method-definition">
  255. <img src="../media/images/Method.png" alt=" "/>
  256. <span class="method-result">void</span>
  257. <a href="#set_request_descriptor" title="details" class="method-name">set_request_descriptor</a>
  258. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  259. </div>
  260. <div class="method-definition">
  261. <img src="../media/images/Method.png" alt=" "/>
  262. <span class="method-result">void</span>
  263. <a href="#set_request_timestamp" title="details" class="method-name">set_request_timestamp</a>
  264. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  265. </div>
  266. <div class="method-definition">
  267. <img src="../media/images/Method.png" alt=" "/>
  268. <span class="method-result">void</span>
  269. <a href="#set_response_timestamp" title="details" class="method-name">set_response_timestamp</a>
  270. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  271. </div>
  272. <div class="method-definition">
  273. <img src="../media/images/Method.png" alt=" "/>
  274. <span class="method-result">void</span>
  275. <a href="#set_side_effects" title="details" class="method-name">set_side_effects</a>
  276. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  277. </div>
  278. <div class="method-definition">
  279. <img src="../media/images/Method.png" alt=" "/>
  280. <span class="method-result">void</span>
  281. <a href="#set_status_code" title="details" class="method-name">set_status_code</a>
  282. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  283. </div>
  284. <div class="method-definition">
  285. <img src="../media/images/Method.png" alt=" "/>
  286. <span class="method-result">void</span>
  287. <a href="#set_status_descriptor" title="details" class="method-name">set_status_descriptor</a>
  288. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  289. </div>
  290. <div class="method-definition">
  291. <img src="../media/images/Method.png" alt=" "/>
  292. <span class="method-result">void</span>
  293. <a href="#set_tracking_code" title="details" class="method-name">set_tracking_code</a>
  294. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  295. </div>
  296. <div class="method-definition">
  297. <img src="../media/images/Method.png" alt=" "/>
  298. <span class="method-result">void</span>
  299. <a href="#set_user_key" title="details" class="method-name">set_user_key</a>
  300. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  301. </div>
  302. <div class="method-definition">
  303. <img src="../media/images/PrivateMethod.png" alt=" "/>
  304. <span class="method-result">void</span>
  305. <a href="#_internal_validation_error" title="details" class="method-name">_internal_validation_error</a>
  306. (<span class="var-type">string</span>&nbsp;<span class="var-name">$msg</span>)
  307. </div>
  308. </div>
  309. </div>
  310. </div>
  311. <a name="sec-vars"></a>
  312. <div class="info-box">
  313. <div class="info-box-title">Variables</div>
  314. <div class="nav-bar">
  315. <a href="#sec-description">Description</a> |
  316. <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
  317. |
  318. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  319. </div>
  320. <div class="info-box-body">
  321. <a name="var$data" id="$data"><!-- --></A>
  322. <div class="oddrow">
  323. <div class="var-header">
  324. <img src="../media/images/PrivateVariable.png" />
  325. <span class="var-title">
  326. <span class="var-type">mixed</span>
  327. <span class="var-name">$data</span>
  328. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a156">156</a></span>)
  329. </span>
  330. </div>
  331. <!-- ========== Info from phpDoc block ========= -->
  332. <p class="short-description">Data to render following the status line in the response.</p>
  333. <p class="description"><p>This value can either be a scalar (single value, e.g. int, string, float), or an array. If it is a single scalar, it is rendered as a single line. If it is an array, then each element becomes one line. If an element is a scalar, then it is directly output onto the line. If an element is an array, then each child element is output as a separate field on the same line. <strong>Optional. Ignored if NULL.</strong></p></p>
  334. <ul class="tags">
  335. <li><span class="field">see:</span> <a href="../sloodle/SloodleLSLResponse.html#methodclear_data">SloodleLSLResponse::clear_data()</a></li>
  336. <li><span class="field">see:</span> <a href="../sloodle/SloodleLSLResponse.html#methodadd_data_line">SloodleLSLResponse::add_data_line()</a></li>
  337. <li><span class="field">see:</span> <a href="../sloodle/SloodleLSLResponse.html#methodset_data">SloodleLSLResponse::set_data()</a></li>
  338. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_iolib.php.html#defineSLOODLE_LINE_SEPARATOR">SLOODLE_LINE_SEPARATOR</a></li>
  339. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_iolib.php.html#defineSLOODLE_FIELD_SEPARATOR">SLOODLE_FIELD_SEPARATOR</a></li>
  340. <li><span class="field">access:</span> private</li>
  341. </ul>
  342. </div>
  343. <a name="var$page_number" id="$page_number"><!-- --></A>
  344. <div class="evenrow">
  345. <div class="var-header">
  346. <img src="../media/images/PrivateVariable.png" />
  347. <span class="var-title">
  348. <span class="var-type">integer</span>
  349. <span class="var-name">$page_number</span>
  350. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a138">138</a></span>)
  351. </span>
  352. </div>
  353. <!-- ========== Info from phpDoc block ========= -->
  354. <p class="short-description">Current page number.</p>
  355. <p class="description"><p>If a response requires multiple pages, this value indicates which page is being returned in this response. <strong>Optional, unless $page_total is specified. Ignored if NULL.</strong> <em>Not yet supported.</em></p></p>
  356. <ul class="tags">
  357. <li><span class="field">access:</span> private</li>
  358. </ul>
  359. </div>
  360. <a name="var$page_total" id="$page_total"><!-- --></A>
  361. <div class="oddrow">
  362. <div class="var-header">
  363. <img src="../media/images/PrivateVariable.png" />
  364. <span class="var-title">
  365. <span class="var-type">integer</span>
  366. <span class="var-name">$page_total</span>
  367. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a129">129</a></span>)
  368. </span>
  369. </div>
  370. <!-- ========== Info from phpDoc block ========= -->
  371. <p class="short-description">Total number of pages.</p>
  372. <p class="description"><p>If a response requires multiple pages, this value indicates how many pages there are. <strong>Optional, unless $page_number is specified. Ignored if NULL.</strong> <em>Not yet supported.</em></p></p>
  373. <ul class="tags">
  374. <li><span class="field">access:</span> private</li>
  375. </ul>
  376. </div>
  377. <a name="var$request_descriptor" id="$request_descriptor"><!-- --></A>
  378. <div class="evenrow">
  379. <div class="var-header">
  380. <img src="../media/images/PrivateVariable.png" />
  381. <span class="var-title">
  382. <span class="var-type">string</span>
  383. <span class="var-name">$request_descriptor</span>
  384. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a81">81</a></span>)
  385. </span>
  386. </div>
  387. <!-- ========== Info from phpDoc block ========= -->
  388. <p class="short-description">Request descriptor.</p>
  389. <p class="description"><p>A brief string passed into the request by an LSL script (via HTTP parameter 'sloodlerequestdesc'), which is returned so that it can correctly distinguish one request from anotehr. <strong>Optional. Ignored if NULL.</strong></p></p>
  390. <ul class="tags">
  391. <li><span class="field">access:</span> private</li>
  392. </ul>
  393. </div>
  394. <a name="var$request_timestamp" id="$request_timestamp"><!-- --></A>
  395. <div class="oddrow">
  396. <div class="var-header">
  397. <img src="../media/images/PrivateVariable.png" />
  398. <span class="var-title">
  399. <span class="var-type">integer</span>
  400. <span class="var-name">$request_timestamp</span>
  401. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a90">90</a></span>)
  402. </span>
  403. </div>
  404. <!-- ========== Info from phpDoc block ========= -->
  405. <p class="short-description">Timestamp when the request was originally made by the LSL script.</p>
  406. <p class="description"><p>This is <em>not</em> filled-in automatically. You must do it manually if you need it. <strong>Optional. Ignored if NULL.</strong></p></p>
  407. <ul class="tags">
  408. <li><span class="field">access:</span> private</li>
  409. </ul>
  410. </div>
  411. <a name="var$response_timestamp" id="$response_timestamp"><!-- --></A>
  412. <div class="evenrow">
  413. <div class="var-header">
  414. <img src="../media/images/PrivateVariable.png" />
  415. <span class="var-title">
  416. <span class="var-type">integer</span>
  417. <span class="var-name">$response_timestamp</span>
  418. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a99">99</a></span>)
  419. </span>
  420. </div>
  421. <!-- ========== Info from phpDoc block ========= -->
  422. <p class="short-description">Timestamp when the response was generated on the Moodle site.</p>
  423. <p class="description"><p>This is <em>not</em> filled-in automatically. You must do it manually if you need it. <strong>Optional. Ignored if NULL.</strong></p></p>
  424. <ul class="tags">
  425. <li><span class="field">access:</span> private</li>
  426. </ul>
  427. </div>
  428. <a name="var$side_effects" id="$side_effects"><!-- --></A>
  429. <div class="oddrow">
  430. <div class="var-header">
  431. <img src="../media/images/PrivateVariable.png" />
  432. <span class="var-title">
  433. <span class="var-type">mixed</span>
  434. <span class="var-name">$side_effects</span>
  435. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a71">71</a></span>)
  436. </span>
  437. </div>
  438. <!-- ========== Info from phpDoc block ========= -->
  439. <p class="short-description">Integer side effect(s) codes.</p>
  440. <p class="description"><p>Status code(s) of side effect(s) incurred during the operation. Can be a single integer, or an array of integers. <strong>Optional. Ignored if NULL.</strong></p></p>
  441. <ul class="tags">
  442. <li><span class="field">access:</span> private</li>
  443. </ul>
  444. </div>
  445. <a name="var$status_code" id="$status_code"><!-- --></A>
  446. <div class="evenrow">
  447. <div class="var-header">
  448. <img src="../media/images/PrivateVariable.png" />
  449. <span class="var-title">
  450. <span class="var-type">int</span>
  451. <span class="var-name">$status_code</span>
  452. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a52">52</a></span>)
  453. </span>
  454. </div>
  455. <!-- ========== Info from phpDoc block ========= -->
  456. <p class="short-description">Integer status code of the response.</p>
  457. <p class="description"><p>Refer to the <a href="http://slisweb.sjsu.edu/sl/index.php/Sloodle_status_codes">status codes</a> page on the Sloodle wiki for a reference. <strong>Required.</strong></p></p>
  458. <ul class="tags">
  459. <li><span class="field">access:</span> private</li>
  460. </ul>
  461. </div>
  462. <a name="var$status_descriptor" id="$status_descriptor"><!-- --></A>
  463. <div class="oddrow">
  464. <div class="var-header">
  465. <img src="../media/images/PrivateVariable.png" />
  466. <span class="var-title">
  467. <span class="var-type">string</span>
  468. <span class="var-name">$status_descriptor</span>
  469. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a61">61</a></span>)
  470. </span>
  471. </div>
  472. <!-- ========== Info from phpDoc block ========= -->
  473. <p class="short-description">Status descriptor string.</p>
  474. <p class="description"><p>Should contain a generalised description/category of the status code. <strong>Optional but recommended. Ignored if NULL.</strong></p></p>
  475. <ul class="tags">
  476. <li><span class="field">access:</span> private</li>
  477. </ul>
  478. </div>
  479. <a name="var$tracking_code" id="$tracking_code"><!-- --></A>
  480. <div class="evenrow">
  481. <div class="var-header">
  482. <img src="../media/images/PrivateVariable.png" />
  483. <span class="var-title">
  484. <span class="var-type">mixed</span>
  485. <span class="var-name">$tracking_code</span>
  486. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a120">120</a></span>)
  487. </span>
  488. </div>
  489. <!-- ========== Info from phpDoc block ========= -->
  490. <p class="short-description">Tracking code of the request.</p>
  491. <p class="description"><p>Use of this value is undefined. Please do not use it. <strong>Optional. Ignored if NULL.</strong></p></p>
  492. <ul class="tags">
  493. <li><span class="field">access:</span> private</li>
  494. </ul>
  495. </div>
  496. <a name="var$user_key" id="$user_key"><!-- --></A>
  497. <div class="oddrow">
  498. <div class="var-header">
  499. <img src="../media/images/PrivateVariable.png" />
  500. <span class="var-title">
  501. <span class="var-type">string</span>
  502. <span class="var-name">$user_key</span>
  503. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a111">111</a></span>)
  504. </span>
  505. </div>
  506. <!-- ========== Info from phpDoc block ========= -->
  507. <p class="short-description">SL agent key.</p>
  508. <p class="description"><p>Should be a string specifying the UUID key of the agent in-world being handled. (Typically of the user who initiated the request). <strong>Optional. Ignored if NULL.</strong></p></p>
  509. <ul class="tags">
  510. <li><span class="field">access:</span> private</li>
  511. </ul>
  512. </div>
  513. </div>
  514. </div>
  515. <a name="sec-methods"></a>
  516. <div class="info-box">
  517. <div class="info-box-title">Methods</div>
  518. <div class="nav-bar">
  519. <a href="#sec-description">Description</a> |
  520. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  521. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  522. </div>
  523. <div class="info-box-body">
  524. <A NAME='method_detail'></A>
  525. <a name="methodSloodleLSLResponse" id="SloodleLSLResponse"><!-- --></a>
  526. <div class="evenrow">
  527. <div class="method-header">
  528. <img src="../media/images/Constructor.png" />
  529. <span class="method-title">Constructor SloodleLSLResponse</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a463">463</a></span>)
  530. </div>
  531. <!-- ========== Info from phpDoc block ========= -->
  532. <p class="short-description"><em>Constructor</em><ul><li>can intialise some variables</li></ul></p>
  533. <ul class="tags">
  534. <li><span class="field">access:</span> public</li>
  535. </ul>
  536. <div class="method-signature">
  537. <span class="method-result">void</span>
  538. <span class="method-name">
  539. SloodleLSLResponse
  540. </span>
  541. ([<span class="var-type">int</span>&nbsp;<span class="var-name">$status_code</span> = <span class="var-default">NULL</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$status_descriptor</span> = <span class="var-default">NULL</span>], [<span class="var-type">mixed</span>&nbsp;<span class="var-name">$data</span> = <span class="var-default">NULL</span>])
  542. </div>
  543. <ul class="parameters">
  544. <li>
  545. <span class="var-type">int</span>
  546. <span class="var-name">$status_code</span><span class="var-description">: The initial status code for the response (optional - ignore if NULL)</span> </li>
  547. <li>
  548. <span class="var-type">string</span>
  549. <span class="var-name">$status_descriptor</span><span class="var-description">: The initial status descriptor for the response (optional - ignore if NULL)</span> </li>
  550. <li>
  551. <span class="var-type">mixed</span>
  552. <span class="var-name">$data</span><span class="var-description">: The initial data for the response, which can be a scalar, or a mixed array of scalars/scalar-arrays (see <a href="../sloodle/SloodleLSLResponse.html#var$data">SloodleLSLResponse::$data</a>) (optional - ignore if NULL)</span> </li>
  553. </ul>
  554. </div>
  555. <a name="methodadd_data_line" id="add_data_line"><!-- --></a>
  556. <div class="oddrow">
  557. <div class="method-header">
  558. <img src="../media/images/Method.png" />
  559. <span class="method-title">add_data_line</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a421">421</a></span>)
  560. </div>
  561. <!-- ========== Info from phpDoc block ========= -->
  562. <p class="short-description">Adds one line of data to the $data member</p>
  563. <div class="method-signature">
  564. <span class="method-result">void</span>
  565. <span class="method-name">
  566. add_data_line
  567. </span>
  568. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  569. </div>
  570. <ul class="parameters">
  571. <li>
  572. <span class="var-type">mixed</span>
  573. <span class="var-name">$par</span><span class="var-description">: A scalar, or an array of scalars</span> </li>
  574. </ul>
  575. </div>
  576. <a name="methodadd_side_effect" id="add_side_effect"><!-- --></a>
  577. <div class="evenrow">
  578. <div class="method-header">
  579. <img src="../media/images/Method.png" />
  580. <span class="method-title">add_side_effect</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a269">269</a></span>)
  581. </div>
  582. <!-- ========== Info from phpDoc block ========= -->
  583. <p class="short-description">Adds a single side effect code to member $status_code</p>
  584. <div class="method-signature">
  585. <span class="method-result">void</span>
  586. <span class="method-name">
  587. add_side_effect
  588. </span>
  589. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  590. </div>
  591. <ul class="parameters">
  592. <li>
  593. <span class="var-type">integer</span>
  594. <span class="var-name">$par</span><span class="var-description">: An integer side-effect code.</span> </li>
  595. </ul>
  596. </div>
  597. <a name="methodadd_side_effects" id="add_side_effects"><!-- --></a>
  598. <div class="oddrow">
  599. <div class="method-header">
  600. <img src="../media/images/Method.png" />
  601. <span class="method-title">add_side_effects</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a228">228</a></span>)
  602. </div>
  603. <!-- ========== Info from phpDoc block ========= -->
  604. <p class="short-description">Adds one or more integer side effect codes to member $status_code.</p>
  605. <div class="method-signature">
  606. <span class="method-result">void</span>
  607. <span class="method-name">
  608. add_side_effects
  609. </span>
  610. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  611. </div>
  612. <ul class="parameters">
  613. <li>
  614. <span class="var-type">mixed</span>
  615. <span class="var-name">$par</span><span class="var-description">: An integer side effect code, or an array of them.</span> </li>
  616. </ul>
  617. </div>
  618. <a name="methodclear_data" id="clear_data"><!-- --></a>
  619. <div class="evenrow">
  620. <div class="method-header">
  621. <img src="../media/images/Method.png" />
  622. <span class="method-title">clear_data</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a447">447</a></span>)
  623. </div>
  624. <!-- ========== Info from phpDoc block ========= -->
  625. <p class="short-description">Clears all data from member $data</p>
  626. <div class="method-signature">
  627. <span class="method-result">void</span>
  628. <span class="method-name">
  629. clear_data
  630. </span>
  631. ()
  632. </div>
  633. </div>
  634. <a name="methodquick_output" id="quick_output"><!-- --></a>
  635. <div class="oddrow">
  636. <div class="method-header">
  637. <img src="../media/images/Method.png" />
  638. <span class="method-title">quick_output</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a640">640</a></span>)
  639. </div>
  640. <!-- ========== Info from phpDoc block ========= -->
  641. <p class="short-description">Quick output of data to avoid several accessor calls if the response is very basic.</p>
  642. <p class="description"><p>Can be called statically to allow simple output of basic data. The status code is required, but the other parameters are optional If an error occurs, the LSL-friendly error message is output to the HTTP response, and the script terminated</p></p>
  643. <ul class="tags">
  644. <li><span class="field">access:</span> public</li>
  645. </ul>
  646. <div class="method-signature">
  647. <span class="method-result">void</span>
  648. <span class="method-name">
  649. quick_output
  650. </span>
  651. (<span class="var-type">int</span>&nbsp;<span class="var-name">$status_code</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$status_descriptor</span> = <span class="var-default">NULL</span>], [<span class="var-type">mixed</span>&nbsp;<span class="var-name">$data</span> = <span class="var-default">NULL</span>], [<span class="var-type">bool</span>&nbsp;<span class="var-name">$static</span> = <span class="var-default">TRUE</span>])
  652. </div>
  653. <ul class="parameters">
  654. <li>
  655. <span class="var-type">int</span>
  656. <span class="var-name">$status_code</span><span class="var-description">: The status code for the response (required)</span> </li>
  657. <li>
  658. <span class="var-type">string</span>
  659. <span class="var-name">$status_descriptor</span><span class="var-description">: The status descriptor for the response (optional - ignored if NULL)</span> </li>
  660. <li>
  661. <span class="var-type">mixed</span>
  662. <span class="var-name">$data</span><span class="var-description">: The data for the response, which can be a scalar, or a mixed array of scalars/scalar-arrays (see <a href="../sloodle/SloodleLSLResponse.html#var$data">SloodleLSLResponse::$data</a>) (optional - ignored if NULL)</span> </li>
  663. <li>
  664. <span class="var-type">bool</span>
  665. <span class="var-name">$static</span><span class="var-description">: If TRUE (default), then this function will assume it is being call statically, and construct its own response object. Otherwise, it will all the existing member data to render the output.</span> </li>
  666. </ul>
  667. </div>
  668. <a name="methodrender_to_output" id="render_to_output"><!-- --></a>
  669. <div class="evenrow">
  670. <div class="method-header">
  671. <img src="../media/images/Method.png" />
  672. <span class="method-title">render_to_output</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a612">612</a></span>)
  673. </div>
  674. <!-- ========== Info from phpDoc block ========= -->
  675. <p class="short-description">Outputs the response directly to the HTTP response.</p>
  676. <ul class="tags">
  677. <li><span class="field">access:</span> public</li>
  678. <li><span class="field">uses:</span> <a href="../sloodle/SloodleLSLResponse.html#methodrender_to_string">SloodleLSLResponse::render_to_string()</a> - Outputs the result from this function directly to the HTTP response stream.</li>
  679. </ul>
  680. <div class="method-signature">
  681. <span class="method-result">void</span>
  682. <span class="method-name">
  683. render_to_output
  684. </span>
  685. ()
  686. </div>
  687. </div>
  688. <a name="methodrender_to_string" id="render_to_string"><!-- --></a>
  689. <div class="oddrow">
  690. <div class="method-header">
  691. <img src="../media/images/Method.png" />
  692. <span class="method-title">render_to_string</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a480">480</a></span>)
  693. </div>
  694. <!-- ========== Info from phpDoc block ========= -->
  695. <p class="short-description">Renders the response to a string.</p>
  696. <p class="description"><p>Prior to rendering, this function will perform final validation on all the data. If anything fails, then the script will terminate with an LSL-friendly error message.</p></p>
  697. <ul class="tags">
  698. <li><span class="field">access:</span> public</li>
  699. <li><span class="field">usedby:</span> <a href="../sloodle/SloodleLSLResponse.html#methodrender_to_output">SloodleLSLResponse::render_to_output()</a> - Outputs the result from this function directly to the HTTP response stream.</li>
  700. </ul>
  701. <div class="method-signature">
  702. <span class="method-result">void</span>
  703. <span class="method-name">
  704. render_to_string
  705. </span>
  706. (<span class="var-type">string</span>&nbsp;<span class="var-name">&$str</span>)
  707. </div>
  708. <ul class="parameters">
  709. <li>
  710. <span class="var-type">string</span>
  711. <span class="var-name">&$str</span><span class="var-description">: Reference to a string object which the response should be rendered to.</span> </li>
  712. </ul>
  713. </div>
  714. <a name="methodset_data" id="set_data"><!-- --></a>
  715. <div class="evenrow">
  716. <div class="method-header">
  717. <img src="../media/images/Method.png" />
  718. <span class="method-title">set_data</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a382">382</a></span>)
  719. </div>
  720. <!-- ========== Info from phpDoc block ========= -->
  721. <p class="short-description">Accessor function to set member value $data. <strong>Note: it is recommended that you use the add_data_line() and clear_data() functions instead of this.</strong></p>
  722. <div class="method-signature">
  723. <span class="method-result">void</span>
  724. <span class="method-name">
  725. set_data
  726. </span>
  727. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  728. </div>
  729. <ul class="parameters">
  730. <li>
  731. <span class="var-type">mixed</span>
  732. <span class="var-name">$par</span><span class="var-description">: Any scalar value, or a mixed array of scalars or scalar arrays, or NULL to clear it</span> </li>
  733. </ul>
  734. </div>
  735. <a name="methodset_page_number" id="set_page_number"><!-- --></a>
  736. <div class="oddrow">
  737. <div class="method-header">
  738. <img src="../media/images/Method.png" />
  739. <span class="method-title">set_page_number</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a367">367</a></span>)
  740. </div>
  741. <!-- ========== Info from phpDoc block ========= -->
  742. <p class="short-description">Accessor function to set member value $page_number</p>
  743. <div class="method-signature">
  744. <span class="method-result">void</span>
  745. <span class="method-name">
  746. set_page_number
  747. </span>
  748. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  749. </div>
  750. <ul class="parameters">
  751. <li>
  752. <span class="var-type">mixed</span>
  753. <span class="var-name">$par</span><span class="var-description">: A positive page number, or NULL to clear it</span> </li>
  754. </ul>
  755. </div>
  756. <a name="methodset_page_total" id="set_page_total"><!-- --></a>
  757. <div class="evenrow">
  758. <div class="method-header">
  759. <img src="../media/images/Method.png" />
  760. <span class="method-title">set_page_total</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a352">352</a></span>)
  761. </div>
  762. <!-- ========== Info from phpDoc block ========= -->
  763. <p class="short-description">Accessor function to set member value $page_total</p>
  764. <div class="method-signature">
  765. <span class="method-result">void</span>
  766. <span class="method-name">
  767. set_page_total
  768. </span>
  769. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  770. </div>
  771. <ul class="parameters">
  772. <li>
  773. <span class="var-type">mixed</span>
  774. <span class="var-name">$par</span><span class="var-description">: A positive page total count, or NULL to clear it</span> </li>
  775. </ul>
  776. </div>
  777. <a name="methodset_request_descriptor" id="set_request_descriptor"><!-- --></a>
  778. <div class="oddrow">
  779. <div class="method-header">
  780. <img src="../media/images/Method.png" />
  781. <span class="method-title">set_request_descriptor</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a282">282</a></span>)
  782. </div>
  783. <!-- ========== Info from phpDoc block ========= -->
  784. <p class="short-description">Accessor function to set member value $request_descriptor</p>
  785. <div class="method-signature">
  786. <span class="method-result">void</span>
  787. <span class="method-name">
  788. set_request_descriptor
  789. </span>
  790. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  791. </div>
  792. <ul class="parameters">
  793. <li>
  794. <span class="var-type">mixed</span>
  795. <span class="var-name">$par</span><span class="var-description">: A string request descriptor, or NULL to clear it</span> </li>
  796. </ul>
  797. </div>
  798. <a name="methodset_request_timestamp" id="set_request_timestamp"><!-- --></a>
  799. <div class="evenrow">
  800. <div class="method-header">
  801. <img src="../media/images/Method.png" />
  802. <span class="method-title">set_request_timestamp</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a297">297</a></span>)
  803. </div>
  804. <!-- ========== Info from phpDoc block ========= -->
  805. <p class="short-description">Accessor function to set member value $request_timestamp</p>
  806. <div class="method-signature">
  807. <span class="method-result">void</span>
  808. <span class="method-name">
  809. set_request_timestamp
  810. </span>
  811. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  812. </div>
  813. <ul class="parameters">
  814. <li>
  815. <span class="var-type">mixed</span>
  816. <span class="var-name">$par</span><span class="var-description">: An integer timestamp, or NULL to clear it</span> </li>
  817. </ul>
  818. </div>
  819. <a name="methodset_response_timestamp" id="set_response_timestamp"><!-- --></a>
  820. <div class="oddrow">
  821. <div class="method-header">
  822. <img src="../media/images/Method.png" />
  823. <span class="method-title">set_response_timestamp</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a312">312</a></span>)
  824. </div>
  825. <!-- ========== Info from phpDoc block ========= -->
  826. <p class="short-description">Accessor function to set member value $response_timestamp</p>
  827. <div class="method-signature">
  828. <span class="method-result">void</span>
  829. <span class="method-name">
  830. set_response_timestamp
  831. </span>
  832. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  833. </div>
  834. <ul class="parameters">
  835. <li>
  836. <span class="var-type">mixed</span>
  837. <span class="var-name">$par</span><span class="var-description">: An integer timestamp, or NULL to clear it</span> </li>
  838. </ul>
  839. </div>
  840. <a name="methodset_side_effects" id="set_side_effects"><!-- --></a>
  841. <div class="evenrow">
  842. <div class="method-header">
  843. <img src="../media/images/Method.png" />
  844. <span class="method-title">set_side_effects</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a198">198</a></span>)
  845. </div>
  846. <!-- ========== Info from phpDoc block ========= -->
  847. <p class="short-description">Accessor function to set member value $side_effects. <strong>Note:</strong> it is recommended that you use add_side_effect() or add_side_effects() instead.</p>
  848. <div class="method-signature">
  849. <span class="method-result">void</span>
  850. <span class="method-name">
  851. set_side_effects
  852. </span>
  853. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  854. </div>
  855. <ul class="parameters">
  856. <li>
  857. <span class="var-type">mixed</span>
  858. <span class="var-name">$par</span><span class="var-description">: An integer side effect code, an array of integer side effect codes, or null to clear it</span> </li>
  859. </ul>
  860. </div>
  861. <a name="methodset_status_code" id="set_status_code"><!-- --></a>
  862. <div class="oddrow">
  863. <div class="method-header">
  864. <img src="../media/images/Method.png" />
  865. <span class="method-title">set_status_code</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a168">168</a></span>)
  866. </div>
  867. <!-- ========== Info from phpDoc block ========= -->
  868. <p class="short-description">Accessor function to set member value $status_code</p>
  869. <div class="method-signature">
  870. <span class="method-result">void</span>
  871. <span class="method-name">
  872. set_status_code
  873. </span>
  874. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  875. </div>
  876. <ul class="parameters">
  877. <li>
  878. <span class="var-type">integer</span>
  879. <span class="var-name">$par</span><span class="var-description">: A non-zero status code</span> </li>
  880. </ul>
  881. </div>
  882. <a name="methodset_status_descriptor" id="set_status_descriptor"><!-- --></a>
  883. <div class="evenrow">
  884. <div class="method-header">
  885. <img src="../media/images/Method.png" />
  886. <span class="method-title">set_status_descriptor</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a183">183</a></span>)
  887. </div>
  888. <!-- ========== Info from phpDoc block ========= -->
  889. <p class="short-description">Accessor function to set member value $status_descriptor</p>
  890. <div class="method-signature">
  891. <span class="method-result">void</span>
  892. <span class="method-name">
  893. set_status_descriptor
  894. </span>
  895. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  896. </div>
  897. <ul class="parameters">
  898. <li>
  899. <span class="var-type">mixed</span>
  900. <span class="var-name">$par</span><span class="var-description">: A status descriptor string, or NULL to clear it</span> </li>
  901. </ul>
  902. </div>
  903. <a name="methodset_tracking_code" id="set_tracking_code"><!-- --></a>
  904. <div class="oddrow">
  905. <div class="method-header">
  906. <img src="../media/images/Method.png" />
  907. <span class="method-title">set_tracking_code</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a342">342</a></span>)
  908. </div>
  909. <!-- ========== Info from phpDoc block ========= -->
  910. <p class="short-description">Accessor function to set member value $tracking_code</p>
  911. <div class="method-signature">
  912. <span class="method-result">void</span>
  913. <span class="method-name">
  914. set_tracking_code
  915. </span>
  916. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  917. </div>
  918. <ul class="parameters">
  919. <li>
  920. <span class="var-type">mixed</span>
  921. <span class="var-name">$par</span><span class="var-description">: Any scalar value</span> </li>
  922. </ul>
  923. </div>
  924. <a name="methodset_user_key" id="set_user_key"><!-- --></a>
  925. <div class="evenrow">
  926. <div class="method-header">
  927. <img src="../media/images/Method.png" />
  928. <span class="method-title">set_user_key</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a327">327</a></span>)
  929. </div>
  930. <!-- ========== Info from phpDoc block ========= -->
  931. <p class="short-description">Accessor function to set member value $user_key</p>
  932. <div class="method-signature">
  933. <span class="method-result">void</span>
  934. <span class="method-name">
  935. set_user_key
  936. </span>
  937. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  938. </div>
  939. <ul class="parameters">
  940. <li>
  941. <span class="var-type">mixed</span>
  942. <span class="var-name">$par</span><span class="var-description">: A string containing a UUID, or NULL to clear it</span> </li>
  943. </ul>
  944. </div>
  945. <a name="method_internal_validation_error" id="_internal_validation_error"><!-- --></a>
  946. <div class="oddrow">
  947. <div class="method-header">
  948. <img src="../media/images/PrivateMethod.png" />
  949. <span class="method-title">_internal_validation_error</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_iolib.php.html#a666">666</a></span>)
  950. </div>
  951. <!-- ========== Info from phpDoc block ========= -->
  952. <p class="short-description">Internal function to report a data validation error.</p>
  953. <p class="description"><p>Outputs an LSL-friendly error message, and terminates the script</p></p>
  954. <ul class="tags">
  955. <li><span class="field">access:</span> private</li>
  956. </ul>
  957. <div class="method-signature">
  958. <span class="method-result">void</span>
  959. <span class="method-name">
  960. _internal_validation_error
  961. </span>
  962. (<span class="var-type">string</span>&nbsp;<span class="var-name">$msg</span>)
  963. </div>
  964. <ul class="parameters">
  965. <li>
  966. <span class="var-type">string</span>
  967. <span class="var-name">$msg</span><span class="var-description">: The error message to output.</span> </li>
  968. </ul>
  969. </div>
  970. </div>
  971. </div>
  972. <p class="notes" id="credit">
  973. Documentation generated on Tue, 04 Mar 2008 15:08:46 +0000 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
  974. </p>
  975. </div></body>
  976. </html>