org.das2.util

Class StringTransmogrifier

java.lang.Object

org.das2.util.StringTransmogrifier

public class StringTransmogrifier
extends java.lang.Object

Apply an operation to a String to make it a String with similar meaning. This is needed for new code which indicates the orbit number, but the orbit number context is provided elsewhere on the plot. https://calvinandhobbes.fandom.com/wiki/Transmogrifier_Gun?file=CalvinTransmogrifierGunWeb.jpg A regular expression specifies the text to look for in strings, and the result is reformatted using a result template string. The transmogrify method will convert the input string to the template, so for example:

%
 st= StringTransmogrifier('([a-z]+)=([0-9]+)','$1:$2')
 st.transmogrify('cat=1')   # results in 'cat:1'
 

Constructor Summary

Constructors

Constructor and Description
StringTransmogrifier(java.lang.String regex, java.lang.String result) Create a regex-based transmogrifier.

Method Summary

Modifier and Type	Method and Description
java.lang.String	find(java.lang.String string) replace all matches of the regex in string with result.
java.lang.String	transmogrify(java.lang.String string) Transmogrify the string, and if it does not match the regex, then an IllegalArgumentException is thrown.
java.lang.String	transmogrify(java.lang.String string, java.lang.String err) Transmogrify the string, and if it does not match the regex, then return err.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringTransmogrifier

public StringTransmogrifier(java.lang.String regex,
                            java.lang.String result)

Create a regex-based transmogrifier. The result is the template which is populated from groups of the regular expression. The groups can be referenced by index or by name, with

• $<num> by index, where 1 is the first group number
• $<letter> by 1-letter named group
• $<{name}> by named group

Parameters:

regex - the regular expression, like "foo([a-z]+).cdf"

result - the result, like "$1"

Method Detail

transmogrify

public java.lang.String transmogrify(java.lang.String string)

Transmogrify the string, and if it does not match the regex, then an IllegalArgumentException is thrown.

Parameters:

string - the string to transmogrify

Returns:

the formatted result

Throws:

java.lang.IllegalArgumentException - if the regex doesn't match the string

transmogrify

public java.lang.String transmogrify(java.lang.String string,
                                     java.lang.String err)

Transmogrify the string, and if it does not match the regex, then return err.

Parameters:

string - the string to transmogrify

err - alternate string (or null) to return

Returns:

the formatted result or the err string

find

public java.lang.String find(java.lang.String string)

replace all matches of the regex in string with result.

Parameters:

string - the string containing any text to transmogrify

Returns:

the string with each match reformatted within the string