Generic Structure

Publishers.SetFailureType

A publisher that appears to send a specified failure type.

Declaration

struct SetFailureType<Upstream, Failure> where Upstream : Publisher, Failure : Error, Upstream.Failure == Never

Overview

The publisher cannot actually fail with the specified type and instead just finishes normally. Use this publisher type when you need to match the error types for two mismatched publishers.

Topics

Initializers

init(upstream: Upstream)

Creates a publisher that appears to send a specified failure type.

Instance Properties

let upstream: Upstream

The publisher from which this publisher receives elements.

Instance Methods

func allSatisfy((Upstream.Output) -> Bool) -> Publishers.AllSatisfy<Publishers.SetFailureType<Upstream, Failure>>

Publishes a single Boolean value that indicates whether all received elements pass a given predicate.

func assertNoFailure(String, file: StaticString, line: UInt) -> Publishers.AssertNoFailure<Publishers.SetFailureType<Upstream, Failure>>

Raises a fatal error when its upstream publisher fails, and otherwise republishes all received input.

func assign<Root>(to: ReferenceWritableKeyPath<Root, Upstream.Output>, on: Root) -> AnyCancellable

Assigns a publisher’s output to a property of an object.

func `catch`<P>((Failure) -> P) -> Publishers.Catch<Publishers.SetFailureType<Upstream, Failure>, P>

Handles errors from an upstream publisher by replacing it with another publisher.

func collect() -> Publishers.Collect<Publishers.SetFailureType<Upstream, Failure>>

Collects all received elements, and emits a single array of the collection when the upstream publisher finishes.

func collect(Int) -> Publishers.CollectByCount<Publishers.SetFailureType<Upstream, Failure>>

Collects up to the specified number of elements, and then emits a single array of the collection.

func combineLatest<P>(P) -> Publishers.CombineLatest<Publishers.SetFailureType<Upstream, Failure>, P>

Subscribes to an additional publisher and publishes a tuple upon receiving output from either publisher.

func combineLatest<P, Q>(P, Q) -> Publishers.CombineLatest3<Publishers.SetFailureType<Upstream, Failure>, P, Q>

Subscribes to two additional publishers and publishes a tuple upon receiving output from any of the publishers.

func combineLatest<P, Q, R>(P, Q, R) -> Publishers.CombineLatest4<Publishers.SetFailureType<Upstream, Failure>, P, Q, R>

Subscribes to three additional publishers and publishes a tuple upon receiving output from any of the publishers.

func compactMap<T>((Upstream.Output) -> T?) -> Publishers.CompactMap<Publishers.SetFailureType<Upstream, Failure>, T>

Calls a closure with each received element and publishes any returned optional that has a value.

func contains(Upstream.Output) -> Publishers.Contains<Publishers.SetFailureType<Upstream, Failure>>

Publishes a Boolean value upon receiving an element equal to the argument.

func contains(where: (Upstream.Output) -> Bool) -> Publishers.ContainsWhere<Publishers.SetFailureType<Upstream, Failure>>

Publishes a Boolean value upon receiving an element that satisfies the predicate closure.

func count() -> Publishers.Count<Publishers.SetFailureType<Upstream, Failure>>

Publishes the number of elements received from the upstream publisher.

func drop<P>(untilOutputFrom: P) -> Publishers.DropUntilOutput<Publishers.SetFailureType<Upstream, Failure>, P>

Ignores elements from the upstream publisher until it receives an element from a second publisher.

func drop(while: (Upstream.Output) -> Bool) -> Publishers.DropWhile<Publishers.SetFailureType<Upstream, Failure>>

Omits elements from the upstream publisher until a given closure returns false, before republishing all remaining elements.

func dropFirst(Int) -> Publishers.Drop<Publishers.SetFailureType<Upstream, Failure>>

Omits the specified number of elements before republishing subsequent elements.

func encode<Coder>(encoder: Coder) -> Publishers.Encode<Publishers.SetFailureType<Upstream, Failure>, Coder>

Encodes the output from upstream using a specified encoder.

func first() -> Publishers.First<Publishers.SetFailureType<Upstream, Failure>>

Publishes the first element of a stream, then finishes.

func first(where: (Upstream.Output) -> Bool) -> Publishers.FirstWhere<Publishers.SetFailureType<Upstream, Failure>>

Publishes the first element of a stream to satisfy a predicate closure, then finishes.

func ignoreOutput() -> Publishers.IgnoreOutput<Publishers.SetFailureType<Upstream, Failure>>

Ingores all upstream elements, but passes along a completion state (finished or failed).

func last() -> Publishers.Last<Publishers.SetFailureType<Upstream, Failure>>

Publishes only the last element of a stream, after the stream finishes.

func last(where: (Upstream.Output) -> Bool) -> Publishers.LastWhere<Publishers.SetFailureType<Upstream, Failure>>

Publishes only the last element of a stream that satisfies a predicate closure, after the stream finishes.

func makeConnectable() -> Publishers.MakeConnectable<Publishers.SetFailureType<Upstream, Failure>>

Creates a connectable wrapper around the publisher.

func map<T>((Upstream.Output) -> T) -> Publishers.Map<Publishers.SetFailureType<Upstream, Failure>, T>

Transforms all elements from the upstream publisher with a provided closure.

func max() -> Publishers.Comparison<Publishers.SetFailureType<Upstream, Failure>>

Publishes the maximum value received from the upstream publisher, after it finishes.

func max(by: (Upstream.Output, Upstream.Output) -> Bool) -> Publishers.Comparison<Publishers.SetFailureType<Upstream, Failure>>

Publishes the maximum value received from the upstream publisher, using the provided ordering closure.

func merge(with: Publishers.SetFailureType<Upstream, Failure>) -> Publishers.MergeMany<Publishers.SetFailureType<Upstream, Failure>>

Combines elements from this publisher with those from another publisher of the same type, delivering an interleaved sequence of elements.

func merge<B, C>(with: B, C) -> Publishers.Merge3<Publishers.SetFailureType<Upstream, Failure>, B, C>

Combines elements from this publisher with those from two other publishers, delivering an interleaved sequence of elements.

func merge<B, C, D>(with: B, C, D) -> Publishers.Merge4<Publishers.SetFailureType<Upstream, Failure>, B, C, D>

Combines elements from this publisher with those from three other publishers, delivering an interleaved sequence of elements.

func merge<B, C, D, E>(with: B, C, D, E) -> Publishers.Merge5<Publishers.SetFailureType<Upstream, Failure>, B, C, D, E>

Combines elements from this publisher with those from four other publishers, delivering an interleaved sequence of elements.

func merge<B, C, D, E, F>(with: B, C, D, E, F) -> Publishers.Merge6<Publishers.SetFailureType<Upstream, Failure>, B, C, D, E, F>

Combines elements from this publisher with those from five other publishers, delivering an interleaved sequence of elements.

func merge<B, C, D, E, F, G>(with: B, C, D, E, F, G) -> Publishers.Merge7<Publishers.SetFailureType<Upstream, Failure>, B, C, D, E, F, G>

Combines elements from this publisher with those from six other publishers, delivering an interleaved sequence of elements.

func merge<B, C, D, E, F, G, H>(with: B, C, D, E, F, G, H) -> Publishers.Merge8<Publishers.SetFailureType<Upstream, Failure>, B, C, D, E, F, G, H>

Combines elements from this publisher with those from seven other publishers, delivering an interleaved sequence of elements.

func min() -> Publishers.Comparison<Publishers.SetFailureType<Upstream, Failure>>

Publishes the minimum value received from the upstream publisher, after it finishes.

func multicast<S>(() -> S) -> Publishers.Multicast<Publishers.SetFailureType<Upstream, Failure>, S>

Applies a closure to create a subject that delivers elements to subscribers.

func output(at: Int) -> Publishers.Output<Publishers.SetFailureType<Upstream, Failure>>

Publishes a specific element, indicated by its index in the sequence of published elements.

func output<R>(in: R) -> Publishers.Output<Publishers.SetFailureType<Upstream, Failure>>

Publishes elements specified by their range in the sequence of published elements.

func prefix(while: (Upstream.Output) -> Bool) -> Publishers.PrefixWhile<Publishers.SetFailureType<Upstream, Failure>>

Republishes elements while a predicate closure indicates publishing should continue.

func reduce<T>(T, (T, Upstream.Output) -> T) -> Publishers.Reduce<Publishers.SetFailureType<Upstream, Failure>, T>

Applies a closure that accumulates each element of a stream and publishes a final result upon completion.

func removeDuplicates() -> Publishers.RemoveDuplicates<Publishers.SetFailureType<Upstream, Failure>>

Publishes only elements that don’t match the previous element.

func removeDuplicates(by: (Upstream.Output, Upstream.Output) -> Bool) -> Publishers.RemoveDuplicates<Publishers.SetFailureType<Upstream, Failure>>

Publishes only elements that don’t match the previous element, as evaluated by a provided closure.

func retry(Int) -> Publishers.Retry<Publishers.SetFailureType<Upstream, Failure>>

Attempts to recreate a failed subscription with the upstream publisher using a specified number of attempts to establish the connection.

func scan<T>(T, (T, Upstream.Output) -> T) -> Publishers.Scan<Publishers.SetFailureType<Upstream, Failure>, T>

Transforms elements from the upstream publisher by providing the current element to a closure along with the last value returned by the closure.

func setFailureType<E>(to: E.Type) -> Publishers.SetFailureType<Publishers.SetFailureType<Upstream, Failure>, E>

Changes the failure type declared by the upstream publisher.

func sink(receiveValue: ((Upstream.Output) -> Void)) -> AnyCancellable

Attaches a subscriber with closure-based behavior to a publisher that never fails.

func subscribe<S>(S) -> AnyCancellable

Attaches the specified subject to this publisher.

func subscribe<S>(S)

Attaches the specified subscriber to this publisher.

func subscribe<S>(on: S, options: S.SchedulerOptions?) -> Publishers.SubscribeOn<Publishers.SetFailureType<Upstream, Failure>, S>

Specifies the scheduler on which to perform subscribe, cancel, and request operations.

func switchToLatest() -> Publishers.SwitchToLatest<Upstream.Output, Publishers.SetFailureType<Upstream, Failure>>

Flattens the stream of events from multiple upstream publishers to appear as if they were coming from a single stream of events.

func throttle<S>(for: S.SchedulerTimeType.Stride, scheduler: S, latest: Bool) -> Publishers.Throttle<Publishers.SetFailureType<Upstream, Failure>, S>

Publishes either the most-recent or first element published by the upstream publisher in the specified time interval.

func tryAllSatisfy((Upstream.Output) -> Bool) -> Publishers.TryAllSatisfy<Publishers.SetFailureType<Upstream, Failure>>

Publishes a single Boolean value that indicates whether all received elements pass a given error-throwing predicate.

func tryCatch<P>((Failure) -> P) -> Publishers.TryCatch<Publishers.SetFailureType<Upstream, Failure>, P>

Handles errors from an upstream publisher by replacing it with another publisher or an error.

func tryCompactMap<T>((Upstream.Output) -> T?) -> Publishers.TryCompactMap<Publishers.SetFailureType<Upstream, Failure>, T>

Calls an error-throwing closure with each received element and publishes any returned optional that has a value.

func tryContains(where: (Upstream.Output) -> Bool) -> Publishers.TryContainsWhere<Publishers.SetFailureType<Upstream, Failure>>

Publishes a Boolean value upon receiving an element that satisfies the throwing predicate closure.

func tryDrop(while: (Upstream.Output) -> Bool) -> Publishers.TryDropWhile<Publishers.SetFailureType<Upstream, Failure>>

Omits elements from the upstream publisher until an error-throwing closure returns false, before republishing all remaining elements.

func tryFirst(where: (Upstream.Output) -> Bool) -> Publishers.TryFirstWhere<Publishers.SetFailureType<Upstream, Failure>>

Publishes the first element of a stream to satisfy a throwing predicate closure, then finishes.

func tryLast(where: (Upstream.Output) -> Bool) -> Publishers.TryLastWhere<Publishers.SetFailureType<Upstream, Failure>>

Publishes only the last element of a stream that satisfies an error-throwing predicate closure, after the stream finishes.

func tryMap<T>((Upstream.Output) -> T) -> Publishers.TryMap<Publishers.SetFailureType<Upstream, Failure>, T>

Transforms all elements from the upstream publisher with a provided error-throwing closure.

func tryMax(by: (Upstream.Output, Upstream.Output) -> Bool) -> Publishers.TryComparison<Publishers.SetFailureType<Upstream, Failure>>

Publishes the maximum value received from the upstream publisher, using the provided error-throwing closure to order the items.

func tryMin(by: (Upstream.Output, Upstream.Output) -> Bool) -> Publishers.TryComparison<Publishers.SetFailureType<Upstream, Failure>>

Publishes the minimum value received from the upstream publisher, using the provided error-throwing closure to order the items.

func tryPrefix(while: (Upstream.Output) -> Bool) -> Publishers.TryPrefixWhile<Publishers.SetFailureType<Upstream, Failure>>

Republishes elements while a error-throwing predicate closure indicates publishing should continue.

func tryReduce<T>(T, (T, Upstream.Output) -> T) -> Publishers.TryReduce<Publishers.SetFailureType<Upstream, Failure>, T>

Applies an error-throwing closure that accumulates each element of a stream and publishes a final result upon completion.

func tryRemoveDuplicates(by: (Upstream.Output, Upstream.Output) -> Bool) -> Publishers.TryRemoveDuplicates<Publishers.SetFailureType<Upstream, Failure>>

Publishes only elements that don’t match the previous element, as evaluated by a provided error-throwing closure.

func tryScan<T>(T, (T, Upstream.Output) -> T) -> Publishers.TryScan<Publishers.SetFailureType<Upstream, Failure>, T>

Transforms elements from the upstream publisher by providing the current element to an error-throwing closure along with the last value returned by the closure.

func zip<P>(P) -> Publishers.Zip<Publishers.SetFailureType<Upstream, Failure>, P>

Combines elements from another publisher and deliver pairs of elements as tuples.

func zip<P, Q>(P, Q) -> Publishers.Zip3<Publishers.SetFailureType<Upstream, Failure>, P, Q>

Combines elements from two other publishers and delivers groups of elements as tuples.

func zip<P, Q, R>(P, Q, R) -> Publishers.Zip4<Publishers.SetFailureType<Upstream, Failure>, P, Q, R>

Combines elements from three other publishers and delivers groups of elements as tuples.

Relationships

Conforms To

See Also

Mapping Elements

struct Publishers.TryMap

A publisher that transforms all elements from the upstream publisher with a provided error-throwing closure.

struct Publishers.Map

A publisher that transforms all elements from the upstream publisher with a provided closure.

struct Publishers.MapError

A publisher that converts any failure from the upstream publisher into a new error.