Struct Identifier

pub struct Identifier<N: Network>(/* private fields */);

An identifier is an immutable UTF-8 string, represented as a constant field element in the CurrentNetwork.

Requirements

The identifier must not be an empty string. The identifier must not start with a number. The identifier must be alphanumeric, and may include underscores. The identifier must not consist solely of underscores. The identifier must fit within the data capacity of a base field element.

Implementations

impl<N: Network> Identifier<N>

pub fn size_in_bits(&self) -> u8

Returns the number of bits of this identifier.

Trait Implementations

impl<N: Clone + Network> Clone for Identifier<N>

fn clone(&self) -> Identifier<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: Network> Debug for Identifier<N>

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

Formats the value using the given formatter.

impl<'de, N: Network> Deserialize<'de> for Identifier<N>

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserializes the identifier from a string or bytes.

impl<N: Network> Display for Identifier<N>

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

Prints the identifier as a string.

impl<N: Network> Equal for Identifier<N>

fn is_equal(&self, other: &Self) -> Self::Output

Returns true if self and other are equal.

fn is_not_equal(&self, other: &Self) -> Self::Output

Returns true if self and other are not equal.

type Output = Boolean<N>

impl<N: Network> From<&Identifier<N>> for Identifier<N>

fn from(identifier: &Identifier<N>) -> Self

Returns a copy of the identifier.

impl<N: Network> From<Identifier<N>> for Access<N>

fn from(identifier: Identifier<N>) -> Self

Initializes a new member access from an identifier.

impl<N: Network> From<Identifier<N>> for PlaintextType<N>

fn from(struct_: Identifier<N>) -> Self

Initializes a plaintext type from a struct type.

impl<N: Network> FromBits for Identifier<N>

fn from_bits_le(bits_le: &[bool]) -> Result<Self>

Initializes a new identifier from a list of little-endian bits without trailing zeros.

fn from_bits_be(bits_be: &[bool]) -> Result<Self>

Initializes a new identifier from a list of big-endian bits without leading zeros.

impl<N: Network> FromBytes for Identifier<N>

fn read_le<R: Read>(reader: R) -> IoResult<Self>

Reads in an identifier from a buffer.

fn from_bytes_le(bytes: &[u8]) -> Result<Self, Error>

where Self: Sized,

Returns Self from a byte array in little-endian order.

impl<N: Network> FromField for Identifier<N>

fn from_field(field: &Self::Field) -> Result<Self>

Initializes a new identifier from a field element.

type Field = Field<N>

impl<N: Network> FromStr for Identifier<N>

fn from_str(identifier: &str) -> Result<Self, Self::Err>

Reads in an identifier from a string.

type Err = Error

The associated error which can be returned from parsing.

impl<N: Network> Hash for Identifier<N>

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<N: Network> Parser for Identifier<N>

fn parse(string: &str) -> ParserResult<'_, Self>

Parses a string into an identifier.

Requirements

The identifier must be alphanumeric (or underscore). The identifier must not start with a number. The identifier must not be a keyword.

impl<N: Network> PartialEq for Identifier<N>

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

Returns true if self and other are equal.

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<N: Network> Serialize for Identifier<N>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serializes the identifier into string or bytes.

impl<N: Network> ToBits for &Identifier<N>

fn write_bits_le(&self, vec: &mut Vec<bool>)

Returns the little-endian bits of the identifier.

fn write_bits_be(&self, vec: &mut Vec<bool>)

Returns the big-endian bits of the identifier.

fn to_bits_le(&self) -> Vec<bool>

Returns self as a boolean array in little-endian order.

fn to_bits_be(&self) -> Vec<bool>

Returns self as a boolean array in big-endian order.

fn num_bits() -> Option<usize>

An optional indication of how many bits an object can be represented with.

impl<N: Network> ToBits for Identifier<N>

fn write_bits_le(&self, vec: &mut Vec<bool>)

Returns the little-endian bits of the identifier.

fn write_bits_be(&self, vec: &mut Vec<bool>)

Returns the big-endian bits of the identifier.

fn to_bits_le(&self) -> Vec<bool>

Returns self as a boolean array in little-endian order.

fn to_bits_be(&self) -> Vec<bool>

Returns self as a boolean array in big-endian order.

fn num_bits() -> Option<usize>

An optional indication of how many bits an object can be represented with.

impl<N: Network> ToBytes for Identifier<N>

fn write_le<W: Write>(&self, writer: W) -> IoResult<()>

Writes an identifier to a buffer.

fn to_bytes_le(&self) -> Result<Vec<u8>, Error>

where Self: Sized,

Returns self as a byte array in little-endian order.

impl<N: Network> ToField for &Identifier<N>

fn to_field(&self) -> Result<Self::Field>

Returns the identifier as a field element.

type Field = Field<N>

impl<N: Network> ToField for Identifier<N>

fn to_field(&self) -> Result<Self::Field>

Returns the identifier as a field element.

type Field = Field<N>

impl<N: Network> TryFrom<&String> for Identifier<N>

fn try_from(identifier: &String) -> Result<Self>

Initializes an identifier from a string.

type Error = Error

The type returned in the event of a conversion error.

impl<N: Network> TryFrom<&str> for Identifier<N>

fn try_from(identifier: &str) -> Result<Self>

Initializes an identifier from a string.

type Error = Error

The type returned in the event of a conversion error.

impl<N: Network> TryFrom<String> for Identifier<N>

fn try_from(identifier: String) -> Result<Self>

Initializes an identifier from a string.

type Error = Error

The type returned in the event of a conversion error.

impl<N: Copy + Network> Copy for Identifier<N>

impl<N: Network> Eq for Identifier<N>