Struct ControlParagraph 

pub struct ControlParagraph<'a> { /* private fields */ }

A paragraph in a control file.

A paragraph is an ordered series of control fields.

Field names are case insensitive on read and case preserving on set.

Paragraphs can only contain a single occurrence of a field and this is enforced through the mutation APIs.

Implementations

impl<'a> ControlParagraph<'a>

pub fn is_empty(&self) -> bool

Whether the paragraph is empty.

Empty is defined by the lack of any fields.

pub fn set_field(&mut self, field: ControlField<'a>)

Set the value of a field via a ControlField.

If a field with the same name (case insensitive compare) already exists, the old value will be replaced by the incoming value.

pub fn set_field_from_string(&mut self, name: Cow<'a, str>, value: Cow<'a, str>)

Set the value of a field defined via strings.

If a field with the same name (case insensitive compare) already exists, the old value will be replaced by the incoming value.

pub fn has_field(&self, name: &str) -> bool

Whether a named field is present in this paragraph.

pub fn iter_fields(&self) -> impl Iterator<Item = &ControlField<'a>>

Iterate over fields in this paragraph.

Iteration order is insertion order.

pub fn field(&self, name: &str) -> Option<&ControlField<'a>>

Obtain the field with a given name in this paragraph.

pub fn field_mut(&mut self, name: &str) -> Option<&'a mut ControlField<'_>>

Obtain a mutable reference to the field with a given name.

pub fn required_field(&self, name: &str) -> Result<&ControlField<'a>>

Obtain the named field and error if it isn’t defined.

pub fn field_str(&self, name: &str) -> Option<&str>

Obtain the raw string value of the named field.

pub fn required_field_str(&self, name: &str) -> Result<&str>

Obtain the raw string value of the named field, erroring if the field is not present.

pub fn field_bool(&self, name: &str) -> Option<bool>

Obtain the value of a field, evaluated as a boolean.

The field is true iff its string value is yes.

pub fn field_u64(&self, name: &str) -> Option<Result<u64>>

Obtain the value of a field, evaluated as a u64.

pub fn field_dependency_list( &self, name: &str, ) -> Option<Result<DependencyList>>

Obtain the value of a field, parsed as a DependencyList.

pub fn field_datetime_rfc5322( &self, name: &str, ) -> Option<Result<DateTime<Utc>>>

Obtain the value of a field parsed as an RFC 5322 date string.

This will parse values like Sat, 09 Oct 2021 09:34:56 UTC.

The timezone is always normalized to UTC even if it is expressed differently in the source string.

pub fn field_simple(&self, name: &str) -> Option<Result<ControlFieldValue<'a>>>

Obtain the field with the given name as a ControlFieldValue::Simple, if possible.

pub fn field_folded(&self, name: &str) -> Option<ControlFieldValue<'a>>

Obtain the field with the given name as a ControlFieldValue::Folded.

pub fn field_multiline(&self, name: &str) -> Option<ControlFieldValue<'a>>

Obtain the field with the given name as a ControlFieldValue::Multiline.

pub fn iter_field_words( &self, name: &str, ) -> Option<Box<dyn Iterator<Item = &str> + '_>>

Obtain an iterator of words in the named field.

pub fn iter_field_lines( &self, name: &str, ) -> Option<Box<dyn Iterator<Item = &str> + '_>>

Obtain an iterator of lines in the named field.

pub fn iter_field_comma_delimited( &self, name: &str, ) -> Option<Box<dyn Iterator<Item = &str> + '_>>

Obtain an iterator of comma-delimited values in the named field.

pub fn as_str_hash_map(&self) -> HashMap<&str, &str>

Convert this paragraph to a HashMap.

Values will be the string normalization of the field value, including newlines and leading whitespace.

If a field occurs multiple times, its last value will be recorded in the returned map.

pub fn write<W: Write>(&self, writer: &mut W) -> Result<()>

Serialize the paragraph to a writer.

A trailing newline is written as part of the final field. However, an extra newline is not present. So if serializing multiple paragraphs, an additional line break must be written to effectively terminate this paragraph if the writer is not at EOF.

Trait Implementations

impl<'a> Clone for ControlParagraph<'a>

fn clone(&self) -> ControlParagraph<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ControlParagraph<'a>

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

Formats the value using the given formatter.

impl<'a> Default for ControlParagraph<'a>

fn default() -> ControlParagraph<'a>

Returns the “default value” for a type.

impl<'a> Display for ControlParagraph<'a>

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

Formats the value using the given formatter.

impl<'a> From<BinaryPackageControlFile<'a>> for ControlParagraph<'a>

fn from(cf: BinaryPackageControlFile<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<ControlParagraph<'a>> for BinaryPackageControlFile<'a>

fn from(paragraph: ControlParagraph<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<ControlParagraph<'a>> for DebianSourceControlFile<'a>

fn from(paragraph: ControlParagraph<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<ControlParagraph<'a>> for ReleaseFile<'a>

fn from(paragraph: ControlParagraph<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<DebianSourceControlFile<'a>> for ControlParagraph<'a>

fn from(cf: DebianSourceControlFile<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<ReleaseFile<'a>> for ControlParagraph<'a>

fn from(release: ReleaseFile<'a>) -> Self

Converts to this type from the input type.

impl<'a> Hash for ControlParagraph<'a>

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<'a> Ord for ControlParagraph<'a>

fn cmp(&self, other: &ControlParagraph<'a>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'a> PartialEq for ControlParagraph<'a>

fn eq(&self, other: &ControlParagraph<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialOrd for ControlParagraph<'a>

fn partial_cmp(&self, other: &ControlParagraph<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> Eq for ControlParagraph<'a>

impl<'a> StructuralPartialEq for ControlParagraph<'a>