io.opsit.explang

Class Utils

java.lang.Object

io.opsit.explang.Utils

public class Utils
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	MAVEN_PROPS
static NumCompOp	nc
protected static Locale	numLocale

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Modifier and Type	Method and Description
static boolean[]	array(boolean... args) Make array of boolean.
static byte[]	array(byte... args) Make array of byte.
static char[]	array(char... args) Make array of char.
static double[]	array(double... args) Make array of double.
static float[]	array(float... args) Make array of float.
static int[]	array(int... args) Make array of int.
static long[]	array(long... args) Make array of long.
static short[]	array(short... args) Make array of short.
static String	arrayAsString(Object val) Convert an array to String for printout.
static String	arrayContentsAsString(Object val) Convert an array to String for printout.
static Object[]	arrayOfObjects(Object... args) Make array of Objects.
static boolean	arraysDeepEquals(Object arrayE, Object arrayV) Array deep comparison.
static Boolean	asBoolean(Object val) Coerce object to boolean.
static char	asChar(Object val) Return object as char.
static CharSequence	asCharSequenceOrNull(Object val) Convert an object to its String representation, return CharSequences as is or return null if value is null.
static void	aset(Object arrayObj, int index, Object obj) Set array element.
static Number	asNumber(Object val) Coerse object to Number.
static Object	asObject(Object val) Return argument as object.
static void	assertTrue(boolean val) Assert true value.
static String	asString(Object val) Convert an object to its String representation.
static String	asStringOrEmpty(Object val) Convert an object to its String representation or return empty String if value is null.
static String	asStringOrNull(Object val) Convert an object to its String representation or return null if value is null.
static ASTN	astnize(Object param, ParseCtx ctx) Make AST node of objects (honoring lists).
static <T> List<T>	clist(T... objs) Make unmodifiableList list of positionals args.
static Object	cloneObjectByClone(Cloneable obj) Tries to copy a Cloneable object using its clone() method.
static String	coalesce(String... strings) Return first not null not-empty argument.
static String	concat(String... strs) Concatenate string arguments.
static Object	copyObjectByCopyConstructor(Object obj) Tries to copy objects using its copy constructor.
static Object	copySeq(Object seq) Shallow copy sequence.
static Class<?>	defListClz()
static boolean	enumEqual(Enum<?> enumE, Object obj) Check if equal to enum according to the name of the enum value.
static boolean	equal(Object objA, Object objB) Check if objects are equal using Object.equals().
static String	getExplangCoreVersionStr() Return explang core jar version.
static Class<?>[]	getMethodParamsClasses(List<?> methodParams, List<?> typeSpecs) Get array of classes of method parameters given optional array of argument type specifications.
static Set<Object>	intersectSets(Set<?>... sets) Compute intersection of sets.
static boolean	isEmpty(String str) Check if String is empty.
static boolean	isFP(Number num) Check if the argument is a floating point number.
static boolean	isKnownImmutable(Object obj) Return true if Object is known to be immutable.
protected static boolean	isLast(List<?> list, int idx) Check if index is the last of the list.
static boolean	isRoundNumber(Number val) Check if Number is equal.
static <T> List<T>	list(T... objs) Make List of positionals args.
static String	listCtxVars(Compiler.ICtx ctx, Object vars, IObjectWriter w) Print contents details with selected context bindings if vars is a collection of variable names.
static String	listParseErrors(ASTN exprASTN) Print list of all parse errors for an AST subtree.
static <T,U> Map<T,U>	map(Object... objs) Make Map of (key value) pairs of positionals args.
static int	max(int intA, int intB) Return maximum of two values.
static List<ICompiled>	newPosArgsList(int num) Create list of positional arguments.
static <T> T	nvl(T... objects) return first non-null argument.
static boolean	objequal(Object v1, Object v2) Return true if object are equeal as Objects or Numerically.
static Number	parseNumber(String str) Parse string as Number.
static int	parseRegexpFlag(char c) Convert character regexp flag to its integer constant.
static int	parseRegexpFlags(String flagsStr) Parse string of regexp flag characters.
static <T> Set<T>	roset(T... objs) Make Read-only Set of positionals args.
static int	safeLen(String str)
static <T> Set<T>	set(T... objs) Make Set of positionals args.
static Reader	str2reader(String str) Make Reader from string content.
static Class<?>	strToClass(String str) Convert class name to a class object.
static Symbol	symbol(String name) Make Symbol with given name.
static Class<?>	tspecToClass(Object tspec) Convert type specification to Class a object it is representing.
static Object	unAstnize(ASTN param) Strip objects out of an AST node.
static Set<Object>	unionSets(Set<?>... sets) Make union of Sets.

Methods inherited from class java.lang.Object

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

Field Detail

numLocale

protected static final Locale numLocale

nc

public static final NumCompOp nc

MAVEN_PROPS

public static final String MAVEN_PROPS

See Also:

Constant Field Values

Constructor Detail

Utils

public Utils()

Method Detail

safeLen

public static int safeLen(String str)

defListClz

public static Class<?> defListClz()

list

@SafeVarargs
public static <T> List<T> list(T... objs)

Make List of positionals args.

clist

@SafeVarargs
public static <T> List<T> clist(T... objs)

Make unmodifiableList list of positionals args.

map

public static <T,U> Map<T,U> map(Object... objs)

Make Map of (key value) pairs of positionals args.

set

@SafeVarargs
public static <T> Set<T> set(T... objs)

Make Set of positionals args.

roset

@SafeVarargs
public static <T> Set<T> roset(T... objs)

Make Read-only Set of positionals args.

symbol

public static Symbol symbol(String name)

Make Symbol with given name.

str2reader

public static Reader str2reader(String str)

Make Reader from string content.

max

public static int max(int intA,
                      int intB)

Return maximum of two values.

arrayAsString

public static String arrayAsString(Object val)

Convert an array to String for printout.

arrayContentsAsString

public static String arrayContentsAsString(Object val)

Convert an array to String for printout.

asString

public static String asString(Object val)

Convert an object to its String representation.

Symbols will be printed as their names, Arrays - using arrayAsString, null as NIL, other objects using their toString() method.

asCharSequenceOrNull

public static CharSequence asCharSequenceOrNull(Object val)

Convert an object to its String representation, return CharSequences as is or return null if value is null.

asStringOrNull

public static String asStringOrNull(Object val)

Convert an object to its String representation or return null if value is null.

asStringOrEmpty

public static String asStringOrEmpty(Object val)

Convert an object to its String representation or return empty String if value is null.

tspecToClass

public static Class<?> tspecToClass(Object tspec)
                             throws ClassNotFoundException

Convert type specification to Class a object it is representing. Argument may be a Class instance, in this case it will be returned as it is.

Throws:

ClassNotFoundException

newPosArgsList

public static List<ICompiled> newPosArgsList(int num)

Create list of positional arguments.

copySeq

public static Object copySeq(Object seq)

Shallow copy sequence.

Creates new instance of sequence of the same type with the same content. Only Lists and Arrays are currently supported.

strToClass

public static Class<?> strToClass(String str)
                           throws ClassNotFoundException

Convert class name to a class object.

java.lang classes do not require full path.

Throws:

ClassNotFoundException

getMethodParamsClasses

public static Class<?>[] getMethodParamsClasses(List<?> methodParams,
                                                List<?> typeSpecs)
                                         throws ClassNotFoundException

Get array of classes of method parameters given optional array of argument type specifications.

Throws:

ClassNotFoundException

unAstnize

public static Object unAstnize(ASTN param)

Strip objects out of an AST node.

astnize

public static ASTN astnize(Object param,
                           ParseCtx ctx)

Make AST node of objects (honoring lists).

listCtxVars

public static String listCtxVars(Compiler.ICtx ctx,
                                 Object vars,
                                 IObjectWriter w)

Print contents details with selected context bindings if vars is a collection of variable names. If it is not a sequence print all vars if vars has implicit boolean value of true, no variables if false;

listParseErrors

public static String listParseErrors(ASTN exprASTN)

Print list of all parse errors for an AST subtree.

asObject

public static Object asObject(Object val)

Return argument as object. FIXME: do we need this? why it was added?

asChar

public static char asChar(Object val)

Return object as char.

Character object returned as is, Boolean as 'T' or '\0', Byte as corresponding ASCII character, otherwise ASCII character of numeric value

parseNumber

public static Number parseNumber(String str)

Parse string as Number. FIXME: exc. handling is ugly

asNumber

public static Number asNumber(Object val)

Coerse object to Number.

FIXME: describe conversion FIXME: make configurable

isFP

public static boolean isFP(Number num)

Check if the argument is a floating point number.

isLast

protected static boolean isLast(List<?> list,
                                int idx)

Check if index is the last of the list.

asBoolean

public static Boolean asBoolean(Object val)

Coerce object to boolean.

assertTrue

public static void assertTrue(boolean val)

Assert true value.

array

public static int[] array(int... args)

Make array of int.

array

public static char[] array(char... args)

Make array of char.

array

public static double[] array(double... args)

Make array of double.

array

public static float[] array(float... args)

Make array of float.

array

public static boolean[] array(boolean... args)

Make array of boolean.

array

public static byte[] array(byte... args)

Make array of byte.

array

public static short[] array(short... args)

Make array of short.

array

public static long[] array(long... args)

Make array of long.

arrayOfObjects

public static Object[] arrayOfObjects(Object... args)

Make array of Objects.

aset

public static void aset(Object arrayObj,
                        int index,
                        Object obj)

Set array element.

arraysDeepEquals

public static boolean arraysDeepEquals(Object arrayE,
                                       Object arrayV)

Array deep comparison.

isEmpty

public static boolean isEmpty(String str)

Check if String is empty.

coalesce

public static String coalesce(String... strings)

Return first not null not-empty argument.

nvl

@SafeVarargs
public static <T> T nvl(T... objects)

return first non-null argument.

concat

public static String concat(String... strs)

Concatenate string arguments.

intersectSets

public static Set<Object> intersectSets(Set<?>... sets)

Compute intersection of sets.

unionSets

public static Set<Object> unionSets(Set<?>... sets)

Make union of Sets.

isRoundNumber

public static boolean isRoundNumber(Number val)

Check if Number is equal.

equal

public static boolean equal(Object objA,
                            Object objB)

Check if objects are equal using Object.equals().

enumEqual

public static boolean enumEqual(Enum<?> enumE,
                                Object obj)

Check if equal to enum according to the name of the enum value.

objequal

public static boolean objequal(Object v1,
                               Object v2)

Return true if object are equeal as Objects or Numerically.

copyObjectByCopyConstructor

public static Object copyObjectByCopyConstructor(Object obj)

Tries to copy objects using its copy constructor.

cloneObjectByClone

public static Object cloneObjectByClone(Cloneable obj)

Tries to copy a Cloneable object using its clone() method.

parseRegexpFlag

public static int parseRegexpFlag(char c)

Convert character regexp flag to its integer constant. Returns code or 0 if character flag is invalid.

parseRegexpFlags

public static int parseRegexpFlags(String flagsStr)

Parse string of regexp flag characters. Returns flag value or throws a runtime exception if flag is invalid.

isKnownImmutable

public static boolean isKnownImmutable(Object obj)

Return true if Object is known to be immutable.

Currently using list of types that known to be Immutable.

getExplangCoreVersionStr

public static String getExplangCoreVersionStr()

Return explang core jar version.