univocity-parsers 2.9.1 · com.univocity.parsers.common.input.WriterCharAppender

Modifier and Type	Field and Description
private boolean	denormalizeLineEndings
private final char	lineSeparator1
private final char	lineSeparator2
private final char	newLine

Access	Constructor and Description
public	WriterCharAppender(int maximum limit of characters to append maxLength, String default value to return when no characters have been accumulated emptyValue, int starting range of characters considered to be whitespace. whitespaceRangeStart, Format output format specification used for newline handling format) Creates a WriterCharAppender with: a maximum limit of characters to append the default value to return when no characters have been accumulated. the basic `Format` specification for handling newlines

Method Summary

Modifier and Type	Method and Description
public final void	append(char the character to append ch) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.append. Implements com.univocity.parsers.common.input.CharAppender.append. Appends the given character.
public final void	appendIgnoringPadding(char character to append ch, char the padding character padding) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringPadding. Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringPadding. Appends the given character and marks it as ignored if it is a padding character If the given character is equal to `Format#getNormalizedNewline()`, then the character sequence returned by `Format#getLineSeparator()` is going to be appended.
public final void	appendIgnoringWhitespace(char character to append ch) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringWhitespace. Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringWhitespace. Appends the given character and marks it as ignored if it is a whitespace (`ch <= ' '`) If the given character is equal to `Format#getNormalizedNewline()`, then the character sequence returned by `Format#getLineSeparator()` is going to be appended.
public final void	appendIgnoringWhitespaceAndPadding(char character to append ch, char the padding character padding) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringWhitespaceAndPadding. Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringWhitespaceAndPadding. Appends the given character and marks it as ignored if it is a whitespace (`ch <= ' '`) or a padding character If the given character is equal to `Format#getNormalizedNewline()`, then the character sequence returned by `Format#getLineSeparator()` is going to be appended.
public final void	appendNewLine() Appends the newline character sequence specified in `Format#getLineSeparator()`
public final void	enableDenormalizedLineEndings(boolean flag indicating whether denormalized line endings are allowed. The writer won't convert line separators automatically. enableDenormalizedLineEndings) Configures the appender to allow line ending sequences to be appended as-is, without replacing them by the normalized line separator character.
public final void	writeCharsAndReset(Writer the output writer writer) Writes the accumulated value to the `java.io.Writer`, discarding any trailing whitespace characters identified when using `WriterCharAppender#appendIgnoringWhitespace(char)`, `WriterCharAppender#appendIgnoringPadding(char, char)` or `WriterCharAppender#appendIgnoringWhitespaceAndPadding(char, char)` The internal accumulated value is discarded after invoking this method (as in `DefaultCharAppender#reset()`) If the accumulated value is empty (i.e. no characters were appended, or all appended characters where ignored as whitespace or padding), then the written value will be the `DefaultCharAppender#emptyValue` attribute defined in the constructor of this class.

Inherited from com.univocity.parsers.common.input.ExpandingCharAppender:: append append append appendUntil appendUntil appendUntil expand expand expandAndRetry fill prepend prepend prepend

denormalizeLineEndings	back to summary
private boolean denormalizeLineEndings

lineSeparator1	back to summary
private final char lineSeparator1

lineSeparator2	back to summary
private final char lineSeparator2

newLine	back to summary
private final char newLine

WriterCharAppender	back to summary
public WriterCharAppender(int maxLength, String emptyValue, int whitespaceRangeStart, Format format) Creates a WriterCharAppender with: a maximum limit of characters to append the default value to return when no characters have been accumulated. the basic `Format` specification for handling newlines The padding character is defaulted to a whitespace character ' '. Parameters maxLength:int maximum limit of characters to append emptyValue:String default value to return when no characters have been accumulated whitespaceRangeStart:int starting range of characters considered to be whitespace. format:Format output format specification used for newline handling

Method Detail

append back to summary

append	back to summary
public final void append(char ch) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.append. Implements com.univocity.parsers.common.input.CharAppender.append. Appends the given character. If the given character is equal to `Format#getNormalizedNewline()`, then the character sequence returned by `Format#getLineSeparator()` is going to be appended. Parameters ch:char the character to append Annotations @Override

public final void append(char ch)

Overrides com.univocity.parsers.common.input.ExpandingCharAppender.append.

Implements com.univocity.parsers.common.input.CharAppender.append.

Appends the given character.

If the given character is equal to Format#getNormalizedNewline(), then the character sequence returned by Format#getLineSeparator() is going to be appended.

Parameters

ch:char: the character to append

Annotations

@Override

appendIgnoringPadding back to summary

appendIgnoringPadding	back to summary
public final void appendIgnoringPadding(char ch, char padding) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringPadding. Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringPadding. Appends the given character and marks it as ignored if it is a padding character If the given character is equal to `Format#getNormalizedNewline()`, then the character sequence returned by `Format#getLineSeparator()` is going to be appended. Parameters ch:char character to append padding:char the padding character Annotations @Override

public final void appendIgnoringPadding(char ch, char padding)

Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringPadding.

Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringPadding.

Appends the given character and marks it as ignored if it is a padding character

If the given character is equal to Format#getNormalizedNewline(), then the character sequence returned by Format#getLineSeparator() is going to be appended.

Parameters

ch:char: character to append
padding:char: the padding character

Annotations

@Override

appendIgnoringWhitespace back to summary

appendIgnoringWhitespace	back to summary
public final void appendIgnoringWhitespace(char ch) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringWhitespace. Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringWhitespace. Appends the given character and marks it as ignored if it is a whitespace (`ch <= ' '`) If the given character is equal to `Format#getNormalizedNewline()`, then the character sequence returned by `Format#getLineSeparator()` is going to be appended. Parameters ch:char character to append Annotations @Override

public final void appendIgnoringWhitespace(char ch)

Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringWhitespace.

Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringWhitespace.

Appends the given character and marks it as ignored if it is a whitespace (ch <= ' ')

If the given character is equal to Format#getNormalizedNewline(), then the character sequence returned by Format#getLineSeparator() is going to be appended.

Parameters

ch:char: character to append

Annotations

@Override

appendIgnoringWhitespaceAndPadding back to summary

appendIgnoringWhitespaceAndPadding	back to summary
public final void appendIgnoringWhitespaceAndPadding(char ch, char padding) Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringWhitespaceAndPadding. Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringWhitespaceAndPadding. Appends the given character and marks it as ignored if it is a whitespace (`ch <= ' '`) or a padding character If the given character is equal to `Format#getNormalizedNewline()`, then the character sequence returned by `Format#getLineSeparator()` is going to be appended. Parameters ch:char character to append padding:char the padding character Annotations @Override

public final void appendIgnoringWhitespaceAndPadding(char ch, char padding)

Overrides com.univocity.parsers.common.input.ExpandingCharAppender.appendIgnoringWhitespaceAndPadding.

Implements com.univocity.parsers.common.input.CharAppender.appendIgnoringWhitespaceAndPadding.

Appends the given character and marks it as ignored if it is a whitespace (ch <= ' ') or a padding character

If the given character is equal to Format#getNormalizedNewline(), then the character sequence returned by Format#getLineSeparator() is going to be appended.

Parameters

ch:char: character to append
padding:char: the padding character

Annotations

@Override

appendNewLine	back to summary
public final void appendNewLine() Appends the newline character sequence specified in `Format#getLineSeparator()`

enableDenormalizedLineEndings	back to summary
public final void enableDenormalizedLineEndings(boolean enableDenormalizedLineEndings) Configures the appender to allow line ending sequences to be appended as-is, without replacing them by the normalized line separator character. Parameters enableDenormalizedLineEndings:boolean flag indicating whether denormalized line endings are allowed. The writer won't convert line separators automatically.

enableDenormalizedLineEndings

back to summary

public final void enableDenormalizedLineEndings(boolean enableDenormalizedLineEndings)

Configures the appender to allow line ending sequences to be appended as-is, without replacing them by the normalized line separator character.

Parameters

enableDenormalizedLineEndings:boolean: flag indicating whether denormalized line endings are allowed. The writer won't convert line separators automatically.

writeCharsAndReset back to summary

writeCharsAndReset	back to summary
public final void writeCharsAndReset(Writer writer) throws IOException Writes the accumulated value to the `java.io.Writer`, discarding any trailing whitespace characters identified when using `WriterCharAppender#appendIgnoringWhitespace(char)`, `WriterCharAppender#appendIgnoringPadding(char, char)` or `WriterCharAppender#appendIgnoringWhitespaceAndPadding(char, char)` The internal accumulated value is discarded after invoking this method (as in `DefaultCharAppender#reset()`) If the accumulated value is empty (i.e. no characters were appended, or all appended characters where ignored as whitespace or padding), then the written value will be the `DefaultCharAppender#emptyValue` attribute defined in the constructor of this class. Parameters writer:Writer the output writer Exceptions IOException: if an error occurs while writing to the output.

public final void writeCharsAndReset(Writer writer) throws IOException

Writes the accumulated value to the java.io.Writer, discarding any trailing whitespace characters identified when using WriterCharAppender#appendIgnoringWhitespace(char), WriterCharAppender#appendIgnoringPadding(char, char) or WriterCharAppender#appendIgnoringWhitespaceAndPadding(char, char)

The internal accumulated value is discarded after invoking this method (as in DefaultCharAppender#reset())

If the accumulated value is empty (i.e. no characters were appended, or all appended characters where ignored as whitespace or padding), then the written value will be the DefaultCharAppender#emptyValue attribute defined in the constructor of this class.

Parameters

writer:Writer: the output writer

Exceptions

IOException:: if an error occurs while writing to the output.

public Class WriterCharAppender

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail