Struct jomini::Scalar

pub struct Scalar<'a> { /* fields omitted */ }

Single value encapsulating windows-1252 data.

Since windows-1252 is a single byte character encoding, a scalar will never fail to be created.

use jomini::Scalar;

let v1 = Scalar::new(b"a");
assert_eq!(v1.to_utf8(), "a");

Implementations

impl<'a> Scalar<'a>

pub fn new(data: &'a [u8]) -> Scalar<'a>

Create a new scalar backed by windows-1252 encoded byte slice

pub fn view_data(&self) -> &[u8]

View the underlying windows-1252 encoded data

pub fn to_f64(&self) -> Result<f64, ScalarError>

Try converting the scalar to f64

pub fn to_bool(&self) -> Result<bool, ScalarError>

Try converting the scalar to f64

pub fn to_i64(&self) -> Result<i64, ScalarError>

Try converting the scalar to i64

pub fn to_u64(&self) -> Result<u64, ScalarError>

Try converting the scalar to u64

pub fn to_utf8(&self) -> Cow<'a, str>

Convert scalar data into utf8. Will allocate if the string is not utf8.

use jomini::Scalar;

let v1 = Scalar::new(b"a");
assert_eq!(v1.to_utf8(), "a");

let v2 = Scalar::new(&[255][..]);
assert_eq!(v2.to_utf8(), "ÿ");

pub fn to_utf8_owned(&self) -> String

Convert scalar data into an owned string

use jomini::Scalar;

let v1 = Scalar::new(b"a");
assert_eq!(v1.to_utf8(), String::from("a"));

let v2 = Scalar::new(&[255][..]);
assert_eq!(v2.to_utf8(), String::from("ÿ"));

pub fn is_ascii(&self) -> bool

Returns if the scalar contains only ascii values

use jomini::Scalar;

let v1 = Scalar::new(b"a");
assert!(v1.is_ascii());

let v2 = Scalar::new(&[255][..]);
assert!(!v2.is_ascii());

Trait Implementations

impl<'a> Clone for Scalar<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Scalar<'a>

impl<'a> Debug for Scalar<'a>

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

Formats the value using the given formatter.

impl<'a> Display for Scalar<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq<Scalar<'a>> for Scalar<'a>

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

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

fn ne(&self, other: &Scalar<'a>) -> bool

This method tests for !=.

impl<'a> StructuralPartialEq for Scalar<'a>