Struct Point 

pub struct Point { /* private fields */ }

A single time-series data point.

Combines a SeriesKey (measurement + tags), a timestamp, and one or more typed field values. Fields are stored as a sorted Vec<(Arc<str>, FieldValue)> for allocation efficiency and cache-friendly access.

Fields are private to ensure invariants (at least one field, valid field names) are maintained — use Point::new() to construct.

Implementations

impl Point

pub fn new( series_key: SeriesKey, fields: BTreeMap<String, FieldValue>, timestamp: i64, ) -> Result<Point, SchemaError>

Create a new point with validation.

Accepts a BTreeMap for ergonomic construction; internally converts to a sorted Vec for cache-friendly storage.

Errors

Returns SchemaError if the series key is invalid or fields are empty.

pub fn series_key(&self) -> &SeriesKey

Returns the series key for this point.

pub fn fields(&self) -> &Vec<(Arc<str>, FieldValue)>

Returns the field values as a sorted slice.

pub fn field(&self, key: &str) -> Option<&FieldValue>

Look up a field value by key using binary search.

pub fn field_keys(&self) -> impl Iterator<Item = &str>

Returns an iterator over field keys.

pub fn set_field(&mut self, key: &str, value: FieldValue) -> bool

Replace an existing field’s value in place, returning false when the field is not present.

The field set is fixed at construction, so this cannot change the sort order or the point’s validity — it exists for the one caller that rewrites a value without rewriting the point: rescaling a decimal to its column’s declared scale on the write path.

pub fn timestamp(&self) -> i64

Returns the timestamp.

pub fn measurement(&self) -> &str

Returns the measurement name (delegates to SeriesKey::measurement).

pub fn tags(&self) -> &Vec<(Arc<str>, Arc<str>)>

Returns the tag set (delegates to SeriesKey::tags).

pub fn tag(&self, key: &str) -> Option<&str>

Look up a tag value by key (delegates to SeriesKey::tag).

pub fn tag_keys(&self) -> impl Iterator<Item = &str>

Iterator over tag keys (delegates to SeriesKey::tag_keys).

pub fn inject_tag( &mut self, key: impl Into<String>, value: impl Into<String>, ) -> Result<(), SchemaError>

Inject a tag into this point’s series key.

Inject a tag into this point’s series key using copy-on-write.

Delegates to SeriesKey::inject_tag which uses Arc::make_mut to avoid unnecessary deep clones.

Errors

Returns SchemaError if the tag name is invalid.

Trait Implementations

impl Clone for Point

fn clone(&self) -> Point

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Point

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Point

fn deserialize<__D>( __deserializer: __D, ) -> Result<Point, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Point

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for Point

fn eq(&self, other: &Point) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Point

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Point