// This Source Code Form is subject to the terms of the Mozilla Public // License, v. 2.0. If a copy of the MPL was not distributed with this // file, You can obtain one at https://mozilla.org/MPL/2.0/.
/// A quantity metric. /// /// Used to store explicit non-negative integers. #[derive(Clone, Debug)] pubstruct QuantityMetric {
meta: Arc<CommonMetricDataInternal>,
}
// IMPORTANT: // // When changing this implementation, make sure all the operations are // also declared in the related trait in `../traits/`. impl QuantityMetric { /// Creates a new quantity metric. pubfn new(meta: CommonMetricData) -> Self { Self {
meta: Arc::new(meta.into()),
}
}
/// Sets the value. Must be non-negative. /// /// # Arguments /// /// * `value` - The value. Must be non-negative. /// /// ## Notes /// /// Logs an error if the `value` is negative. pubfn set(&self, value: i64) { let metric = self.clone(); crate::launch_with_glean(move |glean| metric.set_sync(glean, value))
}
/// Sets the value synchronously. Must be non-negative. #[doc(hidden)] pubfn set_sync(&self, glean: &Glean, value: i64) { if !self.should_record(glean) { return;
}
if value < 0 {
record_error(
glean,
&self.meta,
ErrorType::InvalidValue,
format!("Set negative value {}", value),
None,
); return;
}
/// **Test-only API (exported for FFI purposes).** /// /// Gets the currently stored value as an integer. /// /// This doesn't clear the stored value. /// /// # Arguments /// /// * `ping_name` - the optional name of the ping to retrieve the metric /// for. Defaults to the first value in `send_in_pings`. /// /// # Returns /// /// The stored value or `None` if nothing stored. pubfn test_get_value(&self, ping_name: Option<String>) -> Option<i64> { crate::block_on_dispatcher(); crate::core::with_glean(|glean| self.get_value(glean, ping_name.as_deref()))
}
/// **Exported for test purposes.** /// /// Gets the number of recorded errors for the given metric and error type. /// /// # Arguments /// /// * `error` - The type of error /// /// # Returns /// /// The number of errors reported. pubfn test_get_num_recorded_errors(&self, error: ErrorType) -> i32 { crate::block_on_dispatcher();
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.