Source for file TermIterator.php

Documentation is available at TermIterator.php

  1. <?php
  2. /**
  3. * TermIterator provides access to Terms. Term provides access to these
  4. * objects sequentially, one at a time. The purpose of all Iterators is to to
  5. * offer a way for OSID methods to return multiple values of a common type and
  6. * not use an array. Returning an array may not be appropriate if the number
  7. * of values returned is large or is fetched remotely. Iterators do not allow
  8. * access to values by index, rather you must access values in sequence.
  9. * Similarly, there is no way to go backwards through the sequence unless you
  10. * place the values in a data structure, such as an array, that allows for
  11. * access by index.
  12. *
  13. * <p>
  14. * OSID Version: 2.0
  15. * </p>
  16. *
  17. * <p>
  18. * Licensed under the {@link org.osid.SidImplementationLicenseMIT MIT}
  19. * O.K.I&#46; OSID Definition License}.
  20. * </p>
  21. *
  22. * @package org.osid.coursemanagement
  23. */
  24. class TermIterator
  25. {
  26. /**
  27. * Return true if there is an additional Term ; false otherwise.
  28. *
  29. * @return boolean
  30. *
  31. * @throws object CourseManagementException An exception
  32. * with one of the following messages defined in
  33. * org.osid.coursemanagement.CourseManagementException may be
  34. * thrown: {@link }
  35. * org.osid.coursemanagement.CourseManagementException#OPERATION_FAILED
  36. * OPERATION_FAILED}, {@link }
  37. * org.osid.coursemanagement.CourseManagementException#PERMISSION_DENIED
  38. * PERMISSION_DENIED}, {@link }
  39. * org.osid.coursemanagement.CourseManagementException#CONFIGURATION_ERROR
  40. * CONFIGURATION_ERROR}, {@link }
  41. * org.osid.coursemanagement.CourseManagementException#UNIMPLEMENTED
  42. * UNIMPLEMENTED}
  43. *
  44. * @access public
  45. */
  46. function hasNextTerm () {
  47. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  48. }
  49.  
  50. /**
  51. * Return the next Term.
  52. *
  53. * @return object Term
  54. *
  55. * @throws object CourseManagementException An exception
  56. * with one of the following messages defined in
  57. * org.osid.coursemanagement.CourseManagementException may be
  58. * thrown: {@link }
  59. * org.osid.coursemanagement.CourseManagementException#OPERATION_FAILED
  60. * OPERATION_FAILED}, {@link }
  61. * org.osid.coursemanagement.CourseManagementException#PERMISSION_DENIED
  62. * PERMISSION_DENIED}, {@link }
  63. * org.osid.coursemanagement.CourseManagementException#CONFIGURATION_ERROR
  64. * CONFIGURATION_ERROR}, {@link }
  65. * org.osid.coursemanagement.CourseManagementException#UNIMPLEMENTED
  66. * UNIMPLEMENTED}, {@link }
  67. * org.osid.coursemanagement.CourseManagementException#NO_MORE_ITERATOR_ELEMENTS
  68. * NO_MORE_ITERATOR_ELEMENTS}
  69. *
  70. * @access public
  71. */
  72. function nextTerm () {
  73. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  74. }
  75. }
  76.  
  77. ?>

Documentation generated on Wed, 19 Sep 2007 10:27:14 -0400 by phpDocumentor 1.3.0RC3