Name

adams.flow.transformer.StringArraySplit

Synopsis

Uses a regular expression to identify the string that triggers one or more splits in a string array, resulting in smaller arrays being output.
What is done with the string triggering the split, is defined in the split handling option, e.g., discard it.
Useful actor for splitting a log file into individual entry chunks.

Additional information

Flow input/output:
- input: java.lang.String[]
- output: java.lang.String[]

Options

• loggingLevel
  

  The logging level for outputting errors and debugging output.

  command-line	-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST>
  default	WARNING
  min-user-mode	Expert

  
  
• name
  

  The name of the actor.

  command-line	-name <java.lang.String>
  default	StringArraySplit

  
  
• annotations
  

  The annotations to attach to this actor.

  command-line	-annotation <adams.core.base.BaseAnnotation>
  default

  
  
• skip
  

  If set to true, transformation is skipped and the input token is just forwarded as it is.

  command-line	-skip <boolean>
  default	false

  
  
• stopFlowOnError
  

  If set to true, the flow execution at this level gets stopped in case this actor encounters an error; the error gets propagated; useful for critical actors.

  command-line	-stop-flow-on-error <boolean>
  default	false
  min-user-mode	Expert

  
  
• silent
  

  If enabled, then no errors are output in the console; Note: the enclosing actor handler must have this enabled as well.

  command-line	-silent <boolean>
  default	false
  min-user-mode	Expert

  
  
• outputArray
  

  If enabled, the generate sub-arrays are output as an array rather than one-by-one.

  command-line	-output-array <boolean>
  default	false

  
  
• regExp
  

  The regular expression used for matching the strings.

  command-line	-regexp <adams.core.base.BaseRegExp>
  default	.*
  more	https://docs.oracle.com/javase/tutorial/essential/regex/
  	https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html

  
  
• splitHandling
  

  Determines how the string is handled that triggered a split; DISCARD: string gets discarded; AT_START: is added at the start of the new output array; AT_END: is added at the end of the previous output array

  command-line	-split-handling <DISCARD|AT_START|AT_END>
  default	DISCARD

  
  
• remainderHandling
  

  Determines how the handle any left over strings after the last split.

  command-line	-remainder-handling <DISCARD|OUTPUT>
  default	OUTPUT