Source for file GradableObjectIterator.php

Documentation is available at GradableObjectIterator.php

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

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