You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
69 lines
2.9 KiB
69 lines
2.9 KiB
/** |
|
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
|
|
|