ASCIIPropertyListParser (dd-plist 1.25 API)

java.lang.Object
- com.dd.plist.ASCIIPropertyListParser

```
public final class ASCIIPropertyListParser
extends Object
```
Parser for ASCII property lists. Supports Apple OS X/iOS and GnuStep/NeXTSTEP format. This parser is based on the recursive descent paradigm, but the underlying grammar is not explicitly defined.

Resources on ASCII property list format:
- Property List Programming Guide - Old-Style ASCII Property Lists
- GnuStep - NSPropertyListSerialization class documentation
Author:

Daniel Dreibrodt

Field Summary

Fields
Modifier and Type	Field and Description
`static char`	`ARRAY_BEGIN_TOKEN`
`static char`	`ARRAY_END_TOKEN`
`static char`	`ARRAY_ITEM_DELIMITER_TOKEN`
`static char`	`COMMENT_BEGIN_TOKEN`
`static char`	`DATA_BEGIN_TOKEN`
`static char`	`DATA_END_TOKEN`
`static char`	`DATA_GSBOOL_BEGIN_TOKEN`
`static char`	`DATA_GSBOOL_FALSE_TOKEN`
`static char`	`DATA_GSBOOL_TRUE_TOKEN`
`static char`	`DATA_GSDATE_BEGIN_TOKEN`
`static char`	`DATA_GSINT_BEGIN_TOKEN`
`static char`	`DATA_GSOBJECT_BEGIN_TOKEN`
`static char`	`DATA_GSREAL_BEGIN_TOKEN`
`static char`	`DATE_APPLE_DATE_TIME_DELIMITER`
`static char`	`DATE_APPLE_END_TOKEN`
`static char`	`DATE_DATE_FIELD_DELIMITER`
`static char`	`DATE_GS_DATE_TIME_DELIMITER`
`static char`	`DATE_TIME_FIELD_DELIMITER`
`static char`	`DICTIONARY_ASSIGN_TOKEN`
`static char`	`DICTIONARY_BEGIN_TOKEN`
`static char`	`DICTIONARY_END_TOKEN`
`static char`	`DICTIONARY_ITEM_DELIMITER_TOKEN`
`static char`	`MULTILINE_COMMENT_END_TOKEN`
`static char`	`MULTILINE_COMMENT_SECOND_TOKEN`
`static char`	`QUOTEDSTRING_BEGIN_TOKEN`
`static char`	`QUOTEDSTRING_END_TOKEN`
`static char`	`QUOTEDSTRING_ESCAPE_TOKEN`
`static char`	`SINGLELINE_COMMENT_SECOND_TOKEN`
`static char`	`WHITESPACE_CARRIAGE_RETURN`
`static char`	`WHITESPACE_NEWLINE`
`static char`	`WHITESPACE_SPACE`
`static char`	`WHITESPACE_TAB`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`NSObject`	`parse()` Parses the property list from the beginning and returns the root object of the property list.
`static NSObject`	`parse(byte[] bytes)` Parses an ASCII property list from a byte array.
`static NSObject`	`parse(byte[] bytes, String encoding)` Parses an ASCII property list from a byte array.
`static NSObject`	`parse(File f)` Parses an ASCII property list file.
`static NSObject`	`parse(File f, String encoding)` Parses an ASCII property list file.
`static NSObject`	`parse(InputStream in)` Parses an ASCII property list from an input stream.
`static NSObject`	`parse(InputStream in, String encoding)` Parses an ASCII property list from an input stream.
`static NSObject`	`parse(Path path)` Parses an ASCII property list file.
`static NSObject`	`parse(Path path, String encoding)` Parses an ASCII property list file.
`static NSObject`	`parse(Reader reader)` Parses an ASCII property list from a `Reader`.
`static NSObject`	`parse(String plistData)` Parses an ASCII property list from a `String`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - WHITESPACE_SPACE
```
public static final char WHITESPACE_SPACE
```
    See Also:
    
    Constant Field Values
  - WHITESPACE_TAB
```
public static final char WHITESPACE_TAB
```
    See Also:
    
    Constant Field Values
  - WHITESPACE_NEWLINE
```
public static final char WHITESPACE_NEWLINE
```
    See Also:
    
    Constant Field Values
  - WHITESPACE_CARRIAGE_RETURN
```
public static final char WHITESPACE_CARRIAGE_RETURN
```
    See Also:
    
    Constant Field Values
  - ARRAY_BEGIN_TOKEN
```
public static final char ARRAY_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - ARRAY_END_TOKEN
```
public static final char ARRAY_END_TOKEN
```
    See Also:
    
    Constant Field Values
  - ARRAY_ITEM_DELIMITER_TOKEN
```
public static final char ARRAY_ITEM_DELIMITER_TOKEN
```
    See Also:
    
    Constant Field Values
  - DICTIONARY_BEGIN_TOKEN
```
public static final char DICTIONARY_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DICTIONARY_END_TOKEN
```
public static final char DICTIONARY_END_TOKEN
```
    See Also:
    
    Constant Field Values
  - DICTIONARY_ASSIGN_TOKEN
```
public static final char DICTIONARY_ASSIGN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DICTIONARY_ITEM_DELIMITER_TOKEN
```
public static final char DICTIONARY_ITEM_DELIMITER_TOKEN
```
    See Also:
    
    Constant Field Values
  - QUOTEDSTRING_BEGIN_TOKEN
```
public static final char QUOTEDSTRING_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - QUOTEDSTRING_END_TOKEN
```
public static final char QUOTEDSTRING_END_TOKEN
```
    See Also:
    
    Constant Field Values
  - QUOTEDSTRING_ESCAPE_TOKEN
```
public static final char QUOTEDSTRING_ESCAPE_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_BEGIN_TOKEN
```
public static final char DATA_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_END_TOKEN
```
public static final char DATA_END_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_GSOBJECT_BEGIN_TOKEN
```
public static final char DATA_GSOBJECT_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_GSDATE_BEGIN_TOKEN
```
public static final char DATA_GSDATE_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_GSBOOL_BEGIN_TOKEN
```
public static final char DATA_GSBOOL_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_GSBOOL_TRUE_TOKEN
```
public static final char DATA_GSBOOL_TRUE_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_GSBOOL_FALSE_TOKEN
```
public static final char DATA_GSBOOL_FALSE_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_GSINT_BEGIN_TOKEN
```
public static final char DATA_GSINT_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATA_GSREAL_BEGIN_TOKEN
```
public static final char DATA_GSREAL_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - DATE_DATE_FIELD_DELIMITER
```
public static final char DATE_DATE_FIELD_DELIMITER
```
    See Also:
    
    Constant Field Values
  - DATE_TIME_FIELD_DELIMITER
```
public static final char DATE_TIME_FIELD_DELIMITER
```
    See Also:
    
    Constant Field Values
  - DATE_GS_DATE_TIME_DELIMITER
```
public static final char DATE_GS_DATE_TIME_DELIMITER
```
    See Also:
    
    Constant Field Values
  - DATE_APPLE_DATE_TIME_DELIMITER
```
public static final char DATE_APPLE_DATE_TIME_DELIMITER
```
    See Also:
    
    Constant Field Values
  - DATE_APPLE_END_TOKEN
```
public static final char DATE_APPLE_END_TOKEN
```
    See Also:
    
    Constant Field Values
  - COMMENT_BEGIN_TOKEN
```
public static final char COMMENT_BEGIN_TOKEN
```
    See Also:
    
    Constant Field Values
  - MULTILINE_COMMENT_SECOND_TOKEN
```
public static final char MULTILINE_COMMENT_SECOND_TOKEN
```
    See Also:
    
    Constant Field Values
  - SINGLELINE_COMMENT_SECOND_TOKEN
```
public static final char SINGLELINE_COMMENT_SECOND_TOKEN
```
    See Also:
    
    Constant Field Values
  - MULTILINE_COMMENT_END_TOKEN
```
public static final char MULTILINE_COMMENT_END_TOKEN
```
    See Also:
    
    Constant Field Values
- Method Detail
  - parse
```
public static NSObject parse(File f)
                      throws IOException,
                             ParseException
```
    Parses an ASCII property list file.
    
    Parameters:
    
    f - The ASCII property list file.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    IOException - If an error occurs while reading from the input stream.
  - parse
```
public static NSObject parse(File f,
                             String encoding)
                      throws IOException,
                             ParseException
```
    Parses an ASCII property list file.
    
    Parameters:
    
    f - The ASCII property list file.
    
    encoding - The name of a supported charset to decode the property list.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    IOException - If an error occurs while reading from the input stream.
    
    UnsupportedEncodingException - If no support for the named charset is available in this instance of the Java virtual machine.
  - parse
```
public static NSObject parse(Path path,
                             String encoding)
                      throws IOException,
                             ParseException
```
    Parses an ASCII property list file.
    
    Parameters:
    
    path - The path to the ASCII property list file.
    
    encoding - The name of a supported charset to decode the property list.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    IOException - If an error occurs while reading from the input stream.
    
    UnsupportedEncodingException - If no support for the named charset is available in this instance of the Java virtual machine.
  - parse
```
public static NSObject parse(Path path)
                      throws IOException,
                             ParseException
```
    Parses an ASCII property list file.
    
    Parameters:
    
    path - The path to the ASCII property list file.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    IOException - If an error occurs while reading from the input stream.
  - parse
```
public static NSObject parse(InputStream in)
                      throws ParseException,
                             IOException
```
    Parses an ASCII property list from an input stream. This method does not close the specified input stream.
    
    Parameters:
    
    in - The input stream that provides the property list's data.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    IOException - If an error occurs while reading from the input stream.
  - parse
```
public static NSObject parse(InputStream in,
                             String encoding)
                      throws ParseException,
                             IOException
```
    Parses an ASCII property list from an input stream. This method does not close the specified input stream.
    
    Parameters:
    
    in - The input stream that points to the property list's data.
    
    encoding - The name of a supported charset to decode the property list.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    IOException - If an error occurs while reading from the input stream.
    
    UnsupportedEncodingException - If no support for the named charset is available in this instance of the Java virtual machine.
  - parse
```
public static NSObject parse(Reader reader)
                      throws ParseException,
                             IOException
```
    Parses an ASCII property list from a Reader. This method does not close the specified reader.
    
    Parameters:
    
    reader - The reader that provides the property list's data.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    IOException - If an error occurs while reading from the input reader.
  - parse
```
public static NSObject parse(String plistData)
                      throws ParseException
```
    Parses an ASCII property list from a String
    
    Parameters:
    
    plistData - A string containing the property list's data.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
  - parse
```
public static NSObject parse(byte[] bytes)
                      throws ParseException
```
    Parses an ASCII property list from a byte array.
    
    Parameters:
    
    bytes - The ASCII property list data.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
  - parse
```
public static NSObject parse(byte[] bytes,
                             String encoding)
                      throws ParseException,
                             UnsupportedEncodingException
```
    Parses an ASCII property list from a byte array.
    
    Parameters:
    
    bytes - The ASCII property list data.
    
    encoding - The name of a supported Charset charset to decode the property list.
    
    Returns:
    
    The root object of the property list. This is usually a NSDictionary but can also be a NSArray.
    
    Throws:
    
    ParseException - If an error occurs during parsing.
    
    UnsupportedEncodingException - If no support for the named charset is available in this instance of the Java virtual machine.
  - parse
```
public NSObject parse()
               throws ParseException
```
    Parses the property list from the beginning and returns the root object of the property list.
    
    Returns:
    
    The root object of the property list. This can either be a NSDictionary or a NSArray.
    
    Throws:
    
    ParseException - If an error occurred during parsing

Class ASCIIPropertyListParser

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

WHITESPACE_SPACE

WHITESPACE_TAB

WHITESPACE_NEWLINE

WHITESPACE_CARRIAGE_RETURN

ARRAY_BEGIN_TOKEN

ARRAY_END_TOKEN

ARRAY_ITEM_DELIMITER_TOKEN

DICTIONARY_BEGIN_TOKEN

DICTIONARY_END_TOKEN

DICTIONARY_ASSIGN_TOKEN

DICTIONARY_ITEM_DELIMITER_TOKEN

QUOTEDSTRING_BEGIN_TOKEN

QUOTEDSTRING_END_TOKEN

QUOTEDSTRING_ESCAPE_TOKEN

DATA_BEGIN_TOKEN

DATA_END_TOKEN

DATA_GSOBJECT_BEGIN_TOKEN

DATA_GSDATE_BEGIN_TOKEN

DATA_GSBOOL_BEGIN_TOKEN

DATA_GSBOOL_TRUE_TOKEN

DATA_GSBOOL_FALSE_TOKEN

DATA_GSINT_BEGIN_TOKEN

DATA_GSREAL_BEGIN_TOKEN

DATE_DATE_FIELD_DELIMITER

DATE_TIME_FIELD_DELIMITER

DATE_GS_DATE_TIME_DELIMITER

DATE_APPLE_DATE_TIME_DELIMITER

DATE_APPLE_END_TOKEN

COMMENT_BEGIN_TOKEN

MULTILINE_COMMENT_SECOND_TOKEN

SINGLELINE_COMMENT_SECOND_TOKEN

MULTILINE_COMMENT_END_TOKEN

Method Detail

parse

parse

parse

parse

parse

parse

parse

parse

parse

parse

parse