jexer.bits

Class StringUtils

java.lang.Object

jexer.bits.StringUtils

public class StringUtils
extends java.lang.Object

StringUtils contains methods to: - Convert one or more long lines of strings into justified text paragraphs. - Unescape C0 control codes. - Read/write a line of RFC4180 comma-separated values strings to/from a list of strings.

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Modifier and Type	Method and Description
static java.util.List<java.lang.String>	center(java.lang.String str, int n) Center a string into a list of lines.
static java.util.List<java.lang.String>	fromCsv(java.lang.String line) Read a line of RFC4180 comma-separated values (CSV) into a list of strings.
static java.util.List<java.lang.String>	full(java.lang.String str, int n) Fully-justify a string into a list of lines.
static boolean	isCjk(int ch) Check if character is in the CJK range.
static boolean	isEmoji(int ch) Check if character is in the emoji range.
static java.util.List<java.lang.String>	left(java.lang.String str, int n) Left-justify a string into a list of lines.
static java.util.List<java.lang.String>	right(java.lang.String str, int n) Right-justify a string into a list of lines.
static java.lang.String	toCsv(java.util.List<java.lang.String> list) Write a list of strings to on line of RFC4180 comma-separated values (CSV).
static java.lang.String	unescape(java.lang.String str) Convert raw strings into escaped strings that be splatted on the screen.
static int	width(int ch) Determine display width of a Unicode code point.
static int	width(java.lang.String str) Determine display width of a string.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtils

public StringUtils()

Method Detail

left

public static java.util.List<java.lang.String> left(java.lang.String str,
                                                    int n)

Left-justify a string into a list of lines.

Parameters:

str - the string

n - the maximum number of characters in a line

Returns:

the list of lines

right

public static java.util.List<java.lang.String> right(java.lang.String str,
                                                     int n)

Right-justify a string into a list of lines.

Parameters:

str - the string

n - the maximum number of characters in a line

Returns:

the list of lines

center

public static java.util.List<java.lang.String> center(java.lang.String str,
                                                      int n)

Center a string into a list of lines.

Parameters:

str - the string

n - the maximum number of characters in a line

Returns:

the list of lines

full

public static java.util.List<java.lang.String> full(java.lang.String str,
                                                    int n)

Fully-justify a string into a list of lines.

Parameters:

str - the string

n - the maximum number of characters in a line

Returns:

the list of lines

unescape

public static java.lang.String unescape(java.lang.String str)

Convert raw strings into escaped strings that be splatted on the screen.

Parameters:

str - the string

Returns:

a string that can be passed into Screen.putStringXY()

fromCsv

public static java.util.List<java.lang.String> fromCsv(java.lang.String line)

Read a line of RFC4180 comma-separated values (CSV) into a list of strings.

Parameters:

line - the CSV line, with or without without line terminators

Returns:

the list of strings

toCsv

public static java.lang.String toCsv(java.util.List<java.lang.String> list)

Write a list of strings to on line of RFC4180 comma-separated values (CSV).

Parameters:

list - the list of strings

Returns:

the CSV line, without any line terminators

width

public static int width(int ch)

Determine display width of a Unicode code point.

Parameters:

ch - the code point, can be char

Returns:

the number of text cell columns required to display this code point, one of 0, 1, or 2

width

public static int width(java.lang.String str)

Determine display width of a string. This ASSUMES that no characters are combining. Hopefully no users will be impacted.

Parameters:

str - the string

Returns:

the number of text cell columns required to display this string

isCjk

public static boolean isCjk(int ch)

Check if character is in the CJK range.

Parameters:

ch - character to check

Returns:

true if this character is in the CJK range

isEmoji

public static boolean isEmoji(int ch)

Check if character is in the emoji range.

Parameters:

ch - character to check

Returns:

true if this character is in the emoji range