Enum BuilderError

#[non_exhaustive]
pub enum BuilderError {
    MissingDateFields,
    MissingTimePrecision,
    MissingZoneStyle,
    InvalidDateFields,
    SuperfluousOptions(FieldSetBuilder),
}

An error that occurs when creating a field set from a builder.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

MissingDateFields

The builder needs DateFields in order to build the specified field set.

This variant is also returned when building a composite field set if none of the possible required options were set (date fields, time precision, zone style).

MissingTimePrecision

The builder needs TimePrecision in order to build the specified field set.

MissingZoneStyle

The builder needs ZoneStyle in order to build the specified field set.

InvalidDateFields

The value in DateFields is not a valid for the specified field set.

This can happen if, for example:

• You requested DateFieldSet but the fields are for a calendar period
• You requested CalendarPeriodFieldSet but the fields are for a date
• You requested a field set with time but the fields are for a calendar period

SuperfluousOptions(FieldSetBuilder)

Superfluous options were specified.

For example, you cannot set a YearStyle unless the field set contains years.

The options that were not read are returned back to the user.

Examples

use icu::datetime::fieldsets;
use icu::datetime::fieldsets::builder::*;
use icu::datetime::options::*;

let mut builder = FieldSetBuilder::new();
builder.length = Some(Length::Short);
builder.time_precision = Some(TimePrecision::Minute);
builder.year_style = Some(YearStyle::WithEra);

let err = builder.build_composite().unwrap_err();

let BuilderError::SuperfluousOptions(superfluous_options) = err else {
    panic!("error type should be SuperfluousOptions");
};

assert!(superfluous_options.year_style.is_some());
assert!(superfluous_options.time_precision.is_none());

Trait Implementations

impl Clone for BuilderError

fn clone(&self) -> BuilderError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BuilderError

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

Formats the value using the given formatter.

impl Display for BuilderError

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

Formats the value using the given formatter.

impl Error for BuilderError

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

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

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.