Struct LineTerminator

pub struct LineTerminator(/* private fields */);

A line terminator.

A line terminator represents the end of a line. Generally, every line is either “terminated” by the end of a stream or a specific byte (or sequence of bytes).

Generally, a line terminator is a single byte, specifically, \n, on Unix-like systems. On Windows, a line terminator is \r\n (referred to as CRLF for Carriage Return; Line Feed).

The default line terminator is \n on all platforms.

Implementations

impl LineTerminator

pub fn byte(byte: u8) -> LineTerminator

Return a new single-byte line terminator. Any byte is valid.

pub fn crlf() -> LineTerminator

Return a new line terminator represented by \r\n.

When this option is used, consumers may generally treat a lone \n as a line terminator in addition to \r\n.

pub fn is_crlf(&self) -> bool

Returns true if and only if this line terminator is CRLF.

pub fn as_byte(&self) -> u8

Returns this line terminator as a single byte.

If the line terminator is CRLF, then this returns \n. This is useful for routines that, for example, find line boundaries by treating \n as a line terminator even when it isn’t preceded by \r.

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

Returns this line terminator as a sequence of bytes.

This returns a singleton sequence for all line terminators except for CRLF, in which case, it returns \r\n.

The slice returned is guaranteed to have length at least 1.

pub fn is_suffix(&self, slice: &[u8]) -> bool

Returns true if and only if the given slice ends with this line terminator.

If this line terminator is CRLF, then this only checks whether the last byte is \n.

Trait Implementations

impl Clone for LineTerminator

fn clone(&self) -> LineTerminator

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LineTerminator

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

Formats the value using the given formatter.

impl Default for LineTerminator

fn default() -> LineTerminator

Returns the “default value” for a type.

impl Hash for LineTerminator

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 PartialEq for LineTerminator

fn eq(&self, other: &LineTerminator) -> 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 Copy for LineTerminator

impl Eq for LineTerminator

impl StructuralPartialEq for LineTerminator