StringUtils

MLModule

genre	Fields
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	MLMiscModules
definition	MLMiscModules.def
see also	StringSplit
keywords	concat, trim, format, search, find, replace, character, concatenate, lower, upper, case, reverse, string, substring, ascii, prefix, postfix, parse

Purpose

The module StringUtils offers a collection of general purpose operations on strings.

All operations work on the module’s fields. No scripting is used inside this module.

Details

Depending on the selected Operation, the GUI shows different input and option fields.

However, the Result always remains in the same place.

Windows

Default Panel

Parameter Fields

Visible Fields

Operation

name: operationType, type: Enum, default: Concatenate

Defines the string operation.

Values:

Title	Name	Description
Concatenate	Concatenate	Up to six input strings may be concatenated. Each one may be toggled on or off through a checkbox (by default, the first two strings are active, while the other four are inactive). At the end of each line, an integer field refers to the length of the input strings. Only active strings will be considered for concatenation. The checkboxes Prefix and Postfix allow for defining an additional pre-/postfix. The radiobutton group Separator allows for defining a separator that will be inserted between each pair of input strings.
Compare	Compare	The first two input strings are compared. The field Case insensitive allows for turning off case-sensitivity (default is case-sensitive).
Make Lower Case	MakeLowerCase	The input string is converted to all lowercase.
Make Upper Case	MakeUpperCase	The input string is converted to all uppercase.
Replace	Replace	Inside the first string, all occurrences of the second string are replaced by the third string.
Reverse	Reverse	The character sequence in the input string is reversed.
Substring	Substring	From the input string, a substring is extracted in the range of From to To. If either of these values exceeds the length of the input-string, the operation will use the largest possible value.
Format Float	FormatFloat	A floating-point input string is formatted to a fixed-point number. The number of decimal digits is defined in the precision field (internally limited to 32 digits). Valid input strings have the following form: [whitespace] [sign] [digits] [.digits] [ { e | E }[sign]digits] For invalid input strings, the result will be zero.
To ASCII	ToASCII	Takes all ASCII character values from the input strings and prints them as unsigned numbers into the result string. All but last numbers are appended with the currently selected separator string. Depending on the UseHex flag, the numbers are printed as hexadecimal or as decimal numbers. If UseHexPrefix is checked, hexadecimal numbers are prefixed additionally with 0x.

Result

name: result, type: String, persistent: no

Shows the resulting string of any operation.

Length Result

name: lengthResult, type: Integer, persistent: no

Shows the length of the resulting string.

Equal?

name: boolResult, type: Bool, persistent: no

Shows whether the strings in a comparison are equal.