CharAppender (univocity-parsers 2.7.3 API)

All Superinterfaces:: CharSequence

All Known Implementing Classes:: DefaultCharAppender, ExpandingCharAppender, NoopCharAppender, WriterCharAppender

public interface CharAppender
extends CharSequence

The general interface for classes responsible for appending characters efficiently while handling whitespaces and padding characters.

Calls to appendIgnoringWhitespace(char), appendIgnoringPadding(char, char) and appendIgnoringWhitespaceAndPadding(char, char) should accumulate the given character and only discard whitespaces/padding if no non-whitespace is appended:

For example:

 append('a');                   // accumulated value is now "a";        whitespaceCount = 0;
 appendIgnoringWhitespace('b'); // accumulated value is now "ab";       whitespaceCount = 0;
 appendIgnoringWhitespace(' '); // accumulated value remains "ab";      whitespaceCount = 1;
 appendIgnoringWhitespace(' '); // accumulated value remains "ab";      whitespaceCount = 2;
 appendIgnoringWhitespace('c'); // accumulated value is now "ab  c";    whitespaceCount = 0;
 appendIgnoringWhitespace(' '); // accumulated value remains "ab  c";   whitespaceCount = 1;
 appendIgnoringWhitespace('d'); // accumulated value is now "ab  c d";  whitespaceCount = 0;
 append(' ');                                     // accumulated value is now "ab  c d "; whitespaceCount = 0;

Implementation note: White spaces should be identified as any character <= ' '

Author:: Univocity Software Pty Ltd - parsers@univocity.com

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`append(char ch)` Appends the given character.
`void`	`append(char[] ch)` Appends characters from an input array
`void`	`append(char[] ch, int from, int length)` Appends characters from an input array
`void`	`append(int ch)` Appends the given codepoint.
`void`	`append(int[] ch)` Appends codepoints from an input array
`void`	`append(String string)` Appends characters from an input `String`
`void`	`append(String string, int from, int to)` Appends the contents of a String to this appender
`void`	`appendIgnoringPadding(char ch, char padding)` Appends the given character and marks it as ignored if it is a padding character (the definition of a padding character is implementation dependent.)
`void`	`appendIgnoringWhitespace(char ch)` Appends the given character and marks it as ignored if it is a whitespace (`ch <= ' '`)
`void`	`appendIgnoringWhitespaceAndPadding(char ch, char padding)` Appends the given character and marks it as ignored if it is a whitespace (`ch <= ' '`) or a padding character (the definition of a padding character is implementation dependent.)
`char`	`appendUntil(char ch, CharInput input, char stop)` Appends characters from the input, until a stop character is found
`char`	`appendUntil(char ch, CharInput input, char stop1, char stop2)` Appends characters from the input, until a stop character is found
`char`	`appendUntil(char ch, CharInput input, char stop1, char stop2, char stop3)` Appends characters from the input, until a stop character is found
`void`	`fill(char ch, int length)` Adds a sequence of repeated characters to the input.
`String`	`getAndReset()` Returns the accumulated value as a String, discarding any trailing whitespace characters identified when using `appendIgnoringWhitespace(char)`, `appendIgnoringPadding(char, char)` or `appendIgnoringWhitespaceAndPadding(char, char)`
`char[]`	`getChars()` Returns the internal character array.
`char[]`	`getCharsAndReset()` Returns the accumulated characters, discarding any trailing whitespace characters identified when using `appendIgnoringWhitespace(char)`, `appendIgnoringPadding(char, char)` or `appendIgnoringWhitespaceAndPadding(char, char)`
`int`	`length()` Returns the current accumulated value length (the sum of all appended characters - whitespaceCount).
`void`	`prepend(char ch)` Prepends the current accumulated value with a character
`void`	`prepend(char[] chars)` Prepends the current accumulated value a sequence of characters
`void`	`prepend(char ch1, char ch2)` Prepends the current accumulated value with a couple of characters
`void`	`reset()` Clears the accumulated value and the whitespace count.
`void`	`resetWhitespaceCount()` Resets the number of whitespaces accumulated after the last non-whitespace character.
`void`	`updateWhitespace()` Updates the internal whitespace count of this appender to trim trailing whitespaces.
`int`	`whitespaceCount()` Returns the current number of whitespaces accumulated after the last non-whitespace character.

Methods inherited from interface java.lang.CharSequence
charAt, chars, codePoints, subSequence, toString

- Method Detail
  - appendIgnoringWhitespace
```
void appendIgnoringWhitespace(char ch)
```
    Appends the given character and marks it as ignored if it is a whitespace (ch <= ' ')
    
    Parameters:
    
    ch - character to append
  - appendIgnoringPadding
```
void appendIgnoringPadding(char ch,
                           char padding)
```
    Appends the given character and marks it as ignored if it is a padding character (the definition of a padding character is implementation dependent.)
    
    Parameters:
    
    ch - character to append
    
    padding - the padding character to ignore
  - appendIgnoringWhitespaceAndPadding
```
void appendIgnoringWhitespaceAndPadding(char ch,
                                        char padding)
```
    Appends the given character and marks it as ignored if it is a whitespace (ch <= ' ') or a padding character (the definition of a padding character is implementation dependent.)
    
    Parameters:
    
    ch - character to append
    
    padding - the padding character to ignore
  - append
```
void append(char ch)
```
    Appends the given character.
    
    Parameters:
    
    ch - the character to append
  - append
```
void append(int ch)
```
    Appends the given codepoint.
    
    Parameters:
    
    ch - the codepoint to append
  - length
```
int length()
```
    Returns the current accumulated value length (the sum of all appended characters - whitespaceCount).
    
    Specified by:
    
    length in interface CharSequence
    
    Returns:
    
    the current accumulated value length (the sum of all appended characters - whitespaceCount).
  - whitespaceCount
```
int whitespaceCount()
```
    Returns the current number of whitespaces accumulated after the last non-whitespace character.
    This is the number of whitespaces accumulated using appendIgnoringWhitespace(char), appendIgnoringPadding(char, char) or appendIgnoringWhitespaceAndPadding(char, char)
    
    Returns:
    
    the number of whitespaces accumulated using appendIgnoringWhitespace(char), appendIgnoringPadding(char, char) or appendIgnoringWhitespaceAndPadding(char, char)
  - resetWhitespaceCount
```
void resetWhitespaceCount()
```
    Resets the number of whitespaces accumulated after the last non-whitespace character.
    This is the number of whitespaces accumulated using appendIgnoringWhitespace(char), appendIgnoringPadding(char, char) or appendIgnoringWhitespaceAndPadding(char, char)
    A subsequent call to whitespaceCount() should return 0.
  - getAndReset
```
String getAndReset()
```
    Returns the accumulated value as a String, discarding any trailing whitespace characters identified when using appendIgnoringWhitespace(char), appendIgnoringPadding(char, char) or appendIgnoringWhitespaceAndPadding(char, char)
    The internal accumulated value is discarded after invoking this method (as in reset())
    
    Returns:
    
    a String containing the accumulated characters without the trailing whitespaces.
  - reset
```
void reset()
```
    Clears the accumulated value and the whitespace count.
  - getCharsAndReset
```
char[] getCharsAndReset()
```
    Returns the accumulated characters, discarding any trailing whitespace characters identified when using appendIgnoringWhitespace(char), appendIgnoringPadding(char, char) or appendIgnoringWhitespaceAndPadding(char, char)
    The internal accumulated value is discarded after invoking this method (as in reset())
    
    Returns:
    
    a character array containing the accumulated characters without the trailing whitespaces.
  - getChars
```
char[] getChars()
```
    Returns the internal character array.
    
    Returns:
    
    the internal character array.
  - fill
```
void fill(char ch,
          int length)
```
    Adds a sequence of repeated characters to the input.
    
    Parameters:
    
    ch - the character to append
    
    length - the number of times the given character should be appended.
  - prepend
```
void prepend(char ch)
```
    Prepends the current accumulated value with a character
    
    Parameters:
    
    ch - the character to prepend in front of the current accumulated value.
  - prepend
```
void prepend(char ch1,
             char ch2)
```
    Prepends the current accumulated value with a couple of characters
    
    Parameters:
    
    ch1 - the first character to prepend in front of the current accumulated value.
    
    ch2 - the second character to prepend in front of the current accumulated value.
  - prepend
```
void prepend(char[] chars)
```
    Prepends the current accumulated value a sequence of characters
    
    Parameters:
    
    chars - the character sequence to prepend in front of the current accumulated value.
  - updateWhitespace
```
void updateWhitespace()
```
    Updates the internal whitespace count of this appender to trim trailing whitespaces.
  - appendUntil
```
char appendUntil(char ch,
                 CharInput input,
                 char stop)
```
    Appends characters from the input, until a stop character is found
    
    Parameters:
    
    ch - the first character of the input to be appended.
    
    input - the input whose the following characters will be appended
    
    stop - the stop character
    
    Returns:
    
    the stop character found on the input.
  - appendUntil
```
char appendUntil(char ch,
                 CharInput input,
                 char stop1,
                 char stop2)
```
    Appends characters from the input, until a stop character is found
    
    Parameters:
    
    ch - the first character of the input to be appended.
    
    input - the input whose the following characters will be appended
    
    stop1 - the first stop character
    
    stop2 - the second stop character
    
    Returns:
    
    one of the stop characters found on the input.
  - appendUntil
```
char appendUntil(char ch,
                 CharInput input,
                 char stop1,
                 char stop2,
                 char stop3)
```
    Appends characters from the input, until a stop character is found
    
    Parameters:
    
    ch - the first character of the input to be appended.
    
    input - the input whose the following characters will be appended
    
    stop1 - the first stop character
    
    stop2 - the second stop character
    
    stop3 - the third stop character
    
    Returns:
    
    one of the stop characters found on the input.
  - append
```
void append(char[] ch,
            int from,
            int length)
```
    Appends characters from an input array
    
    Parameters:
    
    ch - the character array
    
    from - the position of the first character in the array to be appended
    
    length - the number of characters to be appended from the given posiion.
  - append
```
void append(char[] ch)
```
    Appends characters from an input array
    
    Parameters:
    
    ch - the character array
  - append
```
void append(int[] ch)
```
    Appends codepoints from an input array
    
    Parameters:
    
    ch - the codepoint array
  - append
```
void append(String string)
```
    Appends characters from an input String
    
    Parameters:
    
    string - the input String
  - append
```
void append(String string,
            int from,
            int to)
```
    Appends the contents of a String to this appender
    
    Parameters:
    
    string - the string whose characters will be appended.
    
    from - the index of the first character to append
    
    to - the index of the last character to append

Interface CharAppender

Method Summary

Methods inherited from interface java.lang.CharSequence

Method Detail

appendIgnoringWhitespace

appendIgnoringPadding

appendIgnoringWhitespaceAndPadding

append

append

length

whitespaceCount

resetWhitespaceCount

getAndReset

reset

getCharsAndReset

getChars

fill

prepend

prepend

prepend

updateWhitespace

appendUntil

appendUntil

appendUntil

append

append

append

append

append