Source for file MessageIterator.php

Documentation is available at MessageIterator.php

  1. <?php
  2. /**
  3. * MessageIterator 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.usermessaging
  22. */
  23. class MessageIterator
  24. {
  25. /**
  26. * Return true if there is an additional Message ; false otherwise.
  27. *
  28. * @return boolean
  29. *
  30. * @throws object UsermessagingException An exception with
  31. * one of the following messages defined in
  32. * org.osid.usermessaging.UsermessagingException may be thrown:
  33. * {@link }
  34. * org.osid.usermessaging.UsermessagingException#OPERATION_FAILED
  35. * OPERATION_FAILED}, {@link }
  36. * org.osid.usermessaging.UsermessagingException#PERMISSION_DENIED
  37. * PERMISSION_DENIED}, {@link }
  38. * org.osid.usermessaging.UsermessagingException#CONFIGURATION_ERROR
  39. * CONFIGURATION_ERROR}, {@link }
  40. * org.osid.usermessaging.UsermessagingException#UNIMPLEMENTED
  41. * UNIMPLEMENTED}
  42. *
  43. * @access public
  44. */
  45. function hasNextMessage () {
  46. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  47. }
  48.  
  49. /**
  50. * Return the next Message.
  51. *
  52. * @return object Message
  53. *
  54. * @throws object UsermessagingException An exception with
  55. * one of the following messages defined in
  56. * org.osid.usermessaging.UsermessagingException may be thrown:
  57. * {@link }
  58. * org.osid.usermessaging.UsermessagingException#OPERATION_FAILED
  59. * OPERATION_FAILED}, {@link }
  60. * org.osid.usermessaging.UsermessagingException#PERMISSION_DENIED
  61. * PERMISSION_DENIED}, {@link }
  62. * org.osid.usermessaging.UsermessagingException#CONFIGURATION_ERROR
  63. * CONFIGURATION_ERROR}, {@link }
  64. * org.osid.usermessaging.UsermessagingException#UNIMPLEMENTED
  65. * UNIMPLEMENTED}, {@link }
  66. * org.osid.usermessaging.UsermessagingException#NO_MORE_ITERATOR_ELEMENTS
  67. * NO_MORE_ITERATOR_ELEMENTS}
  68. *
  69. * @access public
  70. */
  71. function nextMessage () {
  72. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  73. }
  74. }
  75.  
  76. ?>

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