SloodleResponse.html 56 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405
  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 SloodleResponse</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"> SloodleResponse</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/SloodleRequest.html">SloodleRequest</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="_sloodle---lib---io.php.html">/sloodle/lib/io.php</a> (line <span class="field"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a50">50</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">string</span>
  122. <a href="#$avatar_uuid" title="details" class="var-name">$avatar_uuid</a>
  123. </div>
  124. <div class="var-title">
  125. <img src="../media/images/PrivateVariable.png" alt=" " />
  126. <span class="var-type">mixed</span>
  127. <a href="#$data" title="details" class="var-name">$data</a>
  128. </div>
  129. <div class="var-title">
  130. <img src="../media/images/PrivateVariable.png" alt=" " />
  131. <span class="var-type">string</span>
  132. <a href="#$field_separator" title="details" class="var-name">$field_separator</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="#$line_separator" title="details" class="var-name">$line_separator</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="#$page_number" title="details" class="var-name">$page_number</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="#$page_total" title="details" class="var-name">$page_total</a>
  148. </div>
  149. <div class="var-title">
  150. <img src="../media/images/PrivateVariable.png" alt=" " />
  151. <span class="var-type">string</span>
  152. <a href="#$request_descriptor" title="details" class="var-name">$request_descriptor</a>
  153. </div>
  154. <div class="var-title">
  155. <img src="../media/images/PrivateVariable.png" alt=" " />
  156. <span class="var-type">integer</span>
  157. <a href="#$request_timestamp" title="details" class="var-name">$request_timestamp</a>
  158. </div>
  159. <div class="var-title">
  160. <img src="../media/images/PrivateVariable.png" alt=" " />
  161. <span class="var-type">integer</span>
  162. <a href="#$response_timestamp" title="details" class="var-name">$response_timestamp</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="#$side_effects" title="details" class="var-name">$side_effects</a>
  168. </div>
  169. <div class="var-title">
  170. <img src="../media/images/PrivateVariable.png" alt=" " />
  171. <span class="var-type">int</span>
  172. <a href="#$status_code" title="details" class="var-name">$status_code</a>
  173. </div>
  174. <div class="var-title">
  175. <img src="../media/images/PrivateVariable.png" alt=" " />
  176. <span class="var-type">string</span>
  177. <a href="#$status_descriptor" title="details" class="var-name">$status_descriptor</a>
  178. </div>
  179. <div class="var-title">
  180. <img src="../media/images/PrivateVariable.png" alt=" " />
  181. <span class="var-type">mixed</span>
  182. <a href="#$tracking_code" title="details" class="var-name">$tracking_code</a>
  183. </div>
  184. </div>
  185. </div>
  186. </div>
  187. <a name="sec-method-summary"></a>
  188. <div class="info-box">
  189. <div class="info-box-title">Method Summary</span></div>
  190. <div class="nav-bar">
  191. <a href="#sec-description">Description</a> |
  192. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  193. |
  194. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  195. </div>
  196. <div class="info-box-body">
  197. <div class="method-summary">
  198. <div class="method-definition">
  199. <img src="../media/images/Constructor.png" alt=" "/>
  200. <span class="method-result">void</span>
  201. <a href="#SloodleResponse" title="details" class="method-name">SloodleResponse</a>
  202. ([<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>])
  203. </div>
  204. <div class="method-definition">
  205. <img src="../media/images/Method.png" alt=" "/>
  206. <span class="method-result">void</span>
  207. <a href="#add_data_line" title="details" class="method-name">add_data_line</a>
  208. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  209. </div>
  210. <div class="method-definition">
  211. <img src="../media/images/Method.png" alt=" "/>
  212. <span class="method-result">void</span>
  213. <a href="#add_side_effect" title="details" class="method-name">add_side_effect</a>
  214. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  215. </div>
  216. <div class="method-definition">
  217. <img src="../media/images/Method.png" alt=" "/>
  218. <span class="method-result">void</span>
  219. <a href="#add_side_effects" title="details" class="method-name">add_side_effects</a>
  220. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  221. </div>
  222. <div class="method-definition">
  223. <img src="../media/images/Method.png" alt=" "/>
  224. <span class="method-result">void</span>
  225. <a href="#clear_data" title="details" class="method-name">clear_data</a>
  226. ()
  227. </div>
  228. <div class="method-definition">
  229. <img src="../media/images/Method.png" alt=" "/>
  230. <span class="method-result">string</span>
  231. <a href="#get_field_separator" title="details" class="method-name">get_field_separator</a>
  232. ()
  233. </div>
  234. <div class="method-definition">
  235. <img src="../media/images/Method.png" alt=" "/>
  236. <span class="method-result">string</span>
  237. <a href="#get_line_separator" title="details" class="method-name">get_line_separator</a>
  238. ()
  239. </div>
  240. <div class="method-definition">
  241. <img src="../media/images/Method.png" alt=" "/>
  242. <span class="method-result">void</span>
  243. <a href="#quick_output" title="details" class="method-name">quick_output</a>
  244. (<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>])
  245. </div>
  246. <div class="method-definition">
  247. <img src="../media/images/Method.png" alt=" "/>
  248. <span class="method-result">void</span>
  249. <a href="#render_to_output" title="details" class="method-name">render_to_output</a>
  250. ()
  251. </div>
  252. <div class="method-definition">
  253. <img src="../media/images/Method.png" alt=" "/>
  254. <span class="method-result">void</span>
  255. <a href="#render_to_string" title="details" class="method-name">render_to_string</a>
  256. (<span class="var-type">string</span>&nbsp;<span class="var-name">&$str</span>)
  257. </div>
  258. <div class="method-definition">
  259. <img src="../media/images/Method.png" alt=" "/>
  260. <span class="method-result">void</span>
  261. <a href="#set_avatar_uuid" title="details" class="method-name">set_avatar_uuid</a>
  262. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  263. </div>
  264. <div class="method-definition">
  265. <img src="../media/images/Method.png" alt=" "/>
  266. <span class="method-result">void</span>
  267. <a href="#set_data" title="details" class="method-name">set_data</a>
  268. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  269. </div>
  270. <div class="method-definition">
  271. <img src="../media/images/Method.png" alt=" "/>
  272. <span class="method-result">void</span>
  273. <a href="#set_field_separator" title="details" class="method-name">set_field_separator</a>
  274. (<span class="var-type">string</span>&nbsp;<span class="var-name">$sep</span>)
  275. </div>
  276. <div class="method-definition">
  277. <img src="../media/images/Method.png" alt=" "/>
  278. <span class="method-result">void</span>
  279. <a href="#set_line_separator" title="details" class="method-name">set_line_separator</a>
  280. (<span class="var-type">string</span>&nbsp;<span class="var-name">$sep</span>)
  281. </div>
  282. <div class="method-definition">
  283. <img src="../media/images/Method.png" alt=" "/>
  284. <span class="method-result">void</span>
  285. <a href="#set_page_number" title="details" class="method-name">set_page_number</a>
  286. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  287. </div>
  288. <div class="method-definition">
  289. <img src="../media/images/Method.png" alt=" "/>
  290. <span class="method-result">void</span>
  291. <a href="#set_page_total" title="details" class="method-name">set_page_total</a>
  292. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  293. </div>
  294. <div class="method-definition">
  295. <img src="../media/images/Method.png" alt=" "/>
  296. <span class="method-result">void</span>
  297. <a href="#set_request_descriptor" title="details" class="method-name">set_request_descriptor</a>
  298. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  299. </div>
  300. <div class="method-definition">
  301. <img src="../media/images/Method.png" alt=" "/>
  302. <span class="method-result">void</span>
  303. <a href="#set_request_timestamp" title="details" class="method-name">set_request_timestamp</a>
  304. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  305. </div>
  306. <div class="method-definition">
  307. <img src="../media/images/Method.png" alt=" "/>
  308. <span class="method-result">void</span>
  309. <a href="#set_response_timestamp" title="details" class="method-name">set_response_timestamp</a>
  310. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  311. </div>
  312. <div class="method-definition">
  313. <img src="../media/images/Method.png" alt=" "/>
  314. <span class="method-result">void</span>
  315. <a href="#set_side_effects" title="details" class="method-name">set_side_effects</a>
  316. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  317. </div>
  318. <div class="method-definition">
  319. <img src="../media/images/Method.png" alt=" "/>
  320. <span class="method-result">void</span>
  321. <a href="#set_status_code" title="details" class="method-name">set_status_code</a>
  322. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  323. </div>
  324. <div class="method-definition">
  325. <img src="../media/images/Method.png" alt=" "/>
  326. <span class="method-result">void</span>
  327. <a href="#set_status_descriptor" title="details" class="method-name">set_status_descriptor</a>
  328. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  329. </div>
  330. <div class="method-definition">
  331. <img src="../media/images/Method.png" alt=" "/>
  332. <span class="method-result">void</span>
  333. <a href="#set_tracking_code" title="details" class="method-name">set_tracking_code</a>
  334. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  335. </div>
  336. <div class="method-definition">
  337. <img src="../media/images/PrivateMethod.png" alt=" "/>
  338. <span class="method-result">void</span>
  339. <a href="#_internal_validation_error" title="details" class="method-name">_internal_validation_error</a>
  340. (<span class="var-type">string</span>&nbsp;<span class="var-name">$msg</span>)
  341. </div>
  342. </div>
  343. </div>
  344. </div>
  345. <a name="sec-vars"></a>
  346. <div class="info-box">
  347. <div class="info-box-title">Variables</div>
  348. <div class="nav-bar">
  349. <a href="#sec-description">Description</a> |
  350. <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
  351. |
  352. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  353. </div>
  354. <div class="info-box-body">
  355. <a name="var$avatar_uuid" id="$avatar_uuid"><!-- --></A>
  356. <div class="evenrow">
  357. <div class="var-header">
  358. <img src="../media/images/PrivateVariable.png" />
  359. <span class="var-title">
  360. <span class="var-type">string</span>
  361. <span class="var-name">$avatar_uuid</span>
  362. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a131">131</a></span>)
  363. </span>
  364. </div>
  365. <!-- ========== Info from phpDoc block ========= -->
  366. <p class="short-description">Avatar UUID.</p>
  367. <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>
  368. <ul class="tags">
  369. <li><span class="field">access:</span> private</li>
  370. </ul>
  371. </div>
  372. <a name="var$data" id="$data"><!-- --></A>
  373. <div class="oddrow">
  374. <div class="var-header">
  375. <img src="../media/images/PrivateVariable.png" />
  376. <span class="var-title">
  377. <span class="var-type">mixed</span>
  378. <span class="var-name">$data</span>
  379. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a174">174</a></span>)
  380. </span>
  381. </div>
  382. <!-- ========== Info from phpDoc block ========= -->
  383. <p class="short-description">Data to render following the status line in the response.</p>
  384. <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>
  385. <ul class="tags">
  386. <li><span class="field">see:</span> <a href="../sloodle/SloodleResponse.html#methodclear_data">SloodleResponse::clear_data()</a></li>
  387. <li><span class="field">see:</span> <a href="../sloodle/SloodleResponse.html#methodadd_data_line">SloodleResponse::add_data_line()</a></li>
  388. <li><span class="field">see:</span> <a href="../sloodle/SloodleResponse.html#methodset_data">SloodleResponse::set_data()</a></li>
  389. <li><span class="field">access:</span> private</li>
  390. </ul>
  391. </div>
  392. <a name="var$field_separator" id="$field_separator"><!-- --></A>
  393. <div class="evenrow">
  394. <div class="var-header">
  395. <img src="../media/images/PrivateVariable.png" />
  396. <span class="var-title">
  397. <span class="var-type">string</span>
  398. <span class="var-name">$field_separator</span>
  399. = <span class="var-default"> &quot;|&quot;</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a66">66</a></span>)
  400. </span>
  401. </div>
  402. <!-- ========== Info from phpDoc block ========= -->
  403. <p class="short-description">The separation string between fields of a response line (by default, a pipe character |).</p>
  404. <ul class="tags">
  405. <li><span class="field">access:</span> private</li>
  406. </ul>
  407. </div>
  408. <a name="var$line_separator" id="$line_separator"><!-- --></A>
  409. <div class="oddrow">
  410. <div class="var-header">
  411. <img src="../media/images/PrivateVariable.png" />
  412. <span class="var-title">
  413. <span class="var-type">string</span>
  414. <span class="var-name">$line_separator</span>
  415. = <span class="var-default"> &quot;\n&quot;</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a59">59</a></span>)
  416. </span>
  417. </div>
  418. <!-- ========== Info from phpDoc block ========= -->
  419. <p class="short-description">The separation string between lines of the response (typically just a newline).</p>
  420. <ul class="tags">
  421. <li><span class="field">access:</span> private</li>
  422. </ul>
  423. </div>
  424. <a name="var$page_number" id="$page_number"><!-- --></A>
  425. <div class="evenrow">
  426. <div class="var-header">
  427. <img src="../media/images/PrivateVariable.png" />
  428. <span class="var-title">
  429. <span class="var-type">integer</span>
  430. <span class="var-name">$page_number</span>
  431. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a158">158</a></span>)
  432. </span>
  433. </div>
  434. <!-- ========== Info from phpDoc block ========= -->
  435. <p class="short-description">Current page number.</p>
  436. <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>
  437. <ul class="tags">
  438. <li><span class="field">access:</span> private</li>
  439. </ul>
  440. </div>
  441. <a name="var$page_total" id="$page_total"><!-- --></A>
  442. <div class="oddrow">
  443. <div class="var-header">
  444. <img src="../media/images/PrivateVariable.png" />
  445. <span class="var-title">
  446. <span class="var-type">integer</span>
  447. <span class="var-name">$page_total</span>
  448. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a149">149</a></span>)
  449. </span>
  450. </div>
  451. <!-- ========== Info from phpDoc block ========= -->
  452. <p class="short-description">Total number of pages.</p>
  453. <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>
  454. <ul class="tags">
  455. <li><span class="field">access:</span> private</li>
  456. </ul>
  457. </div>
  458. <a name="var$request_descriptor" id="$request_descriptor"><!-- --></A>
  459. <div class="evenrow">
  460. <div class="var-header">
  461. <img src="../media/images/PrivateVariable.png" />
  462. <span class="var-title">
  463. <span class="var-type">string</span>
  464. <span class="var-name">$request_descriptor</span>
  465. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a104">104</a></span>)
  466. </span>
  467. </div>
  468. <!-- ========== Info from phpDoc block ========= -->
  469. <p class="short-description">Request descriptor.</p>
  470. <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>
  471. <ul class="tags">
  472. <li><span class="field">access:</span> private</li>
  473. </ul>
  474. </div>
  475. <a name="var$request_timestamp" id="$request_timestamp"><!-- --></A>
  476. <div class="oddrow">
  477. <div class="var-header">
  478. <img src="../media/images/PrivateVariable.png" />
  479. <span class="var-title">
  480. <span class="var-type">integer</span>
  481. <span class="var-name">$request_timestamp</span>
  482. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a113">113</a></span>)
  483. </span>
  484. </div>
  485. <!-- ========== Info from phpDoc block ========= -->
  486. <p class="short-description">Timestamp when the request was originally made by the LSL script.</p>
  487. <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>
  488. <ul class="tags">
  489. <li><span class="field">access:</span> private</li>
  490. </ul>
  491. </div>
  492. <a name="var$response_timestamp" id="$response_timestamp"><!-- --></A>
  493. <div class="evenrow">
  494. <div class="var-header">
  495. <img src="../media/images/PrivateVariable.png" />
  496. <span class="var-title">
  497. <span class="var-type">integer</span>
  498. <span class="var-name">$response_timestamp</span>
  499. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a122">122</a></span>)
  500. </span>
  501. </div>
  502. <!-- ========== Info from phpDoc block ========= -->
  503. <p class="short-description">Timestamp when the response was generated on the Moodle site.</p>
  504. <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>
  505. <ul class="tags">
  506. <li><span class="field">access:</span> private</li>
  507. </ul>
  508. </div>
  509. <a name="var$side_effects" id="$side_effects"><!-- --></A>
  510. <div class="oddrow">
  511. <div class="var-header">
  512. <img src="../media/images/PrivateVariable.png" />
  513. <span class="var-title">
  514. <span class="var-type">mixed</span>
  515. <span class="var-name">$side_effects</span>
  516. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a94">94</a></span>)
  517. </span>
  518. </div>
  519. <!-- ========== Info from phpDoc block ========= -->
  520. <p class="short-description">Integer side effect(s) codes.</p>
  521. <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>
  522. <ul class="tags">
  523. <li><span class="field">access:</span> private</li>
  524. </ul>
  525. </div>
  526. <a name="var$status_code" id="$status_code"><!-- --></A>
  527. <div class="evenrow">
  528. <div class="var-header">
  529. <img src="../media/images/PrivateVariable.png" />
  530. <span class="var-title">
  531. <span class="var-type">int</span>
  532. <span class="var-name">$status_code</span>
  533. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a75">75</a></span>)
  534. </span>
  535. </div>
  536. <!-- ========== Info from phpDoc block ========= -->
  537. <p class="short-description">Integer status code of the response.</p>
  538. <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>
  539. <ul class="tags">
  540. <li><span class="field">access:</span> private</li>
  541. </ul>
  542. </div>
  543. <a name="var$status_descriptor" id="$status_descriptor"><!-- --></A>
  544. <div class="oddrow">
  545. <div class="var-header">
  546. <img src="../media/images/PrivateVariable.png" />
  547. <span class="var-title">
  548. <span class="var-type">string</span>
  549. <span class="var-name">$status_descriptor</span>
  550. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a84">84</a></span>)
  551. </span>
  552. </div>
  553. <!-- ========== Info from phpDoc block ========= -->
  554. <p class="short-description">Status descriptor string.</p>
  555. <p class="description"><p>Should contain a generalised description/category of the status code. <strong>Optional but recommended. Ignored if null.</strong></p></p>
  556. <ul class="tags">
  557. <li><span class="field">access:</span> private</li>
  558. </ul>
  559. </div>
  560. <a name="var$tracking_code" id="$tracking_code"><!-- --></A>
  561. <div class="evenrow">
  562. <div class="var-header">
  563. <img src="../media/images/PrivateVariable.png" />
  564. <span class="var-title">
  565. <span class="var-type">mixed</span>
  566. <span class="var-name">$tracking_code</span>
  567. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a140">140</a></span>)
  568. </span>
  569. </div>
  570. <!-- ========== Info from phpDoc block ========= -->
  571. <p class="short-description">Tracking code of the request.</p>
  572. <p class="description"><p>Use of this value is undefined. Please do not use it. <strong>Optional. Ignored if null.</strong></p></p>
  573. <ul class="tags">
  574. <li><span class="field">access:</span> private</li>
  575. </ul>
  576. </div>
  577. </div>
  578. </div>
  579. <a name="sec-methods"></a>
  580. <div class="info-box">
  581. <div class="info-box-title">Methods</div>
  582. <div class="nav-bar">
  583. <a href="#sec-description">Description</a> |
  584. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  585. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  586. </div>
  587. <div class="info-box-body">
  588. <A NAME='method_detail'></A>
  589. <a name="methodSloodleResponse" id="SloodleResponse"><!-- --></a>
  590. <div class="oddrow">
  591. <div class="method-header">
  592. <img src="../media/images/Constructor.png" />
  593. <span class="method-title">Constructor SloodleResponse</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a520">520</a></span>)
  594. </div>
  595. <!-- ========== Info from phpDoc block ========= -->
  596. <p class="short-description"><em>Constructor</em><ul><li>can intialise some variables</li></ul></p>
  597. <ul class="tags">
  598. <li><span class="field">access:</span> public</li>
  599. </ul>
  600. <div class="method-signature">
  601. <span class="method-result">void</span>
  602. <span class="method-name">
  603. SloodleResponse
  604. </span>
  605. ([<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>])
  606. </div>
  607. <ul class="parameters">
  608. <li>
  609. <span class="var-type">int</span>
  610. <span class="var-name">$status_code</span><span class="var-description">: The initial status code for the response (optional - ignore if null)</span> </li>
  611. <li>
  612. <span class="var-type">string</span>
  613. <span class="var-name">$status_descriptor</span><span class="var-description">: The initial status descriptor for the response (optional - ignore if null)</span> </li>
  614. <li>
  615. <span class="var-type">mixed</span>
  616. <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/SloodleResponse.html#var$data">SloodleResponse::$data</a>) (optional - ignore if null)</span> </li>
  617. </ul>
  618. </div>
  619. <a name="methodadd_data_line" id="add_data_line"><!-- --></a>
  620. <div class="evenrow">
  621. <div class="method-header">
  622. <img src="../media/images/Method.png" />
  623. <span class="method-title">add_data_line</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a478">478</a></span>)
  624. </div>
  625. <!-- ========== Info from phpDoc block ========= -->
  626. <p class="short-description">Adds one line of data to the $data member</p>
  627. <div class="method-signature">
  628. <span class="method-result">void</span>
  629. <span class="method-name">
  630. add_data_line
  631. </span>
  632. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  633. </div>
  634. <ul class="parameters">
  635. <li>
  636. <span class="var-type">mixed</span>
  637. <span class="var-name">$par</span><span class="var-description">: A scalar, or an array of scalars</span> </li>
  638. </ul>
  639. </div>
  640. <a name="methodadd_side_effect" id="add_side_effect"><!-- --></a>
  641. <div class="oddrow">
  642. <div class="method-header">
  643. <img src="../media/images/Method.png" />
  644. <span class="method-title">add_side_effect</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a326">326</a></span>)
  645. </div>
  646. <!-- ========== Info from phpDoc block ========= -->
  647. <p class="short-description">Adds a single side effect code to member $status_code</p>
  648. <div class="method-signature">
  649. <span class="method-result">void</span>
  650. <span class="method-name">
  651. add_side_effect
  652. </span>
  653. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  654. </div>
  655. <ul class="parameters">
  656. <li>
  657. <span class="var-type">integer</span>
  658. <span class="var-name">$par</span><span class="var-description">: An integer side-effect code.</span> </li>
  659. </ul>
  660. </div>
  661. <a name="methodadd_side_effects" id="add_side_effects"><!-- --></a>
  662. <div class="evenrow">
  663. <div class="method-header">
  664. <img src="../media/images/Method.png" />
  665. <span class="method-title">add_side_effects</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a285">285</a></span>)
  666. </div>
  667. <!-- ========== Info from phpDoc block ========= -->
  668. <p class="short-description">Adds one or more integer side effect codes to member $status_code.</p>
  669. <div class="method-signature">
  670. <span class="method-result">void</span>
  671. <span class="method-name">
  672. add_side_effects
  673. </span>
  674. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  675. </div>
  676. <ul class="parameters">
  677. <li>
  678. <span class="var-type">mixed</span>
  679. <span class="var-name">$par</span><span class="var-description">: An integer side effect code, or an array of them.</span> </li>
  680. </ul>
  681. </div>
  682. <a name="methodclear_data" id="clear_data"><!-- --></a>
  683. <div class="oddrow">
  684. <div class="method-header">
  685. <img src="../media/images/Method.png" />
  686. <span class="method-title">clear_data</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a504">504</a></span>)
  687. </div>
  688. <!-- ========== Info from phpDoc block ========= -->
  689. <p class="short-description">Clears all data from member $data</p>
  690. <div class="method-signature">
  691. <span class="method-result">void</span>
  692. <span class="method-name">
  693. clear_data
  694. </span>
  695. ()
  696. </div>
  697. </div>
  698. <a name="methodget_field_separator" id="get_field_separator"><!-- --></a>
  699. <div class="evenrow">
  700. <div class="method-header">
  701. <img src="../media/images/Method.png" />
  702. <span class="method-title">get_field_separator</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a214">214</a></span>)
  703. </div>
  704. <!-- ========== Info from phpDoc block ========= -->
  705. <p class="short-description">Gets the field separator.</p>
  706. <ul class="tags">
  707. <li><span class="field">return:</span> The current field separator string</li>
  708. </ul>
  709. <div class="method-signature">
  710. <span class="method-result">string</span>
  711. <span class="method-name">
  712. get_field_separator
  713. </span>
  714. ()
  715. </div>
  716. </div>
  717. <a name="methodget_line_separator" id="get_line_separator"><!-- --></a>
  718. <div class="oddrow">
  719. <div class="method-header">
  720. <img src="../media/images/Method.png" />
  721. <span class="method-title">get_line_separator</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a194">194</a></span>)
  722. </div>
  723. <!-- ========== Info from phpDoc block ========= -->
  724. <p class="short-description">Gets the line separator.</p>
  725. <ul class="tags">
  726. <li><span class="field">return:</span> The current line separator string</li>
  727. </ul>
  728. <div class="method-signature">
  729. <span class="method-result">string</span>
  730. <span class="method-name">
  731. get_line_separator
  732. </span>
  733. ()
  734. </div>
  735. </div>
  736. <a name="methodquick_output" id="quick_output"><!-- --></a>
  737. <div class="evenrow">
  738. <div class="method-header">
  739. <img src="../media/images/Method.png" />
  740. <span class="method-title">quick_output</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a697">697</a></span>)
  741. </div>
  742. <!-- ========== Info from phpDoc block ========= -->
  743. <p class="short-description">Quick output of data to avoid several accessor calls if the response is very basic.</p>
  744. <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>
  745. <ul class="tags">
  746. <li><span class="field">access:</span> public</li>
  747. </ul>
  748. <div class="method-signature">
  749. <span class="method-result">void</span>
  750. <span class="method-name">
  751. quick_output
  752. </span>
  753. (<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>])
  754. </div>
  755. <ul class="parameters">
  756. <li>
  757. <span class="var-type">int</span>
  758. <span class="var-name">$status_code</span><span class="var-description">: The status code for the response (required)</span> </li>
  759. <li>
  760. <span class="var-type">string</span>
  761. <span class="var-name">$status_descriptor</span><span class="var-description">: The status descriptor for the response (optional - ignored if null)</span> </li>
  762. <li>
  763. <span class="var-type">mixed</span>
  764. <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/SloodleResponse.html#var$data">SloodleResponse::$data</a>) (optional - ignored if null)</span> </li>
  765. <li>
  766. <span class="var-type">bool</span>
  767. <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>
  768. </ul>
  769. </div>
  770. <a name="methodrender_to_output" id="render_to_output"><!-- --></a>
  771. <div class="oddrow">
  772. <div class="method-header">
  773. <img src="../media/images/Method.png" />
  774. <span class="method-title">render_to_output</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a669">669</a></span>)
  775. </div>
  776. <!-- ========== Info from phpDoc block ========= -->
  777. <p class="short-description">Outputs the response directly to the HTTP response.</p>
  778. <ul class="tags">
  779. <li><span class="field">access:</span> public</li>
  780. <li><span class="field">uses:</span> <a href="../sloodle/SloodleResponse.html#methodrender_to_string">SloodleResponse::render_to_string()</a> - Outputs the result from this function directly to the HTTP response stream.</li>
  781. </ul>
  782. <div class="method-signature">
  783. <span class="method-result">void</span>
  784. <span class="method-name">
  785. render_to_output
  786. </span>
  787. ()
  788. </div>
  789. </div>
  790. <a name="methodrender_to_string" id="render_to_string"><!-- --></a>
  791. <div class="evenrow">
  792. <div class="method-header">
  793. <img src="../media/images/Method.png" />
  794. <span class="method-title">render_to_string</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a537">537</a></span>)
  795. </div>
  796. <!-- ========== Info from phpDoc block ========= -->
  797. <p class="short-description">Renders the response to a string.</p>
  798. <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>
  799. <ul class="tags">
  800. <li><span class="field">access:</span> public</li>
  801. <li><span class="field">usedby:</span> <a href="../sloodle/SloodleResponse.html#methodrender_to_output">SloodleResponse::render_to_output()</a> - Outputs the result from this function directly to the HTTP response stream.</li>
  802. </ul>
  803. <div class="method-signature">
  804. <span class="method-result">void</span>
  805. <span class="method-name">
  806. render_to_string
  807. </span>
  808. (<span class="var-type">string</span>&nbsp;<span class="var-name">&$str</span>)
  809. </div>
  810. <ul class="parameters">
  811. <li>
  812. <span class="var-type">string</span>
  813. <span class="var-name">&$str</span><span class="var-description">: Reference to a string object which the response should be rendered to.</span> </li>
  814. </ul>
  815. </div>
  816. <a name="methodset_avatar_uuid" id="set_avatar_uuid"><!-- --></a>
  817. <div class="oddrow">
  818. <div class="method-header">
  819. <img src="../media/images/Method.png" />
  820. <span class="method-title">set_avatar_uuid</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a384">384</a></span>)
  821. </div>
  822. <!-- ========== Info from phpDoc block ========= -->
  823. <p class="short-description">Accessor function to set member value $avatar_uuid</p>
  824. <div class="method-signature">
  825. <span class="method-result">void</span>
  826. <span class="method-name">
  827. set_avatar_uuid
  828. </span>
  829. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  830. </div>
  831. <ul class="parameters">
  832. <li>
  833. <span class="var-type">mixed</span>
  834. <span class="var-name">$par</span><span class="var-description">: A string containing a UUID, or null to clear it</span> </li>
  835. </ul>
  836. </div>
  837. <a name="methodset_data" id="set_data"><!-- --></a>
  838. <div class="evenrow">
  839. <div class="method-header">
  840. <img src="../media/images/Method.png" />
  841. <span class="method-title">set_data</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a439">439</a></span>)
  842. </div>
  843. <!-- ========== Info from phpDoc block ========= -->
  844. <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>
  845. <div class="method-signature">
  846. <span class="method-result">void</span>
  847. <span class="method-name">
  848. set_data
  849. </span>
  850. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  851. </div>
  852. <ul class="parameters">
  853. <li>
  854. <span class="var-type">mixed</span>
  855. <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>
  856. </ul>
  857. </div>
  858. <a name="methodset_field_separator" id="set_field_separator"><!-- --></a>
  859. <div class="oddrow">
  860. <div class="method-header">
  861. <img src="../media/images/Method.png" />
  862. <span class="method-title">set_field_separator</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a205">205</a></span>)
  863. </div>
  864. <!-- ========== Info from phpDoc block ========= -->
  865. <p class="short-description">Sets the field separator.</p>
  866. <div class="method-signature">
  867. <span class="method-result">void</span>
  868. <span class="method-name">
  869. set_field_separator
  870. </span>
  871. (<span class="var-type">string</span>&nbsp;<span class="var-name">$sep</span>)
  872. </div>
  873. <ul class="parameters">
  874. <li>
  875. <span class="var-type">string</span>
  876. <span class="var-name">$sep</span><span class="var-description">: A string to separate fields</span> </li>
  877. </ul>
  878. </div>
  879. <a name="methodset_line_separator" id="set_line_separator"><!-- --></a>
  880. <div class="evenrow">
  881. <div class="method-header">
  882. <img src="../media/images/Method.png" />
  883. <span class="method-title">set_line_separator</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a185">185</a></span>)
  884. </div>
  885. <!-- ========== Info from phpDoc block ========= -->
  886. <p class="short-description">Sets the line separator.</p>
  887. <div class="method-signature">
  888. <span class="method-result">void</span>
  889. <span class="method-name">
  890. set_line_separator
  891. </span>
  892. (<span class="var-type">string</span>&nbsp;<span class="var-name">$sep</span>)
  893. </div>
  894. <ul class="parameters">
  895. <li>
  896. <span class="var-type">string</span>
  897. <span class="var-name">$sep</span><span class="var-description">: A string to separate lines</span> </li>
  898. </ul>
  899. </div>
  900. <a name="methodset_page_number" id="set_page_number"><!-- --></a>
  901. <div class="oddrow">
  902. <div class="method-header">
  903. <img src="../media/images/Method.png" />
  904. <span class="method-title">set_page_number</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a424">424</a></span>)
  905. </div>
  906. <!-- ========== Info from phpDoc block ========= -->
  907. <p class="short-description">Accessor function to set member value $page_number</p>
  908. <div class="method-signature">
  909. <span class="method-result">void</span>
  910. <span class="method-name">
  911. set_page_number
  912. </span>
  913. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  914. </div>
  915. <ul class="parameters">
  916. <li>
  917. <span class="var-type">mixed</span>
  918. <span class="var-name">$par</span><span class="var-description">: A positive page number, or null to clear it</span> </li>
  919. </ul>
  920. </div>
  921. <a name="methodset_page_total" id="set_page_total"><!-- --></a>
  922. <div class="evenrow">
  923. <div class="method-header">
  924. <img src="../media/images/Method.png" />
  925. <span class="method-title">set_page_total</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a409">409</a></span>)
  926. </div>
  927. <!-- ========== Info from phpDoc block ========= -->
  928. <p class="short-description">Accessor function to set member value $page_total</p>
  929. <div class="method-signature">
  930. <span class="method-result">void</span>
  931. <span class="method-name">
  932. set_page_total
  933. </span>
  934. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  935. </div>
  936. <ul class="parameters">
  937. <li>
  938. <span class="var-type">mixed</span>
  939. <span class="var-name">$par</span><span class="var-description">: A positive page total count, or null to clear it</span> </li>
  940. </ul>
  941. </div>
  942. <a name="methodset_request_descriptor" id="set_request_descriptor"><!-- --></a>
  943. <div class="oddrow">
  944. <div class="method-header">
  945. <img src="../media/images/Method.png" />
  946. <span class="method-title">set_request_descriptor</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a339">339</a></span>)
  947. </div>
  948. <!-- ========== Info from phpDoc block ========= -->
  949. <p class="short-description">Accessor function to set member value $request_descriptor</p>
  950. <div class="method-signature">
  951. <span class="method-result">void</span>
  952. <span class="method-name">
  953. set_request_descriptor
  954. </span>
  955. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  956. </div>
  957. <ul class="parameters">
  958. <li>
  959. <span class="var-type">mixed</span>
  960. <span class="var-name">$par</span><span class="var-description">: A string request descriptor, or null to clear it</span> </li>
  961. </ul>
  962. </div>
  963. <a name="methodset_request_timestamp" id="set_request_timestamp"><!-- --></a>
  964. <div class="evenrow">
  965. <div class="method-header">
  966. <img src="../media/images/Method.png" />
  967. <span class="method-title">set_request_timestamp</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a354">354</a></span>)
  968. </div>
  969. <!-- ========== Info from phpDoc block ========= -->
  970. <p class="short-description">Accessor function to set member value $request_timestamp</p>
  971. <div class="method-signature">
  972. <span class="method-result">void</span>
  973. <span class="method-name">
  974. set_request_timestamp
  975. </span>
  976. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  977. </div>
  978. <ul class="parameters">
  979. <li>
  980. <span class="var-type">mixed</span>
  981. <span class="var-name">$par</span><span class="var-description">: An integer timestamp, or null to clear it</span> </li>
  982. </ul>
  983. </div>
  984. <a name="methodset_response_timestamp" id="set_response_timestamp"><!-- --></a>
  985. <div class="oddrow">
  986. <div class="method-header">
  987. <img src="../media/images/Method.png" />
  988. <span class="method-title">set_response_timestamp</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a369">369</a></span>)
  989. </div>
  990. <!-- ========== Info from phpDoc block ========= -->
  991. <p class="short-description">Accessor function to set member value $response_timestamp</p>
  992. <div class="method-signature">
  993. <span class="method-result">void</span>
  994. <span class="method-name">
  995. set_response_timestamp
  996. </span>
  997. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  998. </div>
  999. <ul class="parameters">
  1000. <li>
  1001. <span class="var-type">mixed</span>
  1002. <span class="var-name">$par</span><span class="var-description">: An integer timestamp, or null to clear it</span> </li>
  1003. </ul>
  1004. </div>
  1005. <a name="methodset_side_effects" id="set_side_effects"><!-- --></a>
  1006. <div class="evenrow">
  1007. <div class="method-header">
  1008. <img src="../media/images/Method.png" />
  1009. <span class="method-title">set_side_effects</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a255">255</a></span>)
  1010. </div>
  1011. <!-- ========== Info from phpDoc block ========= -->
  1012. <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>
  1013. <div class="method-signature">
  1014. <span class="method-result">void</span>
  1015. <span class="method-name">
  1016. set_side_effects
  1017. </span>
  1018. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  1019. </div>
  1020. <ul class="parameters">
  1021. <li>
  1022. <span class="var-type">mixed</span>
  1023. <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>
  1024. </ul>
  1025. </div>
  1026. <a name="methodset_status_code" id="set_status_code"><!-- --></a>
  1027. <div class="oddrow">
  1028. <div class="method-header">
  1029. <img src="../media/images/Method.png" />
  1030. <span class="method-title">set_status_code</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a225">225</a></span>)
  1031. </div>
  1032. <!-- ========== Info from phpDoc block ========= -->
  1033. <p class="short-description">Accessor function to set member value $status_code</p>
  1034. <div class="method-signature">
  1035. <span class="method-result">void</span>
  1036. <span class="method-name">
  1037. set_status_code
  1038. </span>
  1039. (<span class="var-type">integer</span>&nbsp;<span class="var-name">$par</span>)
  1040. </div>
  1041. <ul class="parameters">
  1042. <li>
  1043. <span class="var-type">integer</span>
  1044. <span class="var-name">$par</span><span class="var-description">: A non-zero status code</span> </li>
  1045. </ul>
  1046. </div>
  1047. <a name="methodset_status_descriptor" id="set_status_descriptor"><!-- --></a>
  1048. <div class="evenrow">
  1049. <div class="method-header">
  1050. <img src="../media/images/Method.png" />
  1051. <span class="method-title">set_status_descriptor</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a240">240</a></span>)
  1052. </div>
  1053. <!-- ========== Info from phpDoc block ========= -->
  1054. <p class="short-description">Accessor function to set member value $status_descriptor</p>
  1055. <div class="method-signature">
  1056. <span class="method-result">void</span>
  1057. <span class="method-name">
  1058. set_status_descriptor
  1059. </span>
  1060. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  1061. </div>
  1062. <ul class="parameters">
  1063. <li>
  1064. <span class="var-type">mixed</span>
  1065. <span class="var-name">$par</span><span class="var-description">: A status descriptor string, or null to clear it</span> </li>
  1066. </ul>
  1067. </div>
  1068. <a name="methodset_tracking_code" id="set_tracking_code"><!-- --></a>
  1069. <div class="oddrow">
  1070. <div class="method-header">
  1071. <img src="../media/images/Method.png" />
  1072. <span class="method-title">set_tracking_code</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a399">399</a></span>)
  1073. </div>
  1074. <!-- ========== Info from phpDoc block ========= -->
  1075. <p class="short-description">Accessor function to set member value $tracking_code</p>
  1076. <div class="method-signature">
  1077. <span class="method-result">void</span>
  1078. <span class="method-name">
  1079. set_tracking_code
  1080. </span>
  1081. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$par</span>)
  1082. </div>
  1083. <ul class="parameters">
  1084. <li>
  1085. <span class="var-type">mixed</span>
  1086. <span class="var-name">$par</span><span class="var-description">: Any scalar value</span> </li>
  1087. </ul>
  1088. </div>
  1089. <a name="method_internal_validation_error" id="_internal_validation_error"><!-- --></a>
  1090. <div class="evenrow">
  1091. <div class="method-header">
  1092. <img src="../media/images/PrivateMethod.png" />
  1093. <span class="method-title">_internal_validation_error</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibio.php.html#a723">723</a></span>)
  1094. </div>
  1095. <!-- ========== Info from phpDoc block ========= -->
  1096. <p class="short-description">Internal function to report a data validation error.</p>
  1097. <p class="description"><p>Outputs an LSL-friendly error message, and terminates the script</p></p>
  1098. <ul class="tags">
  1099. <li><span class="field">access:</span> private</li>
  1100. </ul>
  1101. <div class="method-signature">
  1102. <span class="method-result">void</span>
  1103. <span class="method-name">
  1104. _internal_validation_error
  1105. </span>
  1106. (<span class="var-type">string</span>&nbsp;<span class="var-name">$msg</span>)
  1107. </div>
  1108. <ul class="parameters">
  1109. <li>
  1110. <span class="var-type">string</span>
  1111. <span class="var-name">$msg</span><span class="var-description">: The error message to output.</span> </li>
  1112. </ul>
  1113. </div>
  1114. </div>
  1115. </div>
  1116. <p class="notes" id="credit">
  1117. Documentation generated on Mon, 16 Jun 2008 15:56:25 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
  1118. </p>
  1119. </div></body>
  1120. </html>