| Interface | osid.contact.AddressBookList | ||
|---|---|---|---|
| Implements | osid.OsidList | ||
| Description | 
                 Like all  
                     
                     
                     while (abl.hasNext()) {
                          AddressBook book = abl.getNextAddressBook();
                     }
                     
                                 
                     
                
                or 
                
                     
                     
                     while (abl.hasNext()) {
                          AddressBook[] books = abl.getNextAddressBooks(abl.available());
                     }
                     
                                 
                     
                
                 | ||
| Method | getNextAddressBook | ||
| Description | 
                     Gets the next   | ||
| Return | osid.contact.AddressBook | the next  AddressBook  in this list. The  hasNext() 
 method should be used to test that a next  AddressBook  
is available before calling this method.  | |
| Errors | ILLEGAL_STATE | no more elements available in this list | |
| OPERATION_FAILED | unable to complete request | ||
| Compliance | mandatory | This method must be implemented. | |
| Method | getNextAddressBooks | ||
| Description | 
                     Gets the next set of   | ||
| Parameters | cardinal | n | the number of  AddressBook  elements requested which must be 
less than or equal to  available()   | 
| Return | osid.contact.AddressBook[] | an array of  AddressBook  elements.   The length 
of the array is less than or equal to the number specified.  | |
| Errors | ILLEGAL_STATE | no more elements available in this list | |
| OPERATION_FAILED | unable to complete request | ||
| Compliance | mandatory | This method must be implemented. | |