xyz.cofe.text

Class Text

java.lang.Object

xyz.cofe.text.Text

public class Text
extends Object

Функции по обработки текста

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Text.Convertors Конверторы текста
static interface	Text.ParseStringResult Результат анализа текста
static class	Text.Predicates Текстовые предикаты
static class	Text.SimpleParseResult

Field Summary

Fields

Modifier and Type	Field and Description
protected static Map<String,String>	text2HtmlCharMap

Constructor Summary

Constructors

Constructor and Description
Text()

Method Summary

Modifier and Type	Method and Description
static Iterable<String>	align(Iterable<String> lines, Align align, String padText, int len)
static String[]	align(String[] lines, Align align, String padText, int len) Выравнивает текст до определенной длины.
static String	align(String text, Align align, String padText, int len) Выравнивает текст до определенной длинны.
static String	attrDecode(String attr) Декодирование атрибута HTML
static String	attrEncode(String text) Кодирует текст в html экранированный текст.
static Iterable<String>	convert(Iterable<String> source, Convertor<String,String> convertor) Обрабатывает набор строк согласно ковертору, т.е. каждая строка пропускается через конвертор и его результат попадает результирующий набор
static String[]	convert(String[] source, Convertor<String,String> convertor) Обрабатывает набор строк согласно ковертору, т.е. каждая строка пропускается через конвертор и его результат попадает результирующий набор
static byte[]	decodeHex(String bytes) Возвращает баты их hex представления
static Byte[]	decodeHexBytes(String bytes) Возвращает баты их hex представления
static List<String>	dropFirstEmptyLines(Iterable<String> lines) Убирает из набора строк первые пустые (null или их длина меньше 1) строки
static String[]	dropFirstEmptyLines(String[] lines) Убирает из набора строк первые пустые (null или их длина меньше 1) строки
static List<String>	dropLastEmptyLines(Iterable<String> lines) Убирает из набора строк последние пустые (null или их длина меньше 1) строки
static String[]	dropLastEmptyLines(String[] lines) Убирает из набора строк последние пустые (null или их длина меньше 1) строки
static String	encodeHex(byte[] bytes) Возвращает символное-hex представление байтов
static String	encodeHex(Byte[] bytes) Возвращает символное-hex представление байтов
static String	encodeStringConstant(String srcText) Кодирует текст в строковую констануту вида языка С.
static String	encodeStringConstant(String srcText, char quoteChar) Кодирует текст в строковую констануту вида языка С.
static String	format(String format, Number num) Форматирование числа
static String	getHex(byte byteValue) Возвращает двух символьное представление байта
static String	getHex(byte[] bytes) Возвращает символное-hex представление байтов
static String	getHex(Byte[] bytes) Возвращает символное-hex представление байтов
static Map<String,String>	getText2HtmlCharMap() Карта преобразования текста в html валидный текст
static String	htmlDecode(String html) Декодирует текст из html кодировки
static String	htmlEncode(String text) Кодирует текст в html экранированный текст.
static boolean	in(String src, Iterable<String> list)
static boolean	in(String src, String... arr)
static Iterable<String>	indent(Iterable<String> source, String indent)
static String[]	indent(String[] sourceLines, String indent) Добавляет отступ
static String	indent(String srcText, String indent)
static String	indent(String source, String lineDelim, String indent) Добавляет отступ в начало каждой строки
static int[]	indexesOf(Predicate<String> src, Iterable<String> arr)
static int[]	indexesOf(Predicate<String> src, String... arr)
static int	indexOf(String src, Iterable<String> list)
static int	indexOf(String src, String... arr)
static int	indexOfNonWSChar(String text) Возвращает первый индекс не пробельного символа
static int	indexOfNonWSChar(String text, int begin, int endexclusive) Возвращает первый индекс не пробельного символа
static String	join(Iterable<String> lines, String glue) Объединяет строки вставляя между ними заданную строку
static String	join(Iterable<String> lines, String glue, boolean withNulls) Объединяет строки вставляя между ними заданную строку
static String	join(Iterable<String> lines, String glue, int from, int count, boolean withNulls) Объединяет строки вставляя между ними заданную строку
static String	join(String[] lines, String glue) Объединяет строки вставляя между ними заданную строку
static String	join(String[] lines, String glue, int from, int count) Объединяет строки вставляя между ними заданную строку
static String	join(String[] lines, String glue, int from, int count, boolean withNulls) Объединяет строки вставляя между ними заданную строку
static String	lookupText(String source, int beginIndex, int len) Возвращает строку из указанной позиции заданной или меньше длинны
static boolean	matchText(String source, String needly, int beginIndex, boolean ignoreCase) Сравнивает часть текста с образцом
static Pair<Integer,String>	nextNewLine(String text, int beginIndex) Ищет начало новой строки, учитывает различ. варианты перевода строк
static Text.ParseStringResult	parseStringConstat(String constant, int startIndex) Анализирует текстовую константу языка С Синтаксис строки Константа ::= {Пробельный символ} Кавычки {Кодированный символ} Кавычки Пробельный символ ::= пробел | перевод строи | возврат корретки | табуляция Кавычки ::= '"' Кодированный символ ::= ( '\' экранированный символ ) | обычный символ Экранированный символ ::= 'n' | 'r' | 't' | '"' | '\'
static Map<String,String>	queryStringDecodeMap(String queryString) Декодирует QueryString
static Map<String,List<String>>	queryStringDecodeMultiMap(String queryString) Декодирует QueryString
static String	queryStringEncodeMap(Map<String,String> map, boolean allowNullKey, boolean allowNullValue) Кодирует карту в форме QueryString
static String[]	queryStringKeyValueSplit(String keyValuePair, boolean allowNullValue) Разделяет кодированную пару ключ/значение (QueryString) на декодированные пары
static List<String>	queryStringSplit(String queryString, Iterable<String> specChars, boolean specCharsIgnoreCase, Convertor<String,String> specCharConv, boolean checkComment) Разделяет query string по символу амперсанда на наборы ключ/значени
static String	repeat(String text, int count) Повторяет текст указанное кол-во раз.
static String[]	split(String src, String splitter) Разделяет строку на подстроки, где в качестве разделитя указана строка.
static Iterable<String>	splitIterable(String src, String splitter)
static String[]	splitNewLines(String line) Делит текст на строки согласно символам перевода строк: CR+LF/CR/LF (\r\n, \r, \n).
static Iterable<String>	splitNewLinesIterable(String text)
static String	trimEnd(String text, String trimText) Возвращает строку исключая указанный текст (если он присуствует 1 или более раз) в конце.
static String	trimStart(String text) Удаляет пробельные символы с начала строки
static String	trimStart(String text, int max) Удаляет пробельные символы с начала строки
static String	trimStart(String text, String trimText) Возвращает строку исключая указанный текст (если он присуствует 1 или более раз) в начале.
static String	urlDecode(String text) Декодирует текст методом URL-encoding, используя кодировку UTF-8
static String	urlDecode(String text, String charset) Декодирует текст методом URL-encoding
static String	urlEncode(String text) Кодирует текст методом URL-encoding, используя кодировку UTF-8
static String	urlEncode(String text, String charset) Кодирует текст методом URL-encoding
static Pattern	wildcard(String wildcard, boolean escapeAllowed, boolean ignoreCase) Создает шаблон регулярного выражения из маски (*?)
static String[]	wordWrap(String text, int maxwidth) Перенос слов на несколько строк.
static Iterable<String>	wordWrapIterable(String text, int maxwidth)

Methods inherited from class java.lang.Object

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

Field Detail

text2HtmlCharMap

protected static Map<String,String> text2HtmlCharMap

Constructor Detail

Text

public Text()

Method Detail

getHex

public static String getHex(byte[] bytes)

Возвращает символное-hex представление байтов

Parameters:

bytes - Байты

Returns:

Строка - символное-hex представление байтов

getHex

public static String getHex(Byte[] bytes)

Возвращает символное-hex представление байтов

Parameters:

bytes - Байты

Returns:

Строка - символное-hex представление байтов

getHex

public static String getHex(byte byteValue)

Возвращает двух символьное представление байта

Parameters:

byteValue - байт

Returns:

два символа представляющих байт (00 .. FF)

encodeHex

public static String encodeHex(byte[] bytes)

Возвращает символное-hex представление байтов

Parameters:

bytes - байты

Returns:

Строка - символное-hex представление байтов

encodeHex

public static String encodeHex(Byte[] bytes)

Возвращает символное-hex представление байтов

Parameters:

bytes - байты

Returns:

Строка - символное-hex представление байтов

decodeHex

public static byte[] decodeHex(String bytes)

Возвращает баты их hex представления

Parameters:

bytes - - символное-hex представление байтов

Returns:

bytes байты

decodeHexBytes

public static Byte[] decodeHexBytes(String bytes)

Возвращает баты их hex представления

Parameters:

bytes - - символное-hex представление байтов

Returns:

bytes байты

getText2HtmlCharMap

public static Map<String,String> getText2HtmlCharMap()

Карта преобразования текста в html валидный текст

Returns:

Карта text / html

htmlDecode

public static String htmlDecode(String html)

Декодирует текст из html кодировки

Parameters:

html - HTML кодировка (допускется null)

Returns:

Декодированный текст (допускется null) Декодирует символы:

1. &lt; в <
2. &gt; в >
3. &amp; в &
4. &quot; в "
5. &apos; в '
6. &nbsp; в пробел

htmlEncode

public static String htmlEncode(String text)

Кодирует текст в html экранированный текст. Экранирует символы:

1. < в &lt;
2. > в &gt;
3. & в &amp;

Parameters:

text - Исходный текст (допускется null)

Returns:

html текст (допускется null)

attrEncode

public static String attrEncode(String text)

Кодирует текст в html экранированный текст.
Экранирует символы:

1. < в &lt;
2. > в &gt;
3. & в &amp;
4. " в &quot;
5. ' в &apos;

Parameters:

text - Исходный текст (допускется null)

Returns:

html текст (допускется null)

attrDecode

public static String attrDecode(String attr)

Декодирование атрибута HTML

Parameters:

attr - Атрибут HTML кодированный

Returns:

Декодированный HTML атрибут

urlDecode

public static String urlDecode(String text)

Декодирует текст методом URL-encoding, используя кодировку UTF-8

Parameters:

text - Кодированый текст

Returns:

исходный текст

urlDecode

public static String urlDecode(String text,
                               String charset)

Декодирует текст методом URL-encoding

Parameters:

text - Кодированый текст

charset - Кодировка

Returns:

исходный текст

urlEncode

public static String urlEncode(String text)

Кодирует текст методом URL-encoding, используя кодировку UTF-8

Parameters:

text - Текст

Returns:

Кодированый текст

urlEncode

public static String urlEncode(String text,
                               String charset)

Кодирует текст методом URL-encoding

Parameters:

text - Текст

charset - кодировка

Returns:

Кодированый текст

queryStringEncodeMap

public static String queryStringEncodeMap(Map<String,String> map,
                                          boolean allowNullKey,
                                          boolean allowNullValue)

Кодирует карту в форме QueryString

Parameters:

map - Карта

allowNullKey - true - допускается использование null ключей

allowNullValue - true - допускается использование null значений

Returns:

QueryString

queryStringDecodeMap

public static Map<String,String> queryStringDecodeMap(String queryString)

Декодирует QueryString

Parameters:

queryString - строка запроса

Returns:

карта

queryStringDecodeMultiMap

public static Map<String,List<String>> queryStringDecodeMultiMap(String queryString)

Декодирует QueryString

Parameters:

queryString - строка запроса

Returns:

карта

queryStringKeyValueSplit

public static String[] queryStringKeyValueSplit(String keyValuePair,
                                                boolean allowNullValue)

Разделяет кодированную пару ключ/значение (QueryString) на декодированные пары

Parameters:

keyValuePair - строка ключ/значение, разделенные знаком Равно

allowNullValue - true - допускается отсуствие значения или/и символа Равно

Returns:

Декодированная пара или null

queryStringSplit

public static List<String> queryStringSplit(String queryString,
                                            Iterable<String> specChars,
                                            boolean specCharsIgnoreCase,
                                            Convertor<String,String> specCharConv,
                                            boolean checkComment)

Разделяет query string по символу амперсанда на наборы ключ/значени

Parameters:

queryString - query строка

specChars - перечень специальных символов, таких как амперсанд - &amp; и т.д. Если указано null - то испобльзуется значение getText2HtmlCharMap()

specCharsIgnoreCase - - true - игнорировать регистр букв в специальных символах

specCharConv - функция конвертации специальных симвлов в нормальные, если указанно null, то используется значение из getText2HtmlCharMap()

checkComment - если true - то проверяет наличие символа решетки, и если сам символ есть, и все что за ним следует - не попадет в резуьтат

Returns:

Список кодированых пар значений (ключ=значение)

See Also:

getText2HtmlCharMap()

lookupText

public static String lookupText(String source,
                                int beginIndex,
                                int len)

Возвращает строку из указанной позиции заданной или меньше длинны

Parameters:

source - исходный текст

beginIndex - позиция, больше или равно 0, может быть больше длины строки

len - длина искомого текста (может быть за пределами границ текста), больше или равен 0

Returns:

текст, если за границами вернет пустую строку

matchText

public static boolean matchText(String source,
                                String needly,
                                int beginIndex,
                                boolean ignoreCase)

Сравнивает часть текста с образцом

Parameters:

source - текст

needly - образец

beginIndex - индекс (может быть за пределами строки, но не меньше 0)

ignoreCase - игнорировать регистр

Returns:

совпадает / не совпадает

nextNewLine

public static Pair<Integer,String> nextNewLine(String text,
                                               int beginIndex)

Ищет начало новой строки, учитывает различ. варианты перевода строк

Parameters:

text - Текст

beginIndex - с какого индекса начать поиск

Returns:

Пара (начало строки, предшеств. сиволы перевода строк) или null

dropFirstEmptyLines

public static String[] dropFirstEmptyLines(String[] lines)

Убирает из набора строк первые пустые (null или их длина меньше 1) строки

Parameters:

lines - Набор строк

Returns:

Набор строк

dropFirstEmptyLines

public static List<String> dropFirstEmptyLines(Iterable<String> lines)

Убирает из набора строк первые пустые (null или их длина меньше 1) строки

Parameters:

lines - Набор строк

Returns:

Набор строк

dropLastEmptyLines

public static String[] dropLastEmptyLines(String[] lines)

Убирает из набора строк последние пустые (null или их длина меньше 1) строки

Parameters:

lines - Набор строк

Returns:

Набор строк

dropLastEmptyLines

public static List<String> dropLastEmptyLines(Iterable<String> lines)

Убирает из набора строк последние пустые (null или их длина меньше 1) строки

Parameters:

lines - Набор строк

Returns:

Набор строк

convert

public static Iterable<String> convert(Iterable<String> source,
                                       Convertor<String,String> convertor)

Обрабатывает набор строк согласно ковертору, т.е. каждая строка пропускается через конвертор и его результат попадает результирующий набор

Parameters:

source - Исходный набор строк

convertor - Конвертор строки

Returns:

Результат конвертации

convert

public static String[] convert(String[] source,
                               Convertor<String,String> convertor)

Обрабатывает набор строк согласно ковертору, т.е. каждая строка пропускается через конвертор и его результат попадает результирующий набор

Parameters:

source - Исходный набор строк

convertor - Конвертор строки

Returns:

Результат конвертации

indexOfNonWSChar

public static int indexOfNonWSChar(String text,
                                   int begin,
                                   int endexclusive)

Возвращает первый индекс не пробельного символа

Parameters:

text - Текст

begin - Индекс с которого начинается поиск

endexclusive - Индекс исключ. по которй ведется поиск

Returns:

индекс или -1

indexOfNonWSChar

public static int indexOfNonWSChar(String text)

Возвращает первый индекс не пробельного символа

Parameters:

text - Текст

Returns:

индекс или -1

trimStart

public static String trimStart(String text)

Удаляет пробельные символы с начала строки

Parameters:

text - Строка

Returns:

Строка без пробелов в начале

trimStart

public static String trimStart(String text,
                               int max)

Удаляет пробельные символы с начала строки

Parameters:

text - Строка

max - Максимальное кол-во удаляемых пробельных символов или -1

Returns:

Строка без пробелов в начале

trimStart

public static String trimStart(String text,
                               String trimText)

Возвращает строку исключая указанный текст (если он присуствует 1 или более раз) в начале.

trimStart( "ababtcv" , "ab" ) // Результат "tcv"

Parameters:

text - Исходная строка

trimText - Текст который необходимо удалить

Returns:

Результат

trimEnd

public static String trimEnd(String text,
                             String trimText)

Возвращает строку исключая указанный текст (если он присуствует 1 или более раз) в конце.

trimEnd( "ababtcvtcv" , "tcv" ) // Результат "abab"

Parameters:

text - Исходная строка

trimText - Текст который необходимо удалить

Returns:

Результат

repeat

public static String repeat(String text,
                            int count)

Повторяет текст указанное кол-во раз.

Parameters:

text - Текст

count - Сколько раз повторить ( <= 0 - пустая строка; == 1 - исходная; >= 2 - соответ. кол-во повторов)

Returns:

Результат

split

public static String[] split(String src,
                             String splitter)

Разделяет строку на подстроки, где в качестве разделитя указана строка.

Исходная строка	Разделитель	Результат
"delim"	"delim"	""
"delimabc"	"delim"	"" "abc"
"abcdelimabc"	"delim"	"abc" "abc"
"abcdelim"	"delim"	"abc" ""
"abc"	"delim"	"abc"
"abc"	""	"abc"

Parameters:

src - Исходня строка

splitter - Разделитель

Returns:

Подстроки

splitIterable

public static Iterable<String> splitIterable(String src,
                                             String splitter)

join

public static String join(Iterable<String> lines,
                          String glue)

Объединяет строки вставляя между ними заданную строку

Parameters:

lines - Строки

glue - Вставка

Returns:

Результат склейки

join

public static String join(Iterable<String> lines,
                          String glue,
                          boolean withNulls)

Объединяет строки вставляя между ними заданную строку

Parameters:

lines - Строки

glue - Вставка

withNulls - включить также пустые ссылки

Returns:

Результат склейки

join

public static String join(Iterable<String> lines,
                          String glue,
                          int from,
                          int count,
                          boolean withNulls)

Объединяет строки вставляя между ними заданную строку

Parameters:

lines - Строки

glue - Вставка

from - С какой строки начать (withNulls - влияет на нумерацию)

count - Сколько строк объединять? -1 - без ограничения

withNulls - включить также пустые ссылки

Returns:

Результат склейки

join

public static String join(String[] lines,
                          String glue,
                          int from,
                          int count)

Объединяет строки вставляя между ними заданную строку

Parameters:

lines - Строки

glue - Вставка

from - С какой строки начать

count - Сколько строк объединять

Returns:

Результат склейки

join

public static String join(String[] lines,
                          String glue,
                          int from,
                          int count,
                          boolean withNulls)

Объединяет строки вставляя между ними заданную строку

Parameters:

lines - Строки

glue - Вставка

from - С какой строки начать

count - Сколько строк объединять

withNulls - включить также пустые ссылки

Returns:

Результат склейки

join

public static String join(String[] lines,
                          String glue)

Объединяет строки вставляя между ними заданную строку

Parameters:

lines - Строки

glue - Вставка

Returns:

Результат склейки

in

public static boolean in(String src,
                         String... arr)

indexOf

public static int indexOf(String src,
                          String... arr)

indexesOf

public static int[] indexesOf(Predicate<String> src,
                              String... arr)

indexesOf

public static int[] indexesOf(Predicate<String> src,
                              Iterable<String> arr)

in

public static boolean in(String src,
                         Iterable<String> list)

indexOf

public static int indexOf(String src,
                          Iterable<String> list)

wordWrapIterable

public static Iterable<String> wordWrapIterable(String text,
                                                int maxwidth)

wordWrap

public static String[] wordWrap(String text,
                                int maxwidth)

Перенос слов на несколько строк.

Parameters:

text - Исходный текст

maxwidth - Максимальная длина колонки

Returns:

Набор строк

align

public static String[] align(String[] lines,
                             Align align,
                             String padText,
                             int len)

Выравнивает текст до определенной длины. Если текст привышает или равен указанную длину, то возвращается как есть

Parameters:

lines - Текст

align - Как выравнивать.

padText - Текст который добавляется для выравнивания (Возможно null - тогда будет использоваться один пробел)

len - Длина текста, не меньше нуля по каторой выравнивается.

Returns:

Текст

align

public static Iterable<String> align(Iterable<String> lines,
                                     Align align,
                                     String padText,
                                     int len)

align

public static String align(String text,
                           Align align,
                           String padText,
                           int len)

Выравнивает текст до определенной длинны. Если текст привышает или равен указанную длину, то возвращается как есть

Parameters:

text - Текст

align - Как выравнивать.
Begin - Выравнивать по левому краю, пробельные символы добавляются в конец.
Center - Выравнивать по центру, пробельные символы добавляются с обоих краев.
End - Выравнивать по правому краю, пробельные символы добавляются в начало.

padText - Текст который добавляется для выравнивания (Возможно null - тогда будет использоваться один пробел)

len - Длина текста, не меньше нуля по каторой выравнивается.

Returns:

Текст

indent

public static String indent(String srcText,
                            String indent)

indent

public static String indent(String source,
                            String lineDelim,
                            String indent)

Добавляет отступ в начало каждой строки

Parameters:

source - Исходный текст

lineDelim - Разделитель строк

indent - Отступ

Returns:

Строки с отступом

indent

public static String[] indent(String[] sourceLines,
                              String indent)

Добавляет отступ

Parameters:

sourceLines - Исходный набор строк

indent - Отступ

Returns:

Строки с отступом

indent

public static Iterable<String> indent(Iterable<String> source,
                                      String indent)

splitNewLinesIterable

public static Iterable<String> splitNewLinesIterable(String text)

splitNewLines

public static String[] splitNewLines(String line)

Делит текст на строки согласно символам перевода строк: CR+LF/CR/LF (\r\n, \r, \n).
Сами символы (CR,LF) не входят в результирующий набор строк.

Parameters:

line - Текст

Returns:

Результат.

encodeStringConstant

public static String encodeStringConstant(String srcText,
                                          char quoteChar)

Кодирует текст в строковую констануту вида языка С.
Экраниует символы: " \ \t \r \n \b \f

Примеры:

abc	"abc"
abc "dfg" sss	"abc \"dfg\" sss"
abc\sss	"abc\\sss"

Parameters:

srcText - Исходный текст

quoteChar - Символ экранирования

Returns:

Кодированый текст

encodeStringConstant

public static String encodeStringConstant(String srcText)

Кодирует текст в строковую констануту вида языка С.
Экраниует символы: " \ \t \r \n \b \f

Примеры:

abc	"abc"
abc "dfg" sss	"abc \"dfg\" sss"
abc\sss	"abc\\sss"

Parameters:

srcText - Исходный текст

Returns:

Кодированый текст

parseStringConstat

public static Text.ParseStringResult parseStringConstat(String constant,
                                                        int startIndex)

Анализирует текстовую константу языка С

Синтаксис строки
Константа ::= {Пробельный символ} Кавычки {Кодированный символ} Кавычки
Пробельный символ ::= пробел | перевод строи | возврат корретки | табуляция
Кавычки ::= '"'
Кодированный символ ::= ( '\' экранированный символ ) | обычный символ
Экранированный символ ::= 'n' | 'r' | 't' | '"' | '\'

Parameters:

constant - Константа (или null)

startIndex - Индекс (0 ... длина строки)

Returns:

Результат анализа или null, если не соответствует кодированию (или входные параметры не удалетворяют условию)

wildcard

public static Pattern wildcard(String wildcard,
                               boolean escapeAllowed,
                               boolean ignoreCase)

Создает шаблон регулярного выражения из маски (*?)

Parameters:

wildcard - Маска

escapeAllowed - Допускается в маске использовать экранирующие символы

ignoreCase - Игнорировать регистр

Returns:

шаблон регулярного выражения

format

public static String format(String format,
                            Number num)

Форматирование числа

Parameters:

format - Формат числа: Пример форматов:

+00000000.000	12.23456	"+00012345.235"
00000000.000	12.23456	"00012345.235"
### ###.## ##	1234567.2345678	"1 234 567.23 45 67 8"
+###000.00	12.23456	" +012.23"
###000.0#	12.23456	" 012.23"
###000.00####	12.2345	" 012.2345 "
###000.00####	12.23	" 012.23 "
###000.00####	12.2	" 012.20 "
#	1234.2345	"1234"
+###000,00####*100	12	" +1200 "
+###000,00####*-5.5-2.1	12	" -68.1 "

num - Число

Returns:

Строка представляющее число

See Also:

FullDecFormat