#string #multi-line #utilities

dev trim-margin

A utility crate to help with layouting multi-line strings by detecting their margin

1 unstable release

Uses old Rust 2015

0.1.0 Jan 13, 2018

#242 in Value formatting

Download history 3057/week @ 2024-01-05 2276/week @ 2024-01-12 3541/week @ 2024-01-19 2474/week @ 2024-01-26 2632/week @ 2024-02-02 3375/week @ 2024-02-09 4437/week @ 2024-02-16 3865/week @ 2024-02-23 3503/week @ 2024-03-01 3025/week @ 2024-03-08 2453/week @ 2024-03-15 4717/week @ 2024-03-22 1894/week @ 2024-03-29 4321/week @ 2024-04-05 4244/week @ 2024-04-12 2349/week @ 2024-04-19

13,227 downloads per month
Used in 5 crates

Apache-2.0

10KB
71 lines

trim-margin: easy layouting of multi-line strings

Build Status Crates.io

This crate is intended to ease the use of multi-line strings in Rust. When embedding strings with multiple lines in Rust all whitespaces, tabs, etc. are preserved even if they are just used for layouting one's code nicely.

fn main() {
    println!("-----------------------");
    let misrepresented_multiline_string = "
        This is string
        spans over multiple lines,
        but its rendering preserves all whitespaces.

        Which is not what we usually intend in this case.
    ";
    println!("{}", misrepresented_multiline_string);
    println!("-----------------------");

    println!("-----------------------");
    let correctly_layouted_string = "For displaying
the a multiline strin properly
it would need to be layouted
like this.

Which is not very nice.";
    println!("{}", correctly_layouted_string);
    println!("-----------------------");
}

The trim-margin crate supports you with proper layouting. By introducing a margin in the multi-line string the trim_margin method can filter out unwanted whitespaces and blank lines.

extern crate trim_margin;
use trim_margin::MarginTrimmable;

fn main() {
    let multiline_string_with_margin = "
        |This string has a margin
        |indicated by the '|' character.
        |
        |The following method call will remove ...
        | * a blank first/last line
        | * blanks before the margin prefix
        | * the margin prefix itself
    ".trim_margin().unwrap();
    println!("{}", multiline_string_with_margin);
}

No runtime deps