Struct kdb::Symbol

#[repr(transparent)]pub struct Symbol(_);

Represents a KDB Symbol (interned string) Implements basic symbol operations for efficiency Can be converted to/from strings

Implementations

impl Symbol

pub fn new<T: AsRef<str>>(st: T) -> Result<Symbol, SymbolError>

Create a new symbol from the specified string. If the string is too long, or contains an embedded nul character, then it returns an error.

pub unsafe fn new_unchecked<T: AsRef<str>>(st: T) -> Symbol

Creates a new symbol, skipping the safety checks for length

Safety

Any string passed in must not contain embedded nul characters (\0). It's length must be less than or equal to isize::MAX.

pub fn try_as_str(&self) -> Result<&'static str, ConversionError>

Attempts to convert to a valid utf-8 string. This will return an error if the string contains invalid utf-8 characters. This function does not allocate.

pub unsafe fn as_str_unchecked(&self) -> &'static str

Converts the symbol to a rust str without checking if it is valid.

Safety

The string must be valid UTF-8. It's length must be less than or equal to isize::MAX.

Trait Implementations

impl Clone for Symbol

fn clone(&self) -> Symbol

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Symbol

impl Debug for Symbol

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

Formats the value using the given formatter.

impl Display for Symbol

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

Display for symbol will always render a string representation of the symbol. If the string contains invalid characters it will strip them from the string. This function will allocate only if the string conatins invalid utf-8 characters.

impl Eq for Symbol

impl From<Atom<Symbol>> for Symbol

fn from(val: Atom<Symbol>) -> Symbol

Performs the conversion.

impl Hash for Symbol

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Symbol> for Symbol

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.