70 lines
2.9 KiB
C
70 lines
2.9 KiB
C
|
/**
|
||
|
|
Copyright 2018 Google Inc. All rights reserved.
|
||
|
|
|
||
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
you may not use this file except in compliance with the License.
|
||
|
|
You may obtain a copy of the License at:
|
||
|
|
|
||
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
|
||
|
|
Unless required by applicable law or agreed to in writing, software
|
||
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
See the License for the specific language governing permissions and
|
||
|
|
limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#import "FBLPromise.h"
|
||
|
|
|
||
|
|
NS_ASSUME_NONNULL_BEGIN
|
||
|
|
|
||
|
|
@interface FBLPromise<Value>(AnyAdditions)
|
||
|
|
|
||
|
|
/**
|
||
|
|
Waits until all of the given promises are either fulfilled or rejected.
|
||
|
|
If all promises are rejected, then the returned promise is rejected with same error
|
||
|
|
as the last one rejected.
|
||
|
|
If at least one of the promises is fulfilled, the resulting promise is fulfilled with an array of
|
||
|
|
values or `NSErrors`, matching the original order of fulfilled or rejected promises respectively.
|
||
|
|
If any other arbitrary value or `NSError` appears in the array instead of `FBLPromise`,
|
||
|
|
it's implicitly considered a pre-fulfilled or pre-rejected `FBLPromise` correspondingly.
|
||
|
|
Promises resolved with `nil` become `NSNull` instances in the resulting array.
|
||
|
|
|
||
|
|
@param promises Promises to wait for.
|
||
|
|
@return Promise of array containing the values or `NSError`s of input promises in the same order.
|
||
|
|
*/
|
||
|
|
+ (FBLPromise<NSArray *> *)any:(NSArray *)promises NS_SWIFT_UNAVAILABLE("");
|
||
|
|
|
||
|
|
/**
|
||
|
|
Waits until all of the given promises are either fulfilled or rejected.
|
||
|
|
If all promises are rejected, then the returned promise is rejected with same error
|
||
|
|
as the last one rejected.
|
||
|
|
If at least one of the promises is fulfilled, the resulting promise is fulfilled with an array of
|
||
|
|
values or `NSError`s, matching the original order of fulfilled or rejected promises respectively.
|
||
|
|
If any other arbitrary value or `NSError` appears in the array instead of `FBLPromise`,
|
||
|
|
it's implicitly considered a pre-fulfilled or pre-rejected `FBLPromise` correspondingly.
|
||
|
|
Promises resolved with `nil` become `NSNull` instances in the resulting array.
|
||
|
|
|
||
|
|
@param queue A queue to dispatch on.
|
||
|
|
@param promises Promises to wait for.
|
||
|
|
@return Promise of array containing the values or `NSError`s of input promises in the same order.
|
||
|
|
*/
|
||
|
|
+ (FBLPromise<NSArray *> *)onQueue:(dispatch_queue_t)queue
|
||
|
|
any:(NSArray *)promises NS_REFINED_FOR_SWIFT;
|
||
|
|
|
||
|
|
@end
|
||
|
|
|
||
|
|
/**
|
||
|
|
Convenience dot-syntax wrappers for `FBLPromise` `any` operators.
|
||
|
|
Usage: FBLPromise.any(@[ ... ])
|
||
|
|
*/
|
||
|
|
@interface FBLPromise<Value>(DotSyntax_AnyAdditions)
|
||
|
|
|
||
|
|
+ (FBLPromise<NSArray *> * (^)(NSArray *))any FBL_PROMISES_DOT_SYNTAX NS_SWIFT_UNAVAILABLE("");
|
||
|
|
+ (FBLPromise<NSArray *> * (^)(dispatch_queue_t, NSArray *))anyOn FBL_PROMISES_DOT_SYNTAX
|
||
|
|
NS_SWIFT_UNAVAILABLE("");
|
||
|
|
|
||
|
|
@end
|
||
|
|
|
||
|
|
NS_ASSUME_NONNULL_END
|