produceRetainedState

Return an observable snapshot State that produces values over time without a defined data source.

producer is launched when produceRetainedState enters the composition and is cancelled when produceRetainedState leaves the composition. producer should use ProduceStateScope.value to set new values on the returned State.

The returned State conflates values; no change will be observable if ProduceStateScope.value is used to set a value that is equal to its old value, and observers may only see the latest value if several values are set in rapid succession.

produceRetainedState may be used to observe either suspending or non-suspending sources of external data, for example:

@Composable
fun FavoritesPresenter(favoritesRepository: FavoritesRepository): State {
  val state by produceRetainedState<UiState<List<Person>>>(UiState.Loading, favoritesRepository) {
    favoritesRepository.people
      .map { UiState.Data(it) }
      .collect { value = it }
  }
  return state
}

Return an observable snapshot State that produces values over time from key1.

producer is launched when produceRetainedState enters the composition and is cancelled when produceRetainedState leaves the composition. If key1 changes, a running producer will be cancelled and re-launched for the new source. producer should use ProduceStateScope.value to set new values on the returned State.

The returned State conflates values; no change will be observable if ProduceStateScope.value is used to set a value that is equal to its old value, and observers may only see the latest value if several values are set in rapid succession.

produceRetainedState may be used to observe either suspending or non-suspending sources of external data, for example:

@Composable
fun FavoritesPresenter(favoritesRepository: FavoritesRepository): State {
  val state by produceRetainedState<UiState<List<Person>>>(UiState.Loading, favoritesRepository) {
    favoritesRepository.people
      .map { UiState.Data(it) }
      .collect { value = it }
  }
  return state
}

Return an observable snapshot State that produces values over time from key1 and key2.

producer is launched when produceRetainedState enters the composition and is cancelled when produceRetainedState leaves the composition. If key1 or key2 change, a running producer will be cancelled and re-launched for the new source. producer should use ProduceStateScope.value to set new values on the returned State.

The returned State conflates values; no change will be observable if ProduceStateScope.value is used to set a value that is equal to its old value, and observers may only see the latest value if several values are set in rapid succession.

produceRetainedState may be used to observe either suspending or non-suspending sources of external data, for example:

@Composable
fun FavoritesPresenter(favoritesRepository: FavoritesRepository): State {
  val state by produceRetainedState<UiState<List<Person>>>(UiState.Loading, favoritesRepository) {
    favoritesRepository.people
      .map { UiState.Data(it) }
      .collect { value = it }
  }
  return state
}

Return an observable snapshot State that produces values over time from key1, key2 and key3.

producer is launched when produceRetainedState enters the composition and is cancelled when produceRetainedState leaves the composition. If key1, key2 or key3 change, a running producer will be cancelled and re-launched for the new source. [producer should use ProduceStateScope.value to set new values on the returned State.

The returned State conflates values; no change will be observable if ProduceStateScope.value is used to set a value that is equal to its old value, and observers may only see the latest value if several values are set in rapid succession.

produceRetainedState may be used to observe either suspending or non-suspending sources of external data, for example:

@Composable
fun FavoritesPresenter(favoritesRepository: FavoritesRepository): State {
  val state by produceRetainedState<UiState<List<Person>>>(UiState.Loading, favoritesRepository) {
    favoritesRepository.people
      .map { UiState.Data(it) }
      .collect { value = it }
  }
  return state
}

Return an observable snapshot State that produces values over time from keys.

producer is launched when produceRetainedState enters the composition and is cancelled when produceRetainedState leaves the composition. If keys change, a running producer will be cancelled and re-launched for the new source. producer should use ProduceStateScope.value to set new values on the returned State.

The returned State conflates values; no change will be observable if ProduceStateScope.value is used to set a value that is equal to its old value, and observers may only see the latest value if several values are set in rapid succession.

produceRetainedState may be used to observe either suspending or non-suspending sources of external data, for example:

@Composable
fun FavoritesPresenter(favoritesRepository: FavoritesRepository): State {
  val state by produceRetainedState<UiState<List<Person>>>(UiState.Loading, favoritesRepository) {
    favoritesRepository.people
      .map { UiState.Data(it) }
      .collect { value = it }
  }
  return state
}