Struct SearchAlbumsIterator 

pub struct SearchAlbumsIterator<C: LastFmEditClient> { /* private fields */ }

Iterator for searching albums in the user’s library.

This iterator provides paginated access to albums that match a search query in the authenticated user’s Last.fm library, using Last.fm’s built-in search functionality.

Examples

Implementations

impl<C: LastFmEditClient> SearchAlbumsIterator<C>

pub fn new(client: C, query: String) -> Self

Create a new search albums iterator.

This is typically called via LastFmEditClient::search_albums.

pub fn with_starting_page(client: C, query: String, starting_page: u32) -> Self

Create a new search albums iterator starting from a specific page.

This is useful for implementing offset functionality efficiently by starting at the appropriate page rather than iterating through all previous pages.

pub async fn next_page(&mut self) -> Result<Option<AlbumPage>>

Fetch the next page of search results.

This method handles pagination automatically and includes rate limiting to be respectful to Last.fm’s servers.

pub fn total_pages(&self) -> Option<u32>

Get the total number of pages, if known.

Returns None until at least one page has been fetched.

Trait Implementations

impl<C: LastFmEditClient> AsyncPaginatedIterator<Album> for SearchAlbumsIterator<C>

fn next<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Option<Album>>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch the next item from the iterator.

fn current_page(&self) -> u32

Get the current page number (0-indexed).

fn total_pages(&self) -> Option<u32>

Get the total number of pages, if known.

fn collect_all<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Vec<T>>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Collect all remaining items into a Vec.

fn take<'life0, 'async_trait>( &'life0 mut self, n: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<T>>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Take up to n items from the iterator.