Cubit<State> class
abstract
A Cubit is similar to Bloc but has no notion of events and relies on methods to emit new states.
Every Cubit requires an initial state which will be the state of the Cubit before emit has been called.
The current state of a Cubit can be accessed via the state getter.
class CounterCubit extends Cubit<int> {
CounterCubit() : super(0);
void increment() => emit(state + 1);
}
Constructors
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- isClosed → bool
-
Whether the bloc is closed.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- state → State
-
The current state.
no setterinherited
-
stream
→ Stream<
State> -
The current state stream.
no setterinherited
Methods
-
addError(
Object error, [StackTrace? stackTrace]) → void -
Reports an
errorwhich triggers onError with an optional StackTrace.inherited -
close(
) → Future< void> -
Closes the instance.
This method should be called when the instance is no longer needed.
Once close is called, the instance can no longer be used.
inherited
-
emit(
State state) → void -
Updates the
stateto the providedstate. emit does nothing if the instance has been closed or if thestatebeing emitted is equal to the currentstate.inherited -
listen(
void onData(State)?, {Function? onError, void onDone()?, bool? cancelOnError}) → StreamSubscription< State> -
Adds a subscription to the
Stream<State>. Returns a StreamSubscription which handles events from theStream<State>using the providedonData,onErrorandonDonehandlers.inherited -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
onChange(
Change< State> change) → void -
Called whenever a
changeoccurs with the givenchange. Achangeoccurs when a newstateis emitted. onChange is called before thestateof thecubitis updated. onChange is a great spot to add logging/analytics for a specificcubit.inherited -
onError(
Object error, StackTrace stackTrace) → void -
Called whenever an
erroroccurs and notifies BlocObserver.onError.inherited -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited