aQute.lib.strings

Class Strings

java.lang.Object

aQute.lib.strings.Strings

public class Strings
extends Object

Constructor Summary

Constructors

Constructor and Description
Strings()

Method Summary

Modifier and Type	Method and Description
static int	adjustBegin(String s, int n)
static int	adjustEnd(String s, int n)
static char	charAt(String s, int n)
static boolean	compareExcept(String a, String b, Pattern pattern) Compare two strings except for where the first group in pattern.
static String	delete(String s, int begin, int end)
static String	display(Object o, Object... ifNull)
static String	ensurePrefix(String s, String prefix)
static String	ensureSuffix(String s, String suffix)
static String[]	extension(String s) Split a string into a base and an extension.
static String[]	first(String s, char separator)
static String	format(String string, Object... parms) This method is the same as String.format but it makes sure that any arrays are transformed to strings.
static String	from(String s, int n)
static String	getLastSegment(String name)
static String	getLastSegment(String name, char c)
static boolean	in(String[] skip, String key)
static String	join(Iterable<?> objects)
static String	join(Object[] strings)
static String	join(String[] strings)
static void	join(StringBuilder sb, String middle, Iterable<?> objects, Pattern pattern, String replace)
static String	join(String middle, Iterable<?> objects)
static String	join(String middle, Iterable<?> objects, Pattern pattern, String replace)
static String	join(String middle, Object[] segments)
static Collector<CharSequence,?,String>	joining()
static Collector<CharSequence,?,String>	joining(CharSequence delimiter, CharSequence prefix, CharSequence suffix, CharSequence emptyValue)
static String[]	last(String s, char separator) Split a string into a prefix and a suffix based on the last time the separator appears
static String[]	lastPathSegment(String s) Split a path (/ based) into a prefix and a last segment
static boolean	notEmpty(String s)
static List<String>	split(String s)
static List<String>	split(String regex, String s)
static Stream<String>	splitAsStream(String s)
static List<String>	splitLines(String s)
static Stream<String>	splitLinesAsStream(String s)
static List<String>	splitQuoted(String s)
static Stream<String>	splitQuotedAsStream(String s)
static String	stripPrefix(String s, Pattern p)
static String	stripPrefix(String s, String prefix)
static String	stripSuffix(String s, Pattern p)
static String	stripSuffix(String s, String prefix)
static String	substring(String s, int begin, int end)
static String	substring(String s, int begin, int end, int stride)
static String	times(String s, int times)
static String	to(String s, int end)
static String	trim(String s)

Methods inherited from class java.lang.Object

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

Constructor Detail

Strings

public Strings()

Method Detail

join

public static String join(String middle,
                          Iterable<?> objects)

join

public static String join(Iterable<?> objects)

join

public static String join(String middle,
                          Iterable<?> objects,
                          Pattern pattern,
                          String replace)

join

public static void join(StringBuilder sb,
                        String middle,
                        Iterable<?> objects,
                        Pattern pattern,
                        String replace)

join

public static String join(String middle,
                          Object[] segments)

joining

public static Collector<CharSequence,?,String> joining()

joining

public static Collector<CharSequence,?,String> joining(CharSequence delimiter,
                                                       CharSequence prefix,
                                                       CharSequence suffix,
                                                       CharSequence emptyValue)

display

public static String display(Object o,
                             Object... ifNull)

join

public static String join(String[] strings)

join

public static String join(Object[] strings)

getLastSegment

public static String getLastSegment(String name,
                                    char c)

getLastSegment

public static String getLastSegment(String name)

trim

public static String trim(String s)

notEmpty

public static boolean notEmpty(String s)

splitAsStream

public static Stream<String> splitAsStream(String s)

split

public static List<String> split(String s)

splitQuotedAsStream

public static Stream<String> splitQuotedAsStream(String s)

splitLinesAsStream

public static Stream<String> splitLinesAsStream(String s)

splitLines

public static List<String> splitLines(String s)

splitQuoted

public static List<String> splitQuoted(String s)

split

public static List<String> split(String regex,
                                 String s)

in

public static boolean in(String[] skip,
                         String key)

charAt

public static char charAt(String s,
                          int n)

from

public static String from(String s,
                          int n)

substring

public static String substring(String s,
                               int begin,
                               int end)

substring

public static String substring(String s,
                               int begin,
                               int end,
                               int stride)

delete

public static String delete(String s,
                            int begin,
                            int end)

to

public static String to(String s,
                        int end)

adjustBegin

public static int adjustBegin(String s,
                              int n)

adjustEnd

public static int adjustEnd(String s,
                            int n)

extension

public static String[] extension(String s)

Split a string into a base and an extension.

Parameters:

s - the string that contains an extension

Returns:

null if no extension or an array of 2 elements, first is the prefix and second is the extension without a '.'

lastPathSegment

public static String[] lastPathSegment(String s)

Split a path (/ based) into a prefix and a last segment

Parameters:

s - the string that contains a path

Returns:

null if no extension or an array of 2 elements, first is the prefix and second is the last segment without a '/' at the start

last

public static String[] last(String s,
                            char separator)

Split a string into a prefix and a suffix based on the last time the separator appears

Parameters:

s - the string that contains a path

Returns:

null if no extension or an array of 2 elements, first is the prefix and second is the last segment without the separator at the start

first

public static String[] first(String s,
                             char separator)

stripPrefix

public static String stripPrefix(String s,
                                 String prefix)

stripPrefix

public static String stripPrefix(String s,
                                 Pattern p)

stripSuffix

public static String stripSuffix(String s,
                                 String prefix)

stripSuffix

public static String stripSuffix(String s,
                                 Pattern p)

ensureSuffix

public static String ensureSuffix(String s,
                                  String suffix)

ensurePrefix

public static String ensurePrefix(String s,
                                  String prefix)

times

public static String times(String s,
                           int times)

format

public static String format(String string,
                            Object... parms)

This method is the same as String.format but it makes sure that any arrays are transformed to strings.

Parameters:

string -

parms -

compareExcept

public static boolean compareExcept(String a,
                                    String b,
                                    Pattern pattern)

Compare two strings except for where the first group in pattern. The patterns is matched in the strings using find(). Only group 1 is ignored. Use ignored groups to ignore irrelevant groups.

                a = "abcdefxxxxghixxxxx678"
                b = "abcdefxxghix678"
                Pattern "(x+)"
 

First developed to compare two XML files that only differed in their increment number, which was a time long.

Parameters:

a - the first string to compare

b - the second string to compare

pattern - where first group should be ignored in the comparison

Returns:

true if the strings are equal ignoring the first group's pattern matches