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.
62 lines
2.3 KiB
62 lines
2.3 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>(RaceAdditions) |
|
|
|
/** |
|
Wait until any of the given promises are fulfilled. |
|
If one of the promises is rejected, then the returned promise is rejected with same error. |
|
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. |
|
|
|
@param promises Promises to wait for. |
|
@return A new pending promise to be resolved with the same resolution as the first promise, among |
|
the given ones, which was resolved. |
|
*/ |
|
+ (instancetype)race:(NSArray *)promises NS_SWIFT_UNAVAILABLE(""); |
|
|
|
/** |
|
Wait until any of the given promises are fulfilled. |
|
If one of the promises is rejected, then the returned promise is rejected with same error. |
|
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. |
|
|
|
@param queue A queue to dispatch on. |
|
@param promises Promises to wait for. |
|
@return A new pending promise to be resolved with the same resolution as the first promise, among |
|
the given ones, which was resolved. |
|
*/ |
|
+ (instancetype)onQueue:(dispatch_queue_t)queue race:(NSArray *)promises NS_REFINED_FOR_SWIFT; |
|
|
|
@end |
|
|
|
/** |
|
Convenience dot-syntax wrappers for `FBLPromise` `race` operators. |
|
Usage: FBLPromise.race(@[ ... ]) |
|
*/ |
|
@interface FBLPromise<Value>(DotSyntax_RaceAdditions) |
|
|
|
+ (FBLPromise * (^)(NSArray *))race FBL_PROMISES_DOT_SYNTAX NS_SWIFT_UNAVAILABLE(""); |
|
+ (FBLPromise * (^)(dispatch_queue_t, NSArray *))raceOn FBL_PROMISES_DOT_SYNTAX |
|
NS_SWIFT_UNAVAILABLE(""); |
|
|
|
@end |
|
|
|
NS_ASSUME_NONNULL_END
|
|
|