---

Introduction to Property Lists

Contents:

Organization of This Document

Property lists organize data into named values and lists of values using several object types. These types give you the means to produce data that is meaningfully structured, transportable, storable, and accessible, but still as efficient as possible. Property lists are frequently used by applications running on both Mac OS X and iPhone OS. The property-list programming interfaces for Cocoa and Core Foundation allow you to convert hierarchically structured combinations of these basic types of objects to and from standard XML. You can save the XML data to disk and later use it to reconstruct the original objects.

This document describes property lists and their various representations, and how to work with them using both certain Foundation classes of Cocoa and Property List Services of Core Foundation.

Organization of This Document

This document consists of the following chapters:

• “Quick Start for Property Lists” is a mini-tutorial on property lists, giving you a “hands-on” familiarity with XML property lists and the Objective-C serialization API.

• “About Property Lists” explains what property lists are and when you should use them.

• “Creating Property Lists Programmatically” shows how you can create hierarchically structured property lists using the APIs of Cocoa and Core Foundation.

• “Understanding XML Property Lists” describes the format of XML property lists.

• “Serializing a Property List ” discusses how to serialize and deserialize property lists between their runtime and static representations).

• “Reading and Writing Property-List Data” describes how to save property lists to files or URL resources and how to restore them later.

• “Old-Style ASCII Property Lists” is an appendix that describes the format of old-style (OpenStep) ASCII property lists.

---