Files
firebase-ios-sdk/Firebase/Database/Api/FIRServerValue_unreleased.h
T
Thomas Bouldin 90e4522e66 [Feature launch] Re-add increment operator (#5149)
* Definition is currently in an "unreleased" extension to FIRServerValues
* Tests are added to FData.m (integration tests)
* Some tests are renamed to make it clear that ServerValues != timestamps
* Functions that resolve server values now need access to any existing snapshot. This is done with lazy evaluation as described below:

Based on fix https://github.com/firebase/firebase-js-sdk/pull/2499
to bug https://github.com/firebase/firebase-js-sdk/issues/2487

Micro-benchmarking showed that N writes in succession led to N^2
performance when calculating the resolved write tree for those
writes (thankfully only at the subpath in this SDK). Lazy evaluation
of current data matches the optimization in JS that mitigated a
20% performance regression.
2020-04-01 13:30:29 -07:00

43 lines
1.5 KiB
Objective-C

/*
* Copyright 2019 Google
*
* 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.
*/
#ifndef FIRServerValue_unreleased_h
#define FIRServerValue_unreleased_h
#import "FIRServerValue.h"
@interface FIRServerValue (Unreleased)
/**
* Adds the given delta to the current value at a location.
*
* The delta must be an long or a double value. If the current value is not an
* integer or double, or if the data does not yet exist, the transformation will
* set the data to the delta value. If either of the delta value or the existing
* data are doubles, both values will be interpreted as doubles. Double
* arithmetic and representation of double values follow IEEE 754 semantics. If
* there is positive/negative integer overflow, the sum is calculated as a a
* double.
*
* @param delta the amount to modify the current value atomically.
* @return a placeholder value for modifying data atomically server-side.
*/
+ (NSDictionary *)increment:(NSNumber *)delta NS_SWIFT_NAME(increment(_:));
@end
#endif /* FIRServerValue_unreleased_h */