Struct EmptySpan

Source

pub struct EmptySpan { /* private fields */ }

Available on crate feature span only.

Expand description

Newtype of Span::len() == 0

Methods from Deref<Target = Span>§

Source

pub fn create(&self, range: TextRange) -> Self

New a span source range from exist span.

§Panics

Panics if range out of source.

§Examples

use line_column::span::*;

let source = "abcdef";
let full = Span::new_full(source);
assert_eq!(full.text(), "abcdef");

let span = full.create(TextRange::at(1.into(), 3.into()));
assert_eq!(span.text(), "bcd");
let span2 = span.create(TextRange::at(3.into(), 3.into()));
assert_eq!(span2.text(), "def");

Source

pub fn slice(&self, range: TextRange) -> Self

New a span relative range from exist span.

§Panics

Panics if range+start out of source.

§Examples

use line_column::span::*;

let source = "abcdef";
let full = Span::new_full(source);
assert_eq!(full.text(), "abcdef");

let span = full.slice(TextRange::at(1.into(), 3.into()));
assert_eq!(span.text(), "bcd");
let span2 = span.slice(TextRange::at(1.into(), 3.into()));
assert_eq!(span2.text(), "cde");

Source

pub fn split(&self, len: TextSize) -> (Self, Self)

New splited span pair relative range from exist span.

§Panics

Panics if range+at out of source.

§Examples

use line_column::span::*;

let source = "abcdef";
let full = Span::new_full(source);
assert_eq!(full.text(), "abcdef");

let (a, span) = full.split(TextSize::of("a"));
assert_eq!(a.text(), "a");
assert_eq!(span.text(), "bcdef");

let (bcd, span2) = span.split(TextSize::of("bcd"));
assert_eq!(bcd.text(), "bcd");
assert_eq!(span2.text(), "ef");

Source

pub fn is_empty(&self) -> bool

Returns the is empty of this Span range.

§Examples

use line_column::span::*;

let span = Span::new_full("foo");
let empty = span.create(TextRange::empty(1.into()));
assert_eq!(span.is_empty(),  false);
assert_eq!(empty.is_empty(), true);
assert_eq!(empty.range(),    TextRange::new(1.into(), 1.into()));

Source

pub fn len(&self) -> TextSize

Returns the length of this Span range.

§Examples

use line_column::span::*;

let span = Span::new_full("foo");
let empty = span.create(TextRange::empty(1.into()));
assert_eq!(span.len(),  TextSize::new(3));
assert_eq!(empty.len(), TextSize::new(0));

Source

pub fn before(&self) -> Self

Returns the source before of this Span.

§Examples

use line_column::span::*;

let span = Span::new("foobarbaz", TextRange::new(3.into(), 6.into()));
assert_eq!(span.text(),          "bar");
assert_eq!(span.before().text(), "foo");

Source

pub fn after(&self) -> Self

Returns the source after of this Span.

§Examples

use line_column::span::*;

let span = Span::new("foobarbaz", TextRange::new(3.into(), 6.into()));
assert_eq!(span.text(),          "bar");
assert_eq!(span.after().text(),  "baz");

Source

pub fn take(&self, len: TextSize) -> Self

Returns truncated sub-span.

§Examples

use line_column::span::*;

let span = Span::new("foobarbaz", TextRange::new(3.into(), 7.into()));
assert_eq!(span.text(), "barb");
assert_eq!(span.take(3.into()).text(), "bar");

Source

pub fn start(&self) -> Self

Returns the start of this Span.

§Examples

use line_column::span::*;

let span = Span::new("abcdef", TextRange::new(1.into(), 4.into()));
assert_eq!(span.start().range(), TextRange::new(1.into(), 1.into()));

Source

pub fn end(&self) -> Self

Returns the end of this Span.

§Examples

use line_column::span::*;

let span = Span::new("abcdef", TextRange::new(1.into(), 4.into()));
assert_eq!(span.end().range(), TextRange::new(4.into(), 4.into()));

Source

pub fn index(&self) -> TextSize

Returns the start index of this Span range.

§Examples

use line_column::span::*;

let span = Span::new("abcdef", TextRange::new(1.into(), 4.into()));
assert_eq!(span.index(), TextSize::new(1));

Source

pub fn text(&self) -> &str

Returns the source text of the range reference.

§Examples

use line_column::span::*;

let span = Span::new("abcdef", TextRange::new(1.into(), 4.into()));
assert_eq!(span.text(), "bcd");

Source

pub fn range(&self) -> TextRange

Returns the source text of the range reference.

§Examples

use line_column::span::*;

let span = Span::new("abcdef", TextRange::new(1.into(), 4.into()));
assert_eq!(span.range(),       TextRange::new(1.into(), 4.into()));

Source

pub fn source(&self) -> &str

Returns the source text.

§Examples

use line_column::span::*;

let span = Span::new("abcdef", TextRange::new(1.into(), 4.into()));
assert_eq!(span.source(), "abcdef");
assert_eq!(span.text(),   "bcd");

Source

pub fn current_line(&self) -> Self

Returns the current line of this Span.

Maybe include end of line char, like '\n'.

§Examples

use line_column::span::*;

let span = Span::new_full("foo\nbar\nbaz");
let next = span.create(TextRange::at(TextSize::of("foo\n"), 5.into()));
let tail = span.create(TextRange::at(TextSize::of("foo\nbar\n"), 3.into()));
let endl = span.create(TextRange::at(TextSize::of("foo"), 3.into()));

assert_eq!(next.text(), "bar\nb");
assert_eq!(tail.text(), "baz");
assert_eq!(endl.text(), "\nba");

assert_eq!(span.current_line().text(), "foo\n");
assert_eq!(next.current_line().text(), "bar\n");
assert_eq!(tail.current_line().text(), "baz");
assert_eq!(endl.current_line().text(), "foo\n");

Source

pub fn prev_line(&self) -> Self

Returns the previous line of this Span.

§Examples

use line_column::span::*;

let span = Span::new_full("foo\nbar\nbaz");
let next = span.create(TextRange::at(TextSize::of("foo\n"), 5.into()));
let tail = span.create(TextRange::at(TextSize::of("foo\nbar\n"), 3.into()));
let endl = span.create(TextRange::at(TextSize::of("foo"), 3.into()));

assert_eq!(next.text(), "bar\nb");
assert_eq!(tail.text(), "baz");
assert_eq!(endl.text(), "\nba");

assert_eq!(span.prev_line().text(), "");
assert_eq!(next.prev_line().text(), "foo\n");
assert_eq!(tail.prev_line().text(), "bar\n");
assert_eq!(endl.prev_line().text(), "");

Source

pub fn next_line(&self) -> Self

Returns the next line of this Span.

§Examples

use line_column::span::*;

let span = Span::new_full("foo\nbar\nbaz");
let next = span.create(TextRange::at(TextSize::of("foo\n"), 5.into()));
let tail = span.create(TextRange::at(TextSize::of("foo\nbar\n"), 3.into()));
let endl = span.create(TextRange::at(TextSize::of("foo"), 3.into()));

assert_eq!(next.text(), "bar\nb");
assert_eq!(tail.text(), "baz");
assert_eq!(endl.text(), "\nba");

assert_eq!(span.next_line().text(), "bar\n");
assert_eq!(next.next_line().text(), "baz");
assert_eq!(tail.next_line().text(), "");
assert_eq!(endl.next_line().text(), "bar\n");

Source

pub fn trim_end(&self) -> Self

Returns the trim end of this Span range.

§Examples

use line_column::span::*;

let span = Span::new("foo  bar  baz", TextRange::new(4.into(), 9.into()));
assert_eq!(span.text(), " bar ");
assert_eq!(span.trim_end().text(), " bar");

Source

pub fn trim_start(&self) -> Self

Returns the trim start of this Span range.

§Examples

use line_column::span::*;

let span = Span::new("foo  bar  baz", TextRange::new(4.into(), 9.into()));
assert_eq!(span.text(), " bar ");
assert_eq!(span.trim_start().text(), "bar ");