ASCIIPropertyListParser (dd-plist 1.8 API)

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

```
public 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 explicitely defined.
Resources on ASCII property list format:
- 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`

Constructor Summary

Constructors
Modifier Constructor and Description

protected ASCIIPropertyListParser()
Only allow subclasses to change instantiation.

Constructors
Modifier	Constructor and Description
`protected`	`ASCIIPropertyListParser()` Only allow subclasses to change instantiation.

Method Summary

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(File f)` Parses an ASCII property list file.
`static NSObject`	`parse(InputStream in)` Parses an ASCII property list from an input stream.
`static String`	`parseQuotedString(String s)` Parses a string according to the format specified for ASCII property lists.

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
- Constructor Detail
  - ASCIIPropertyListParser
```
protected ASCIIPropertyListParser()
```
    Only allow subclasses to change instantiation.
- 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 usally a NSDictionary but can also be a NSArray.
    
    Throws:
    
    Exception - When an error occurs during parsing.
    
    IOException
    
    ParseException
  - parse
```
public static NSObject parse(InputStream in)
                      throws ParseException,
                             IOException
```
    Parses an ASCII property list from an input stream.
    
    Parameters:
    in - The input stream that points to the property list's data.
    
    Returns:
    The root object of the property list. This is usally a NSDictionary but can also be a NSArray.
    
    Throws:
    
    Exception - When an error occurs during parsing.
    
    ParseException
    
    IOException
  - 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 usally a NSDictionary but can also be a NSArray.
    
    Throws:
    
    Exception - When an error occurs during parsing.
    
    ParseException
  - 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 - When an error occured during parsing
  - parseQuotedString
```
public static String parseQuotedString(String s)
                                throws UnsupportedEncodingException,
                                       CharacterCodingException
```
    Parses a string according to the format specified for ASCII property lists. Such strings can contain escape sequences which are unescaped in this method.
    
    Parameters:
    s - The escaped string according to the ASCII property list format, without leading and trailing quotation marks.
    
    Returns:
    The unescaped string in UTF-8 or ASCII format, depending on the contained characters.
    
    Throws:
    
    Exception - If the string could not be properly parsed.
    
    UnsupportedEncodingException
    
    CharacterCodingException

Class ASCIIPropertyListParser

Field Summary

Constructor 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

Constructor Detail

ASCIIPropertyListParser

Method Detail

parse

parse

parse

parse

parseQuotedString