Enum DataFrameError 

pub enum DataFrameError {
    NotList(SEXPTYPE),
    NotDataFrame,
    NoNames,
    BadRowNames(String),
    UnequalLengths {
        expected: usize,
        columns: Vec<(String, usize)>,
    },
    UnnamedColumns,
    NoSuchColumn(String),
    EmptyGroupColumns,
    UnsupportedGroupColumn {
        column: String,
        type_of: String,
    },
    NotGroupedDataFrame,
    GroupsNotDataFrame,
    MissingGroupRows,
    BadGroupRows {
        group: Option<usize>,
        type_of: String,
    },
    GroupIndexOutOfRange {
        group: usize,
        value: i64,
        nrow: usize,
    },
    GroupRowUncovered {
        row: usize,
        nrow: usize,
    },
    GroupRowDuplicated {
        row: usize,
        first_group: usize,
        second_group: usize,
    },
    Conversion(String),
}

Error returned by any DataFrame construction, read, or conversion path.

This is the single data-frame error contract: the row-buffer build path, the serde columnar path, the parallel R→Rust reader, and validation all surface a DataFrameError.

Variants

NotList(SEXPTYPE)

The SEXP is not a VECSXP; carries the SEXPTYPE it was.

NotDataFrame

The object does not inherit from data.frame.

NoNames

The list has no names attribute (columns must be named).

BadRowNames(String)

Could not extract nrow from row.names attribute.

UnequalLengths

Columns have unequal lengths (when promoting from a named list).

Fields

expected: usize

First column length encountered.

columns: Vec<(String, usize)>

Every mismatched column, in order, with its actual length.

UnnamedColumns

A row could not be turned into named columns (e.g. unnamed list elements in a IntoList-derived row). Replaces the old panic! on this path.

NoSuchColumn(String)

DataFrame::group_by referenced a column name that does not exist.

EmptyGroupColumns

DataFrame::group_by_multi was called with an empty column slice.

UnsupportedGroupColumn

DataFrame::group_by on a column type with no grouping semantics (list-columns, complex, raw, bit64 integer64, …).

Fields

column: String

The offending column name.

type_of: String

Its SEXPTYPE (or "integer64"), rendered for the message.

NotGroupedDataFrame

DataFrame::group_by_metadata was called on a frame that does not inherit from grouped_df or rowwise_df.

GroupsNotDataFrame

A frame inherits from grouped_df or rowwise_df, but its groups attribute is missing or is not a data frame with at least one column. dplyr treats such a frame as corrupt, not as ungrouped (“The groups attribute must be a data frame.”).

MissingGroupRows

The last column of a grouped frame’s groups attribute is not called .rows (dplyr: “The last column of the groups attribute must be called .rows.”).

BadGroupRows

The .rows column of a grouped frame’s groups attribute is not a list of integer vectors (dplyr: “The .rows column must be list of one-based integer vectors.”). Doubles are rejected, as in dplyr.

Fields

group: Option<usize>

The 0-based group (row of the groups frame) whose element is not an integer vector, or None when the .rows column itself is not a list. The message numbers groups from 1, as R does.

type_of: String

R’s typeof() of the offending element (or of the .rows column), rendered for the message.

GroupIndexOutOfRange

A .rows index was < 1 or > nrow of the source frame: the grouping metadata is stale. The message names the usual cause (the frame was subset without dplyr loaded) and the fix.

Fields

group: usize

The 0-based group whose .rows carried the bad index; the message numbers it from 1, as R does.

value: i64

The offending 1-based index value.

nrow: usize

The source frame’s row count (valid indices are 1..=nrow).

GroupRowUncovered

No group’s .rows holds this row of the source frame: the grouping metadata is stale (the message names the cause and the fix).

Fields

row: usize

The first uncovered 0-based row; the message numbers it from 1.

nrow: usize

The source frame’s row count.

GroupRowDuplicated

Two .rows entries hold the same row of the source frame (in two groups, or twice in one): the grouping metadata is stale (the message names the cause and the fix).

Fields

row: usize

The 0-based row; the message numbers it from 1.

first_group: usize

The 0-based group that held the row first.

second_group: usize

The 0-based group that held it again (equal to first_group for a row listed twice in one group).

Conversion(String)

A serde-driven schema/serialize/deserialize failure (the bridged RSerdeError text) or another conversion failure carried as a message.

Trait Implementations

impl Clone for DataFrameError

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 DataFrameError

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

Formats the value using the given formatter.

impl Display for DataFrameError

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

Formats the value using the given formatter.

impl Error for DataFrameError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

#[doc(hidden)]

fn type_id(&self, _: Internal) -> TypeId

where Self: 'static,

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

Gets the TypeId of self.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

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: 48 bytes

Size for each variant:

• NotList: 12 bytes
• NotDataFrame: 0 bytes
• NoNames: 0 bytes
• BadRowNames: 32 bytes
• UnequalLengths: 40 bytes
• UnnamedColumns: 0 bytes
• NoSuchColumn: 32 bytes
• EmptyGroupColumns: 0 bytes
• UnsupportedGroupColumn: 48 bytes
• NotGroupedDataFrame: 0 bytes
• GroupsNotDataFrame: 0 bytes
• MissingGroupRows: 0 bytes
• BadGroupRows: 48 bytes
• GroupIndexOutOfRange: 32 bytes
• GroupRowUncovered: 24 bytes
• GroupRowDuplicated: 32 bytes
• Conversion: 32 bytes