the input stream or null
a string used to identify the source if an exception arises
specifies the delimiter between keys and their values (default is '='). Whitespace surrounding the delimiter is ignored.
specifies the delimiter that marks the start of comments, except within quoted strings (default is "#").
Constructs a parser around an input stream, which may be null. If null, the parser constructs an empty map, otherwise a map is constructed containing the key/value pairs from the input stream's data.
The constructor loads a text file containing configuration strings and splits the strings into key/value pairs. The text files must be UTF, and may use any of the UTF byte-order marks to differentiate their contents. See UTF BOM.
The input stream will always get closed by the Parser constructor (provided it isn't null).
Typically, this class is only used indirectly; the
Parser
object provides convenience methods for dealing with various sources.Note that this implementation is simply a wrapper for the Java
ParserJ.
As such, its use is deprecated. It is possible that the class (but not the object) will be deleted in a future version.