com.chemaxon.calculations.util

Class CharLayout

java.lang.Object

com.chemaxon.calculations.util.CharLayout

@Beta
public final class CharLayout
extends Object

Simple utilities for character based multiline layouts.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CharLayout.HA Possible horizontal alignments.

Method Summary

Modifier and Type	Method and Description
static List<String>	align(List<String> text, CharLayout.HA ha) Align lines.
static void	append(List<StringBuilder> rows, StringBuilder target) Append rows to a StringBuilder target.
static ArrayList<StringBuilder>	builder() Construct an empty builder.
static ArrayList<StringBuilder>	builder(String multilineString) Construct an empty builder initialized from a multiline.
static String	builderToString(List<StringBuilder> rows) Collapse builder contents to a String.
static List<String>	join(CharLayout.HA ha, String sep, List<String>... cols) Join an arbitrary set of multiliners.
static List<String>	join(List<String> col1, CharLayout.HA ha1, String sep, List<String> col2, CharLayout.HA ha2) Join two set of multiliners.
static void	joinTo(ArrayList<StringBuilder> builder, List<String> column, CharLayout.HA ha, String separator) Join a new new column to previous column(s) represented as mutable rows.
static void	joinTo(ArrayList<StringBuilder> builder, String separator) Join the same line to each row.
static void	joinTo(ArrayList<StringBuilder> builder, String[] column, CharLayout.HA ha, String separator) Join a new new column to previous column(s) represented as mutable rows.
static String[]	makeColumn(String header, int rowCount, CharLayout.HA ha, IntFunction<String> row) Create a column.
static String	mul(char c, int l)
static String	pad(String s, int l, CharLayout.HA ha) Align String to the given length.
static List<String>	prefix(String prefix, List<String> text) Prefix lines.
static String	prefixMultiline(String prefix, String multilineString) Prefix multi line String.
static List<String>	split(String s) Split to lines.
static String	toString(List<String> s) Collapse into a multiline String.
static String	toString(String[] s) Collapse into a multiline String.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

split

public static List<String> split(String s)

Split to lines.

Parameters:

s - A possibly multiline String

Returns:

Lines

prefixMultiline

public static String prefixMultiline(String prefix,
                                     String multilineString)

Prefix multi line String.

Parameters:

prefix - Prefix to attach

multilineString - Multi line String

Returns:

prefix attached

builder

public static ArrayList<StringBuilder> builder()

Construct an empty builder.

Returns:

Empty builder

builder

public static ArrayList<StringBuilder> builder(String multilineString)

Construct an empty builder initialized from a multiline.

Parameters:

multilineString - Multi line String

Returns:

Empty builder

builderToString

public static String builderToString(List<StringBuilder> rows)

Collapse builder contents to a String.

Parameters:

rows - Rows

Returns:

Single multiline string representation

append

public static void append(List<StringBuilder> rows,
                          StringBuilder target)

Append rows to a StringBuilder target.

Parameters:

rows - Rows

target - Target to append each row

toString

public static String toString(List<String> s)

Collapse into a multiline String.

Parameters:

s - Lines

Returns:

Single multiline String representation

toString

public static String toString(String[] s)

Collapse into a multiline String.

Parameters:

s - Lines

Returns:

Single multiline String representation

joinTo

public static void joinTo(ArrayList<StringBuilder> builder,
                          List<String> column,
                          CharLayout.HA ha,
                          String separator)

Join a new new column to previous column(s) represented as mutable rows.

Parameters:

builder - Previous columns. Length will be equalized. New rows will be added on demand.

column - Column to join

ha - Horizontal alignment of the new column

separator - Separator between columns

joinTo

public static void joinTo(ArrayList<StringBuilder> builder,
                          String[] column,
                          CharLayout.HA ha,
                          String separator)

Join a new new column to previous column(s) represented as mutable rows.

Parameters:

builder - Previous columns. Length will be equalized. New rows will be added on demand.

column - Column to join

ha - Horizontal alignment of the new column

separator - Separator between columns

joinTo

public static void joinTo(ArrayList<StringBuilder> builder,
                          String separator)

Join the same line to each row.

Parameters:

builder - Previous column; length will be equalized

separator - Separator to add to each row

makeColumn

public static String[] makeColumn(String header,
                                  int rowCount,
                                  CharLayout.HA ha,
                                  IntFunction<String> row)

Create a column.

Parameters:

header - Header row content, aligned to center

rowCount - Row count

ha - Horizontal alignment of further rows

row - Function to create row from 0-based row index

Returns:

Column

mul

public static String mul(char c,
                         int l)

pad

public static String pad(String s,
                         int l,
                         CharLayout.HA ha)

Align String to the given length.

Parameters:

s - A one line String. Note that the presence of '\n' characters are not checked.

l - Character count to pad to

ha - Alignment

Returns:

Aligned string with given length

Throws:

IllegalArgumentException - when the string is longer than the specified padded length

align

public static List<String> align(List<String> text,
                                 CharLayout.HA ha)

Align lines.

This method applies #pad(java.lang.String, int, com.chemaxon.descriptors.CharLayout.HA) to all lines, setting length to the length of the longest line.

Parameters:

text - Lines

ha - Desired alignemnt

Returns:

Aligned lines with equal line length

prefix

public static List<String> prefix(String prefix,
                                  List<String> text)

Prefix lines.

Parameters:

prefix - Prefix to use

text - Lines

Returns:

Prefixed lines

join

public static List<String> join(CharLayout.HA ha,
                                String sep,
                                List<String>... cols)

Join an arbitrary set of multiliners.

Parameters:

ha - Horizontal alignment for all of the columns

sep - Sparation between all columns

cols - Columns

Returns:

Joimed columns

join

public static List<String> join(List<String> col1,
                                CharLayout.HA ha1,
                                String sep,
                                List<String> col2,
                                CharLayout.HA ha2)

Join two set of multiliners.

Parameters:

col1 - First column

ha1 - Alignemnt of first column

sep - Separator between columns

col2 - Second column

ha2 - Alignment of the second column

Returns:

Lines with equal length