de.vandermeer.asciitable.commons

Class ArrayTransformations

Object

ArrayTransformations

public abstract class ArrayTransformations
extends Object

Collections array transformation methods.

Since:

v0.0.1

Version:

v0.2.3 build 150910 (10-Sep-15) for Java 1.7

Author:

Sven van der Meer <vdmeer.sven@mykolab.com>

Constructor Summary

Constructors

Constructor and Description
ArrayTransformations()

Method Summary

Modifier and Type	Method and Description
static <T> StrBuilder	ARRAY_TO_STRING(T[][] ar) Takes a 2 dimensional array and returns a string representation in table form.
static String[][]	FLIP_ARRAY(String[][] ar) Flips an array of arrays (a table).
static String[][]	NORMALISE_ARRAY(int length, String[][] ar) Normalizes an array of strings.
static String[]	PROCESS_CONTENT(Object content) Takes an object (used as a string) and returns a string array with all processed lines.
static String[]	WRAP_LINES(int length, Object obj) Takes an object (used as a string) and returns a string array with wrapped lines of max length.
static String[]	WRAP_LINES(int length, String[] ar) Takes an content array (of strings) and returns a string array with wrapped lines of max length using WRAP_LINES(int, Object).

Methods inherited from class Object

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

Constructor Detail

ArrayTransformations

public ArrayTransformations()

Method Detail

ARRAY_TO_STRING

public static final <T> StrBuilder ARRAY_TO_STRING(T[][] ar)

Takes a 2 dimensional array and returns a string representation in table form.

Type Parameters:

T - type of the input array

Parameters:

ar - the array to be transformed

Returns:

a string representation of the array

FLIP_ARRAY

public static final String[][] FLIP_ARRAY(String[][] ar)

Flips an array of arrays (a table). For each cell in the table the row and column indexes are 'turned over', that is for instance the cell [1][2] becomes [2][1]. Consider an input table of

 row 1: a1, b1, c1
 row 2: a2, b2, c2
 row 3: a3, b3, c3
 

The transformed table will be

 row 1: a1, a2, a3
 row 2: b1, b2, b3
 row 3: c1, c2, c3
 

Parameters:

ar - input array which will be flipped

Returns:

flipped array, null if input was null

NORMALISE_ARRAY

public static final String[][] NORMALISE_ARRAY(int length,
                                               String[][] ar)

Normalizes an array of strings.

Parameters:

length - number of columns in the transformed string array

ar - input array which will be normalized

Returns:

a normalized array

PROCESS_CONTENT

public static final String[] PROCESS_CONTENT(Object content)

Takes an object (used as a string) and returns a string array with all processed lines. The process is as follows: (1) replace all line breaks (CR LF, CR, LF) into HTML4 line break entity (<br>). (2) replace all HTML4 line break entities to HTML5 entities (as in self-closing <br/> entity). (3) use a tokenizer to process the resulting string (not ignoring empty tokens, since they mark required line breaks). (4) return the array of the tokenizer As a result, a string containing 1 line break will be converted into 2 paragraphs (array length 2):

	String: "paragraph 1\nparagraph 2"
	Array:  {paragraph 1,paragraph 2}
 

A string containing 2 line breaks will be converted into 3 strings (first paragraph, additional line break, second paragraph):

	String: "paragraph 1\n\nparagraph 2"
	Array: {paragraph 1,,paragraph 2}
 

Parameters:

content - the content to process

Returns:

null if content was null, empty array if content was an empty string, string array with lines otherwise

WRAP_LINES

public static final String[] WRAP_LINES(int length,
                                        String[] ar)

Takes an content array (of strings) and returns a string array with wrapped lines of max length using WRAP_LINES(int, Object). The wrapping is done using StringUtils and WordUtils so that words are not broken into characters.

Parameters:

length - max length of a string in the returned array

ar - array with one line per array entry, null and empty objects are allowed

Returns:

string array with wrapped strings: null of input object was null or its toString() returned null, empty array if empty string, array with lines of wrappings otherwise

WRAP_LINES

public static final String[] WRAP_LINES(int length,
                                        Object obj)

Takes an object (used as a string) and returns a string array with wrapped lines of max length. The wrapping is done using StringUtils and WordUtils so that words are not broken into characters.

Parameters:

length - max length of a string in the returned array

obj - input object, null and empty objects are allowed

Returns:

string array with wrapped strings: null of input object was null or its toString() returned null, empty array if empty string, array with lines of wrappings otherwise