Source for file PropertiesIterator.php

Documentation is available at PropertiesIterator.php

  1. <?php
  2. /**
  3. * PropertiesIterator provides access to these objects sequentially, one at a
  4. * 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.shared
  22. */
  23. class PropertiesIterator
  24. {
  25. /**
  26. * Return true if there is an additional Properties object ; false
  27. * otherwise.
  28. *
  29. * @return boolean
  30. *
  31. * @throws object SharedException An exception with one of the
  32. * following messages defined in org.osid.shared.SharedException
  33. * may be thrown: {@link }
  34. * org.osid.shared.SharedException#UNKNOWN_TYPE UNKNOWN_TYPE},
  35. * {@link org.osid.shared.SharedException#PERMISSION_DENIED}
  36. * PERMISSION_DENIED}, {@link }
  37. * org.osid.shared.SharedException#CONFIGURATION_ERROR
  38. * CONFIGURATION_ERROR}, {@link }
  39. * org.osid.shared.SharedException#UNIMPLEMENTED UNIMPLEMENTED}
  40. *
  41. * @access public
  42. */
  43. function hasNextProperties () {
  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 Properties.
  49. *
  50. * @return object Properties
  51. *
  52. * @throws object SharedException An exception with one of the
  53. * following messages defined in org.osid.shared.SharedException
  54. * may be thrown: {@link }
  55. * org.osid.shared.SharedException#UNKNOWN_TYPE UNKNOWN_TYPE},
  56. * {@link org.osid.shared.SharedException#PERMISSION_DENIED}
  57. * PERMISSION_DENIED}, {@link }
  58. * org.osid.shared.SharedException#CONFIGURATION_ERROR
  59. * CONFIGURATION_ERROR}, {@link }
  60. * org.osid.shared.SharedException#UNIMPLEMENTED UNIMPLEMENTED},
  61. * {@link }
  62. * org.osid.shared.SharedException#NO_MORE_ITERATOR_ELEMENTS
  63. * NO_MORE_ITERATOR_ELEMENTS}
  64. *
  65. * @access public
  66. */
  67. function nextProperties () {
  68. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  69. }
  70. }
  71.  
  72. ?>

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