Struct norad::LayerContents

pub struct LayerContents { /* private fields */ }

The ordered list of Layer objects within a UFO.

A layer set always includes a default layer, and may also include additional layers.

Corresponds to layercontents.plist.

Implementations

impl LayerContents

pub fn len(&self) -> usize

Returns the number of layers in the set.

This is always non-zero.

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

Returns a reference to a layer, by name.

pub fn get_mut(&mut self, name: &str) -> Option<&mut Layer>

Returns a mutable reference to a layer, by name.

pub fn default_layer(&self) -> &Layer

Returns a reference to the default layer.

pub fn default_layer_mut(&mut self) -> &mut Layer

Returns a mutable reference to the default layer.

pub fn iter(&self) -> impl Iterator<Item = &Layer>

Returns an iterator over all layers.

pub fn iter_mut(&mut self) -> impl Iterator<Item = &mut Layer>

Returns a mutable iterator over all layers.

pub fn names(&self) -> impl Iterator<Item = &Name>

Returns an iterator over the names of all layers.

pub fn new_layer(&mut self, name: &str) -> Result<&mut Layer, NamingError>

Returns a new layer with the given name.

pub fn get_or_create_layer( &mut self, name: &str ) -> Result<&mut Layer, NamingError>

Returns a mutable reference to a layer, by name, creating the layer if it doesn’t exist

pub fn remove(&mut self, name: &str) -> Option<Layer>

Remove a layer.

The default layer cannot be removed.

pub fn rename_layer( &mut self, old: &str, new: &str, overwrite: bool ) -> Result<(), NamingError>

Rename a layer.

If overwrite is true, and a layer with the new name exists, it will be replaced.

Returns an error if overwrite is false but a layer with the new name exists, if no layer with the old name exists, if the new name is not a valid Name or when anything but the default layer should be renamed to “public.default”.

pub fn retain<F>(&mut self, predicate: F)

where F: FnMut(&Layer) -> bool,

Retains the default layer, and any layers allowed by the predicate.

In other words, remove all layers l for which predicate(&l) returns false. This method operates in place, visiting each layer exactly once in the original order, and preserves the order of the retained layers.

For more information, see Vec::retain.

pub fn remove_empty_layers(&mut self)

Removes any layers that contain no glyphs

Trait Implementations

impl Clone for LayerContents

fn clone(&self) -> LayerContents

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LayerContents

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

Formats the value using the given formatter.

impl Default for LayerContents

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for LayerContents

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

This method tests for self and other values to be equal, and is used by ==.

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

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