Struct SearchArtistsIterator 

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

Iterator for searching artists in the user’s library.

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

Implementations

impl<C: LastFmEditClient> SearchArtistsIterator<C>

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

Create a new search artists iterator.

This is typically called via LastFmEditClient::search_artists.

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

Create a new search artists 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<ArtistPage>>

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<Artist> for SearchArtistsIterator<C>

fn next<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Option<Artist>>> + '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.