Struct RealKey 

pub struct RealKey {
    value: f64,
    label: String,
}

The key of one double-valued group (GroupKey::Real): the value plus the text R prints for it.

Equality

Keys compare and hash by value alone, with the rules vctrs uses and therefore dplyr’s group_by(): -0.0 equals 0.0, and every NaN is the same key. NA_real_ is never a RealKey: an NA cell keys as GroupKey::Na, so NA and NaN rows form separate groups, as in dplyr. The label takes no part in equality.

Label

The grouping verbs label a key with R’s as.character() of its value, called with the key column’s attributes (class, tzone, …): the same text factor() and split() use for level names. So a plain double prints with up to 15 significant digits ("0.1", "1e+05", "NaN"), a Date prints as "2024-01-02", and a POSIXct prints in the column’s time zone ("2024-01-02 10:30:00", or just the date at midnight).

Fields

value: f64

label: String

Implementations

impl RealKey

pub fn new(value: f64, label: impl Into<String>) -> Self

A key for value, printed as label. -0.0 is stored as 0.0 and every NaN as one canonical NaN, so equal keys hold identical bits.

pub fn value(&self) -> f64

The key’s value: never -0.0, and NaN is the canonical positive quiet NaN. For a Date key this is days since 1970-01-01; for a POSIXct key, seconds since the epoch.

pub fn label(&self) -> &str

The text R prints for the key (see the type docs).

Trait Implementations

impl Clone for RealKey

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RealKey

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

Formats the value using the given formatter.

impl Eq for RealKey

#[doc(hidden)]

fn assert_receiver_is_total_eq(&self)

👎Deprecated since 1.95.0:

implementation detail of #[derive(Eq)]

#[doc(hidden)]

fn assert_fields_are_eq(&self)

🔬This is a nightly-only experimental API. (derive_eq_internals)

impl Hash for RealKey

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RealKey

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

Equality operator ==.

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

Inequality operator !=.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 32 bytes