RubyGems - nano-store - Versions diffs - 0.6.0 → 0.6.1 - Mend

nano-store 0.6.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (81) hide show

data/CHANGELOG.md CHANGED

@@ -1,3 +1,8 @@
+# [0.6.1](https://github.com/siuying/NanoStoreInMotion/compare/v0.6.0%E2%80%A6v0.6.1)
+- ```attributes``` method to add multiple attributes in one line (thanks @gouravtiwari)
+- Update for NanoStore 2.5.7
 # [0.6.0](https://github.com/siuying/NanoStoreInMotion/compare/v0.5.2%E2%80%A6v0.6.0)
 - Update for NanoStore 2.5.3, some notable changes:

data/README.md CHANGED

@@ -33,7 +33,7 @@ Motion::Project::App.setup do |app|
   # Add the pod NanoStore to your project
   app.pods do
-    pod 'NanoStore', '~> 2.5.3'
+    pod 'NanoStore', '~> 2.5.7'
   end
 end
 ```
@@ -73,6 +73,8 @@ Attributes must be serializable, which means that only the following data types
 - NSData (*)
 - NSDate
 - NSNumber
+- NSNull
+- NSURL
 #### Note

data/Rakefile CHANGED

@@ -9,7 +9,7 @@ Motion::Project::App.setup do |app|
   app.redgreen_style = :full
   app.files += Dir.glob(File.join(app.project_dir, 'lib/nano_store/*.rb'))
   app.pods do
-    pod 'NanoStore', '~> 2.5.3'
+    pod 'NanoStore', '~> 2.5.7'
   end
 end

data/lib/nano_store.rb CHANGED

@@ -16,5 +16,5 @@ Motion::Project::App.setup do |app|
   app.files.unshift(File.join(File.dirname(__FILE__), 'nano_store/finder.rb'))
   app.pods ||= Motion::Project::CocoaPods.new(app)
-  app.pods.pod 'NanoStore', '~> 2.5.3'
+  app.pods.pod 'NanoStore', '~> 2.5.7'
 end

data/lib/nano_store/model.rb CHANGED

@@ -54,8 +54,12 @@ module NanoStore
       end
     end
-    def attributes
-      @attributes ||= []
+    def attributes(*attrs)
+      if attrs.size > 0
+        attrs.each{|attr| attribute attr}
+      else
+        @attributes ||= []
+      end
     end
     def store
@@ -80,12 +84,12 @@ module NanoStore
   end
   class Model < NSFNanoObject
-    include ModelInstanceMethods
-    extend ModelClassMethods
-    extend FinderMethods
+    include NanoStore::ModelInstanceMethods
+    extend NanoStore::ModelClassMethods
+    extend NanoStore::FinderMethods
-    include AssociationInstanceMethods
-    extend AssociationClassMethods
+    include NanoStore::AssociationInstanceMethods
+    extend NanoStore::AssociationClassMethods
   end
 end

data/lib/nano_store/version.rb CHANGED

@@ -1,3 +1,3 @@
 module NanoStore
-  VERSION = "0.6.0"
+  VERSION = "0.6.1"
 end

data/spec/model_spec.rb CHANGED

@@ -1,13 +1,10 @@
 describe NanoStore::Model do
   class User < NanoStore::Model
-    attribute :name
-    attribute :age
-    attribute :created_at
+    attributes :name, :age, :created_at
   end
   class Plane < NanoStore::Model
-    attribute :name
-    attribute :age
+    attributes :name, :age
   end
   class Listing < NanoStore::Model

data/vendor/Podfile.lock CHANGED

@@ -1,11 +1,11 @@
 PODS:
-- NanoStore (2.5.3)
+- NanoStore (2.5.7)
 DEPENDENCIES:
-- NanoStore (~> 2.5.3)
+- NanoStore (~> 2.5.7)
 SPEC CHECKSUMS:
-  NanoStore: ea3eabc945dbd7d80678da2b0aed669f683d239f
+  NanoStore: bca650b45d05084acf1c5cfc1b75985f5ce1e197
-COCOAPODS: 0.16.0
+COCOAPODS: 0.16.1

data/vendor/Pods/BuildHeaders/NanoStore/NSFNanoGlobals.h CHANGED

@@ -144,7 +144,9 @@ typedef enum {
     /** * Greater Ththanan */
     NSFGreaterThan,
     /** * Less than */
-    NSFLessThan
+    NSFLessThan,
+    /** * Not Equal to from */
+    NSFNotEqualTo
 } NSFMatchType;
 /** * Column types for the Attributes table.

data/vendor/Pods/BuildHeaders/NanoStore/NSFNanoPredicate.h CHANGED

@@ -77,7 +77,7 @@
 /** * The comparison operator to be used. */
 @property (nonatomic, assign, readonly) NSFMatchType match;
 /** * The value to be used for comparison.  */
-@property (nonatomic, copy, readonly) NSString *value;
+@property (nonatomic, readonly) id value;
 /** @name Creating and Initializing a Predicate
  */
@@ -87,22 +87,22 @@
 /** * Creates and returns a predicate.
  * @param theType is the column type. Can be \link Globals::NSFKeyColumn NSFKeyColumn \endlink, \link Globals::NSFAttributeColumn NSFAttributeColumn \endlink or \link Globals::NSFValueColumn NSFValueColumn \endlink.
  * @param theMatch is the match operator.
- * @param theValue is the value.
+ * @param theValue can be an NSString or [NSNull null]
  * @return A predicate which can be used in an NSFNanoExpression.
  * @see \link initWithColumn:matching:value: - (id)initWithColumn:(NSFTableColumnType)theType matching:(NSFMatchType)theMatch value:(NSString *)theValue \endlink
  */
-+ (NSFNanoPredicate*)predicateWithColumn:(NSFTableColumnType)theType matching:(NSFMatchType)theMatch value:(NSString *)theValue;
++ (NSFNanoPredicate*)predicateWithColumn:(NSFTableColumnType)theType matching:(NSFMatchType)theMatch value:(id)theValue;
 /** * Initializes a newly allocated predicate.
  * @param theType is the column type. Can be \link Globals::NSFKeyColumn NSFKeyColumn \endlink, \link Globals::NSFAttributeColumn NSFAttributeColumn \endlink or \link Globals::NSFValueColumn NSFValueColumn \endlink.
  * @param theMatch is the match operator.
- * @param theValue is the value.
+ * @param theValue can be an NSString or [NSNull null]
  * @return A predicate which can be used in an NSFNanoExpression.
  * @see \link predicateWithColumn:matching:value: + (NSFNanoPredicate*)predicateWithColumn:(NSFTableColumnType)theType matching:(NSFMatchType)theMatch value:(NSString *)theValue \endlink
  */
-- (id)initWithColumn:(NSFTableColumnType)theType matching:(NSFMatchType)theMatch value:(NSString *)theValue;
+- (id)initWithColumn:(NSFTableColumnType)theType matching:(NSFMatchType)theMatch value:(id)theValue;
 //@}

data/vendor/Pods/BuildHeaders/NanoStore/NSFNanoSearch.h CHANGED

@@ -180,6 +180,8 @@
 @property (nonatomic, assign, readwrite) NSUInteger offset;
 /** * The limit clause is used to place an upper bound on the number of rows returned by a Search operation. */
 @property (nonatomic, assign, readwrite) NSUInteger limit;
+/** * limit a Search to a particular bag. */
+@property (nonatomic, assign, readwrite) NSFNanoBag *bag;
 /** @name Creating and Initializing a Search
  */
@@ -213,7 +215,7 @@
  * @param theReturnType the type of object to be returned. Can be \link Globals::NSFReturnObjects NSFReturnObjects \endlink or \link Globals::NSFReturnKeys NSFReturnKeys \endlink.
  * @param outError is used if an error occurs. May be NULL.
  * @return An array is returned if: 1) the sort has been specified or 2) the return type is \link Globals::NSFReturnKeys NSFReturnKeys \endlink. Otherwise, a dictionary is returned.
- * @note The sort descriptor will be ignored when returning requesting NSFReturnKeys.
+ * @note The sort descriptor will be ignored when the return type is NSFReturnKeys.
  * @see \link searchObjectsAdded:date:returnType:error: - (id)searchObjectsAdded:(NSFDateMatchType)theDateMatch date:(NSDate *)theDate returnType:(NSFReturnType)theReturnType error:(out NSError **)outError \endlink
  */
@@ -225,7 +227,7 @@
  * @param theReturnType the type of object to be returned. Can be \link Globals::NSFReturnObjects NSFReturnObjects \endlink or \link Globals::NSFReturnKeys NSFReturnKeys \endlink.
  * @param outError is used if an error occurs. May be NULL.
  * @return If theReturnType is \link Globals::NSFReturnObjects NSFReturnObjects \endlink, a dictionary is returned. Otherwise, an array is returned.
- * @note The sort descriptor will be ignored when returning requesting NSFReturnKeys.
+ * @note The sort descriptor will be ignored when the return type is NSFReturnKeys.
  * @see \link searchObjectsWithReturnType:error: - (id)searchObjectsWithReturnType:(NSFReturnType)theReturnType error:(out NSError **)outError \endlink
  */

data/vendor/Pods/Documentation/NanoStore/docset-installed.txt ADDED

@@ -0,0 +1,4 @@
+Documentation set was installed to Xcode!
+Path: /Users/siuying/Library/Developer/Shared/Documentation/DocSets/org.cocoapods.NanoStore-2.5.7.docset
+Time: 2013-01-22 07:56:31 +0000

data/vendor/Pods/Documentation/NanoStore/docset/Contents/Info.plist ADDED

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleIdentifier</key>
+	<string>org.cocoapods.NanoStore-2.5.7</string>
+	<key>CFBundleName</key>
+	<string>NanoStore 2.5.7 Documentation</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1.0</string>
+	<key>DocSetDescription</key>
+	<string>NanoStore is an open source, lightweight schema-less local key-value document store written in Objective-C for Mac OS X and iOS.</string>
+	<key>DocSetFeedName</key>
+	<string>NanoStore 2.5.7 Documentation</string>
+	<key>DocSetMinimumXcodeVersion</key>
+	<string>3.0</string>
+	<key>DocSetPublisherIdentifier</key>
+	<string>org.cocoapods.documentation</string>
+	<key>DocSetPublisherName</key>
+	<string>Tito Ciuro</string>
+	<key>NSHumanReadableCopyright</key>
+	<string>Tito Ciuro</string>
+</dict>
+</plist>

data/vendor/Pods/Documentation/NanoStore/docset/Contents/Resources/Documents/Classes/NSFNanoBag.html ADDED

@@ -0,0 +1,2266 @@
+<!DOCTYPE HTML>
+<html>
+	<head>
+		<meta http-equiv="Content-Type" content="html/html; charset=utf-8" />
+		<title>NSFNanoBag Class Reference</title>
+		<meta id="xcode-display" name="xcode-display" content="render"/>
+		<meta name="viewport" content="width=550" />
+		<link rel="stylesheet" type="text/css" href="../css/styles.css" media="all" />
+		<link rel="stylesheet" type="text/css" media="print" href="../css/stylesPrint.css" />
+		<meta name="generator" content="appledoc 2.0.5 (build 789)" />
+	</head>
+	<body>
+		<header id="top_header">
+			<div id="library" class="hideInXcode">
+				<h1><a id="libraryTitle" href="../index.html">NanoStore 2.5.7 </a></h1>
+				<a id="developerHome" href="../index.html">Tito Ciuro</a>
+			</div>
+			<div id="title" role="banner">
+				<h1 class="hideInXcode">NSFNanoBag Class Reference</h1>
+			</div>
+			<ul id="headerButtons" role="toolbar">
+				<li id="toc_button">
+					<button aria-label="Show Table of Contents" role="checkbox" class="open" id="table_of_contents"><span class="disclosure"></span>Table of Contents</button>
+				</li>
+				<li id="jumpto_button" role="navigation">
+					<select id="jumpTo">
+	<option value="top">Jump To&#133;</option>
+	<option value="overview">Overview</option>
+	<option value="tasks">Tasks</option>
+	<option value="properties">Properties</option>
+	<option value="//api/name/hasUnsavedChanges">&nbsp;&nbsp;&nbsp;&nbsp;hasUnsavedChanges</option>
+	<option value="//api/name/key">&nbsp;&nbsp;&nbsp;&nbsp;key</option>
+	<option value="//api/name/name">&nbsp;&nbsp;&nbsp;&nbsp;name</option>
+	<option value="//api/name/removedObjects">&nbsp;&nbsp;&nbsp;&nbsp;removedObjects</option>
+	<option value="//api/name/savedObjects">&nbsp;&nbsp;&nbsp;&nbsp;savedObjects</option>
+	<option value="//api/name/store">&nbsp;&nbsp;&nbsp;&nbsp;store</option>
+	<option value="//api/name/unsavedObjects">&nbsp;&nbsp;&nbsp;&nbsp;unsavedObjects</option>
+	<option value="class_methods">Class Methods</option>
+	<option value="//api/name/bag">&nbsp;&nbsp;&nbsp;&nbsp;+ bag</option>
+	<option value="//api/name/bagWithObjects:">&nbsp;&nbsp;&nbsp;&nbsp;+ bagWithObjects:</option>
+	<option value="instance_methods">Instance Methods</option>
+	<option value="//api/name/JSONDescription">&nbsp;&nbsp;&nbsp;&nbsp;- JSONDescription</option>
+	<option value="//api/name/_inflateObjectsWithKeys:">&nbsp;&nbsp;&nbsp;&nbsp;- _inflateObjectsWithKeys:</option>
+	<option value="//api/name/_saveInStore:error:">&nbsp;&nbsp;&nbsp;&nbsp;- _saveInStore:error:</option>
+	<option value="//api/name/_setStore:">&nbsp;&nbsp;&nbsp;&nbsp;- _setStore:</option>
+	<option value="//api/name/addObject:error:">&nbsp;&nbsp;&nbsp;&nbsp;- addObject:error:</option>
+	<option value="//api/name/addObjectsFromArray:error:">&nbsp;&nbsp;&nbsp;&nbsp;- addObjectsFromArray:error:</option>
+	<option value="//api/name/count">&nbsp;&nbsp;&nbsp;&nbsp;- count</option>
+	<option value="//api/name/deflateBag">&nbsp;&nbsp;&nbsp;&nbsp;- deflateBag</option>
+	<option value="//api/name/description">&nbsp;&nbsp;&nbsp;&nbsp;- description</option>
+	<option value="//api/name/dictionaryRepresentation">&nbsp;&nbsp;&nbsp;&nbsp;- dictionaryRepresentation</option>
+	<option value="//api/name/inflateBag">&nbsp;&nbsp;&nbsp;&nbsp;- inflateBag</option>
+	<option value="//api/name/initBagWithName:andObjects:">&nbsp;&nbsp;&nbsp;&nbsp;- initBagWithName:andObjects:</option>
+	<option value="//api/name/isEqualToNanoBag:">&nbsp;&nbsp;&nbsp;&nbsp;- isEqualToNanoBag:</option>
+	<option value="//api/name/reloadBagWithError:">&nbsp;&nbsp;&nbsp;&nbsp;- reloadBagWithError:</option>
+	<option value="//api/name/removeAllObjects">&nbsp;&nbsp;&nbsp;&nbsp;- removeAllObjects</option>
+	<option value="//api/name/removeObject:">&nbsp;&nbsp;&nbsp;&nbsp;- removeObject:</option>
+	<option value="//api/name/removeObjectWithKey:">&nbsp;&nbsp;&nbsp;&nbsp;- removeObjectWithKey:</option>
+	<option value="//api/name/removeObjectsInArray:">&nbsp;&nbsp;&nbsp;&nbsp;- removeObjectsInArray:</option>
+	<option value="//api/name/removeObjectsWithKeysInArray:">&nbsp;&nbsp;&nbsp;&nbsp;- removeObjectsWithKeysInArray:</option>
+	<option value="//api/name/saveAndReturnError:">&nbsp;&nbsp;&nbsp;&nbsp;- saveAndReturnError:</option>
+	<option value="//api/name/undoChangesWithError:">&nbsp;&nbsp;&nbsp;&nbsp;- undoChangesWithError:</option>
+</select>
+				</li>
+			</ul>
+		</header>
+		<nav id="tocContainer" class="isShowingTOC">
+			<ul id="toc" role="tree">
+<li role="treeitem"><span class="nodisclosure"></span><span class="sectionName"><a href="#overview">Overview</a></span></li>
+<li role="treeitem" id="task_treeitem"><span class="nodisclosure"></span><span class="sectionName"><a href="#tasks">Tasks</a></span><ul>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#task_Creating and Initializing Bags">Creating and Initializing Bags</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#task_Adding and Removing Objects">Adding and Removing Objects</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#task_Saving, Reloading and Undoing">Saving, Reloading and Undoing</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#task_Inflating and Deflating">Inflating and Deflating</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#task_Miscellaneous">Miscellaneous</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#task_Private Methods">Private Methods</a></span></li>
+</ul></li>
+<li role="treeitem" class="children"><span class="disclosure"></span><span class="sectionName"><a href="#properties">Properties</a></span><ul>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/hasUnsavedChanges">hasUnsavedChanges</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/key">key</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/name">name</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/removedObjects">removedObjects</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/savedObjects">savedObjects</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/store">store</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/unsavedObjects">unsavedObjects</a></span></li>
+</ul></li>
+<li role="treeitem" class="children"><span class="disclosure"></span><span class="sectionName"><a href="#class_methods">Class Methods</a></span><ul>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/bag">bag</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/bagWithObjects:">bagWithObjects:</a></span></li>
+</ul></li>
+<li role="treeitem" class="children"><span class="disclosure"></span><span class="sectionName"><a href="#instance_methods">Instance Methods</a></span><ul>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/JSONDescription">JSONDescription</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/_inflateObjectsWithKeys:">_inflateObjectsWithKeys:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/_saveInStore:error:">_saveInStore:error:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/_setStore:">_setStore:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/addObject:error:">addObject:error:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/addObjectsFromArray:error:">addObjectsFromArray:error:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/count">count</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/deflateBag">deflateBag</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/description">description</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/dictionaryRepresentation">dictionaryRepresentation</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/inflateBag">inflateBag</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/initBagWithName:andObjects:">initBagWithName:andObjects:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/isEqualToNanoBag:">isEqualToNanoBag:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/reloadBagWithError:">reloadBagWithError:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/removeAllObjects">removeAllObjects</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/removeObject:">removeObject:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/removeObjectWithKey:">removeObjectWithKey:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/removeObjectsInArray:">removeObjectsInArray:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/removeObjectsWithKeysInArray:">removeObjectsWithKeysInArray:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/saveAndReturnError:">saveAndReturnError:</a></span></li>
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/undoChangesWithError:">undoChangesWithError:</a></span></li>
+</ul></li>
+			</ul>
+		</nav>
+		<article>
+			<div id="contents" class="isShowingTOC" role="main">
+				<a title="NSFNanoBag Class Reference" name="top"></a>
+				<div class="main-navigation navigation-top">
+					<ul>
+	<li><a href="../index.html">Index</a></li>
+	<li><a href="../hierarchy.html">Hierarchy</a></li>
+</ul>
+				</div>
+				<div id="header">
+					<div class="section-header">
+						<h1 class="title title-header">NSFNanoBag Class Reference</h1>
+					</div>
+				</div>
+				<div id="container">
+					<div class="section section-specification"><table cellspacing="0"><tbody>
+						<tr>
+	<td class="specification-title">Inherits from</td>
+	<td class="specification-value">NSObject</td>
+</tr><tr>
+	<td class="specification-title">Conforms to</td>
+	<td class="specification-value">NSCopying<br /><a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a></td>
+</tr><tr>
+	<td class="specification-title">Declared in</td>
+	<td class="specification-value">NSFNanoBag.h</td>
+</tr>
+						</tbody></table></div>
+					<div class="section section-overview">
+						<a title="Overview" name="overview"></a>
+						<h2 class="subtitle subtitle-overview">Overview</h2>
+						<p>@class NSFNanoBag
+* A <a href="#//api/name/bag">bag</a> is a loose collection of objects stored in a document <a href="#//api/name/store">store</a>.
+*
+* @note
+* The objects must conform to the \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink. For your convenience, NanoStore provides you with <a href="../Classes/NSFNanoObject.html">NSFNanoObject</a>, which is the standard
+* way of storing and retrieving objects from/to a <a href="#//api/name/bag">bag</a>.
+*
+* @par
+* It&rsquo;s more efficient to make your storage objects \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant, thus eliminating the need to convert your objects to/from
+* objects of type <a href="../Classes/NSFNanoObject.html">NSFNanoObject</a>.
+*
+* @details <b>Example:</b>
+@code
+// Instantiate a NanoStore and open it
+<a href="../Classes/NSFNanoStore.html">NSFNanoStore</a> *nanoStore = [NSFNanoStore createAndOpenStoreWithType:NSFMemoryStoreType path:nil error:nil];
+[nanoStore removeAllObjectsFromStoreAndReturnError:nil];</p>
+<p>// Add some data to a <a href="#//api/name/bag">bag</a>
+NSFNanoBag <em><a href="#//api/name/bag">bag</a> = <a href="#//api/name/bag">[NSFNanoBag bag]</a>;
+NSDictionary </em>info = &hellip;;
+<a href="../Classes/NSFNanoObject.html">NSFNanoObject</a> <em>obj1 = [NSFNanoObject nanoObjectWithDictionary:info];
+<a href="../Classes/NSFNanoObject.html">NSFNanoObject</a> </em>obj2 = [NSFNanoObject nanoObjectWithDictionary:info];
+<a href="../Classes/NSFNanoObject.html">NSFNanoObject</a> *obj3 = [NSFNanoObject nanoObjectWithDictionary:info];
+[<a href="#//api/name/bag">bag</a> addObjectsFromArray:[NSArray arrayWithObjects:obj1, obj2, obj3, nil] error:nil];</p>
+<p>// Add the <a href="#//api/name/bag">bag</a> and its objects to the document <a href="#//api/name/store">store</a>
+[nanoStore addObject:<a href="#//api/name/bag">bag</a> error:nil];</p>
+<p>// Obtain the bags from the document <a href="#//api/name/store">store</a>
+NSArray *bags = [nanoStore bags];</p>
+<p>// Close the document store
+[nanoStore closeWithError:nil];
+@endcode</p>
+<p>\cond</p>
+					</div>
+					<div class="section section-tasks">
+						<a title="Tasks" name="tasks"></a>
+						<h2 class="subtitle subtitle-tasks">Tasks</h2>
+						<h3 class="subsubtitle task-title">Other Methods</h3>
+						<ul class="task-list">
+							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/store">&nbsp;&nbsp;store</a></code>
+		<span class="tooltip"><ul>
+<li>The store where the <a href="#//api/name/bag">bag</a> is located.</li>
+</ul>
+</span>
+	</span>
+	<span class="task-item-suffix">property</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/name">&nbsp;&nbsp;name</a></code>
+		<span class="tooltip"><ul>
+<li>The name of the <a href="#//api/name/bag">bag</a>.</li>
+</ul>
+</span>
+	</span>
+	<span class="task-item-suffix">property</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/key">&nbsp;&nbsp;key</a></code>
+		<span class="tooltip"><ul>
+<li>The UUID of the <a href="#//api/name/bag">bag</a>.</li>
+</ul>
+</span>
+	</span>
+	<span class="task-item-suffix">property</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/savedObjects">&nbsp;&nbsp;savedObjects</a></code>
+		<span class="tooltip"><ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+</span>
+	</span>
+	<span class="task-item-suffix">property</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/unsavedObjects">&nbsp;&nbsp;unsavedObjects</a></code>
+		<span class="tooltip"><ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+</span>
+	</span>
+	<span class="task-item-suffix">property</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/removedObjects">&nbsp;&nbsp;removedObjects</a></code>
+		<span class="tooltip"><ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+</span>
+	</span>
+	<span class="task-item-suffix">property</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/hasUnsavedChanges">&nbsp;&nbsp;hasUnsavedChanges</a></code>
+		<span class="tooltip"><ul>
+<li>To determine whether the <a href="#//api/name/bag">bag</a> has uncommited changes.</li>
+</ul>
+</span>
+	</span>
+	<span class="task-item-suffix">property</span>
+</li>
+						</ul>
+						<a title="Creating and Initializing Bags" name="task_Creating and Initializing Bags"></a>
+						<h3 class="subsubtitle task-title">Creating and Initializing Bags</h3>
+						<ul class="task-list">
+							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/bag">+&nbsp;bag</a></code>
+		<span class="tooltip"><p>Creates and returns an empty bag.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/bagWithObjects:">+&nbsp;bagWithObjects:</a></code>
+		<span class="tooltip"><p>Creates and returns a <a href="#//api/name/bag">bag</a> adding to it the objects contained in the given array.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/initBagWithName:andObjects:">&ndash;&nbsp;initBagWithName:andObjects:</a></code>
+		<span class="tooltip"><p>Initializes a newly allocated <a href="#//api/name/bag">bag</a> with the specified <a href="#//api/name/name">name</a> adding to it the objects contained in the given array.</p></span>
+	</span>
+</li>
+						</ul>
+						<a title="Adding and Removing Objects" name="task_Adding and Removing Objects"></a>
+						<h3 class="subsubtitle task-title">Adding and Removing Objects</h3>
+						<ul class="task-list">
+							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/addObject:error:">&ndash;&nbsp;addObject:error:</a></code>
+		<span class="tooltip"><p>Adds an \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant object to the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/addObjectsFromArray:error:">&ndash;&nbsp;addObjectsFromArray:error:</a></code>
+		<span class="tooltip"><p>Adds a series of \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant objects to the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/removeObject:">&ndash;&nbsp;removeObject:</a></code>
+		<span class="tooltip"><p>Removes the specified object from the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/removeAllObjects">&ndash;&nbsp;removeAllObjects</a></code>
+		<span class="tooltip"><p>Empties the <a href="#//api/name/bag">bag</a> of all its elements.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/removeObjectsInArray:">&ndash;&nbsp;removeObjectsInArray:</a></code>
+		<span class="tooltip"><p>Removes the list of objects from the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/removeObjectWithKey:">&ndash;&nbsp;removeObjectWithKey:</a></code>
+		<span class="tooltip"><p>Removes the object with a given <a href="#//api/name/key">key</a> from the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/removeObjectsWithKeysInArray:">&ndash;&nbsp;removeObjectsWithKeysInArray:</a></code>
+		<span class="tooltip"><p>Removes from the <a href="#//api/name/bag">bag</a> the objects specified by elements in a given array.</p></span>
+	</span>
+</li>
+						</ul>
+						<a title="Saving, Reloading and Undoing" name="task_Saving, Reloading and Undoing"></a>
+						<h3 class="subsubtitle task-title">Saving, Reloading and Undoing</h3>
+						<ul class="task-list">
+							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/saveAndReturnError:">&ndash;&nbsp;saveAndReturnError:</a></code>
+		<span class="tooltip"><p>Saves the <a href="#//api/name/bag">bag</a> and its contents. Also, saves all the changes made since the last save.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/reloadBagWithError:">&ndash;&nbsp;reloadBagWithError:</a></code>
+		<span class="tooltip"><p>Refreshes the <a href="#//api/name/bag">bag</a> to match the contents stored in the document <a href="#//api/name/store">store</a>. The unsaved contents are preserved.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/undoChangesWithError:">&ndash;&nbsp;undoChangesWithError:</a></code>
+		<span class="tooltip"><p>Discards the changes made in the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li>
+						</ul>
+						<a title="Inflating and Deflating" name="task_Inflating and Deflating"></a>
+						<h3 class="subsubtitle task-title">Inflating and Deflating</h3>
+						<ul class="task-list">
+							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/inflateBag">&ndash;&nbsp;inflateBag</a></code>
+		<span class="tooltip"><p>Inflates the <a href="#//api/name/bag">bag</a> by reconstructing the objects flattened with &ndash; (void)<a href="#//api/name/deflateBag">deflateBag</a>;</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/deflateBag">&ndash;&nbsp;deflateBag</a></code>
+		<span class="tooltip"><p>Releases memory by &ldquo;flattening&rdquo; the objects from the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li>
+						</ul>
+						<a title="Miscellaneous" name="task_Miscellaneous"></a>
+						<h3 class="subsubtitle task-title">Miscellaneous</h3>
+						<ul class="task-list">
+							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/count">&ndash;&nbsp;count</a></code>
+		<span class="tooltip"><p>Returns the number of objects currently in the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/isEqualToNanoBag:">&ndash;&nbsp;isEqualToNanoBag:</a></code>
+		<span class="tooltip"><p>Compares the receiving <a href="#//api/name/bag">bag</a> to another <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/dictionaryRepresentation">&ndash;&nbsp;dictionaryRepresentation</a></code>
+		<span class="tooltip"><p>Returns a dictionary that contains the information stored in the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/description">&ndash;&nbsp;description</a></code>
+		<span class="tooltip"><p>Returns a string representation of the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/JSONDescription">&ndash;&nbsp;JSONDescription</a></code>
+		<span class="tooltip"><p>Returns a JSON representation of the <a href="#//api/name/bag">bag</a>.</p></span>
+	</span>
+</li>
+						</ul>
+						<a title="Private Methods" name="task_Private Methods"></a>
+						<h3 class="subsubtitle task-title">Private Methods</h3>
+						<ul class="task-list">
+							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/_setStore:">&ndash;&nbsp;_setStore:</a></code>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/_saveInStore:error:">&ndash;&nbsp;_saveInStore:error:</a></code>
+	</span>
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/_inflateObjectsWithKeys:">&ndash;&nbsp;_inflateObjectsWithKeys:</a></code>
+	</span>
+</li>
+						</ul>
+					</div>
+					<div class="section section-methods">
+						<a title="Properties" name="properties"></a>
+						<h2 class="subtitle subtitle-methods">Properties</h2>
+						<div class="section-method">
+	<a name="//api/name/hasUnsavedChanges" title="hasUnsavedChanges"></a>
+	<h3 class="subsubtitle method-title">hasUnsavedChanges</h3>
+	<div class="method-subsection brief-description">
+		<ul>
+<li>To determine whether the <a href="#//api/name/bag">bag</a> has uncommited changes.</li>
+</ul>
+	</div>
+	<div class="method-subsection method-declaration"><code>@property (nonatomic, assign, readonly) BOOL hasUnsavedChanges</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<ul>
+<li>To determine whether the <a href="#//api/name/bag">bag</a> has uncommited changes.</li>
+</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/key" title="key"></a>
+	<h3 class="subsubtitle method-title">key</h3>
+	<div class="method-subsection brief-description">
+		<ul>
+<li>The UUID of the <a href="#//api/name/bag">bag</a>.</li>
+</ul>
+	</div>
+	<div class="method-subsection method-declaration"><code>@property (nonatomic, copy, readonly) NSString *key</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<ul>
+<li>The UUID of the <a href="#//api/name/bag">bag</a>.</li>
+</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/name" title="name"></a>
+	<h3 class="subsubtitle method-title">name</h3>
+	<div class="method-subsection brief-description">
+		<ul>
+<li>The name of the <a href="#//api/name/bag">bag</a>.</li>
+</ul>
+	</div>
+	<div class="method-subsection method-declaration"><code>@property (nonatomic, copy, readwrite) NSString *name</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<ul>
+<li>The name of the <a href="#//api/name/bag">bag</a>.</li>
+</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/removedObjects" title="removedObjects"></a>
+	<h3 class="subsubtitle method-title">removedObjects</h3>
+	<div class="method-subsection brief-description">
+		<ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+	</div>
+	<div class="method-subsection method-declaration"><code>@property (nonatomic, readonly) NSDictionary *removedObjects</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/savedObjects" title="savedObjects"></a>
+	<h3 class="subsubtitle method-title">savedObjects</h3>
+	<div class="method-subsection brief-description">
+		<ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+	</div>
+	<div class="method-subsection method-declaration"><code>@property (nonatomic, readonly) NSDictionary *savedObjects</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/store" title="store"></a>
+	<h3 class="subsubtitle method-title">store</h3>
+	<div class="method-subsection brief-description">
+		<ul>
+<li>The store where the <a href="#//api/name/bag">bag</a> is located.</li>
+</ul>
+	</div>
+	<div class="method-subsection method-declaration"><code>@property (nonatomic, weak, readonly) NSFNanoStore *store</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<ul>
+<li>The store where the <a href="#//api/name/bag">bag</a> is located.</li>
+</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/unsavedObjects" title="unsavedObjects"></a>
+	<h3 class="subsubtitle method-title">unsavedObjects</h3>
+	<div class="method-subsection brief-description">
+		<ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+	</div>
+	<div class="method-subsection method-declaration"><code>@property (nonatomic, readonly) NSDictionary *unsavedObjects</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<ul>
+<li>Dictionary of NSString (<a href="#//api/name/key">key</a>) and id<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a> (value).</li>
+</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+					</div>
+					<div class="section section-methods">
+						<a title="Class Methods" name="class_methods"></a>
+						<h2 class="subtitle subtitle-methods">Class Methods</h2>
+						<div class="section-method">
+	<a name="//api/name/bag" title="bag"></a>
+	<h3 class="subsubtitle method-title">bag</h3>
+	<div class="method-subsection brief-description">
+		<p>Creates and returns an empty bag.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>+ (NSFNanoBag *)bag</code></div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>An empty bag upon success, nil otherwise.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Creates and returns an empty bag.</p>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/bagWithObjects:" title="bagWithObjects:"></a>
+	<h3 class="subsubtitle method-title">bagWithObjects:</h3>
+	<div class="method-subsection brief-description">
+		<p>Creates and returns a <a href="#//api/name/bag">bag</a> adding to it the objects contained in the given array.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>+ (NSFNanoBag *)bagWithObjects:(NSArray *)<em>theObjects</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theObjects</em></dt>
+			<dd><p>an array of objects conforming to the \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>A <a href="#//api/name/bag">bag</a> only containing the objects with conform to the \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink upon success, nil otherwise.
+@throws NSFUnexpectedParameterException is thrown if theObjects is nil.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Creates and returns a <a href="#//api/name/bag">bag</a> adding to it the objects contained in the given array.</p><div class="warning"><p><strong>Warning:</strong> If theObjects is nil, an NSFUnexpectedParameterException will be thrown. Use + <a href="#//api/name/bag">bag</a>; instead.</p></div>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+					</div>
+					<div class="section section-methods">
+						<a title="Instance Methods" name="instance_methods"></a>
+						<h2 class="subtitle subtitle-methods">Instance Methods</h2>
+						<div class="section-method">
+	<a name="//api/name/JSONDescription" title="JSONDescription"></a>
+	<h3 class="subsubtitle method-title">JSONDescription</h3>
+	<div class="method-subsection brief-description">
+		<p>Returns a JSON representation of the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (NSString *)JSONDescription</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Returns a JSON representation of the <a href="#//api/name/bag">bag</a>.</p><div class="note"><p><strong>Note:</strong> Check properties <a href="#//api/name/savedObjects">savedObjects</a>, <a href="#//api/name/unsavedObjects">unsavedObjects</a> and <a href="#//api/name/removedObjects">removedObjects</a> to find out the current state of the <a href="#//api/name/bag">bag</a>.</p></div>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/_inflateObjectsWithKeys:" title="_inflateObjectsWithKeys:"></a>
+	<h3 class="subsubtitle method-title">_inflateObjectsWithKeys:</h3>
+	<div class="method-subsection method-declaration"><code>- (void)_inflateObjectsWithKeys:(NSArray *)<em>someKeys</em></code></div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/_saveInStore:error:" title="_saveInStore:error:"></a>
+	<h3 class="subsubtitle method-title">_saveInStore:error:</h3>
+	<div class="method-subsection method-declaration"><code>- (BOOL)_saveInStore:(NSFNanoStore *)<em>someStore</em> error:(out NSError **)<em>outError</em></code></div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/_setStore:" title="_setStore:"></a>
+	<h3 class="subsubtitle method-title">_setStore:</h3>
+	<div class="method-subsection method-declaration"><code>- (void)_setStore:(NSFNanoStore *)<em>aStore</em></code></div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/addObject:error:" title="addObject:error:"></a>
+	<h3 class="subsubtitle method-title">addObject:error:</h3>
+	<div class="method-subsection brief-description">
+		<p>Adds an \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant object to the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (BOOL)addObject:(id&lt;NSFNanoObjectProtocol&gt;)<em>theObject</em> error:(out NSError **)<em>outError</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theObject</em></dt>
+			<dd><p>is added to the <a href="#//api/name/bag">bag</a>.</p></dd>
+		</dl>
+		<dl class="argument-def parameter-def">
+			<dt><em>outError</em></dt>
+			<dd><p>is used if an error occurs. May be NULL.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>YES upon success, NO otherwise.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Adds an \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant object to the <a href="#//api/name/bag">bag</a>.</p><div class="warning"><p><strong>Warning:</strong> This value cannot be nil and it must be \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant.
+@throws NSFNonConformingNanoObjectProtocolException is thrown if the object is non-\link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink compliant.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/addObjectsFromArray:error:">&ndash; addObjectsFromArray:error:</a> &ndash; (BOOL)addObjectsFromArray:(NSArray *)theObjects error:(out NSError **)outError \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/addObjectsFromArray:error:" title="addObjectsFromArray:error:"></a>
+	<h3 class="subsubtitle method-title">addObjectsFromArray:error:</h3>
+	<div class="method-subsection brief-description">
+		<p>Adds a series of \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant objects to the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (BOOL)addObjectsFromArray:(NSArray *)<em>theObjects</em> error:(out NSError **)<em>outError</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theObjects</em></dt>
+			<dd><p>is an array of objects to be added to the <a href="#//api/name/bag">bag</a>. The objects must be \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant.</p></dd>
+		</dl>
+		<dl class="argument-def parameter-def">
+			<dt><em>outError</em></dt>
+			<dd><p>is used if an error occurs. May be NULL.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>YES upon success, NO otherwise.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Adds a series of \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant objects to the <a href="#//api/name/bag">bag</a>.</p><div class="warning"><p><strong>Warning:</strong> The objects of the array must be \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant.
+@throws NSFNonConformingNanoObjectProtocolException is thrown if the object is non-\link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink compliant.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/addObject:error:">&ndash; addObject:error:</a> &ndash; (BOOL)addObject:(id &lt;<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>>)theObject error:(out NSError **)outError \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/count" title="count"></a>
+	<h3 class="subsubtitle method-title">count</h3>
+	<div class="method-subsection brief-description">
+		<p>Returns the number of objects currently in the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (NSUInteger)count</code></div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>The number of objects currently in the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Returns the number of objects currently in the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/deflateBag" title="deflateBag"></a>
+	<h3 class="subsubtitle method-title">deflateBag</h3>
+	<div class="method-subsection brief-description">
+		<p>Releases memory by &ldquo;flattening&rdquo; the objects from the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (void)deflateBag</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Releases memory by &ldquo;flattening&rdquo; the objects from the <a href="#//api/name/bag">bag</a>.</p><div class="note"><p><strong>Note:</strong> Check properties <a href="#//api/name/savedObjects">savedObjects</a>, <a href="#//api/name/unsavedObjects">unsavedObjects</a> and <a href="#//api/name/removedObjects">removedObjects</a> to find out the current state of the <a href="#//api/name/bag">bag</a>.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/inflateBag">&ndash; inflateBag</a> &ndash; (void)<a href="#//api/name/inflateBag">&ndash; inflateBag</a> \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/description" title="description"></a>
+	<h3 class="subsubtitle method-title">description</h3>
+	<div class="method-subsection brief-description">
+		<p>Returns a string representation of the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (NSString *)description</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Returns a string representation of the <a href="#//api/name/bag">bag</a>.</p><div class="note"><p><strong>Note:</strong> Check properties <a href="#//api/name/savedObjects">savedObjects</a>, <a href="#//api/name/unsavedObjects">unsavedObjects</a> and <a href="#//api/name/removedObjects">removedObjects</a> to find out the current state of the <a href="#//api/name/bag">bag</a>.</p></div>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/dictionaryRepresentation" title="dictionaryRepresentation"></a>
+	<h3 class="subsubtitle method-title">dictionaryRepresentation</h3>
+	<div class="method-subsection brief-description">
+		<p>Returns a dictionary that contains the information stored in the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (NSDictionary *)dictionaryRepresentation</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Returns a dictionary that contains the information stored in the <a href="#//api/name/bag">bag</a>.</p><div class="note"><p><strong>Note:</strong> Check properties <a href="#//api/name/savedObjects">savedObjects</a>, <a href="#//api/name/unsavedObjects">unsavedObjects</a> and <a href="#//api/name/removedObjects">removedObjects</a> to find out the current state of the <a href="#//api/name/bag">bag</a>.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/description">&ndash; description</a> &ndash; (NSString *)<a href="#//api/name/description">&ndash; description</a> \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/inflateBag" title="inflateBag"></a>
+	<h3 class="subsubtitle method-title">inflateBag</h3>
+	<div class="method-subsection brief-description">
+		<p>Inflates the <a href="#//api/name/bag">bag</a> by reconstructing the objects flattened with &ndash; (void)<a href="#//api/name/deflateBag">deflateBag</a>;</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (void)inflateBag</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Inflates the <a href="#//api/name/bag">bag</a> by reconstructing the objects flattened with &ndash; (void)<a href="#//api/name/deflateBag">deflateBag</a>;</p><div class="note"><p><strong>Note:</strong> Check properties <a href="#//api/name/savedObjects">savedObjects</a>, <a href="#//api/name/unsavedObjects">unsavedObjects</a> and <a href="#//api/name/removedObjects">removedObjects</a> to find out the current state of the <a href="#//api/name/bag">bag</a>.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/deflateBag">&ndash; deflateBag</a> &ndash; (void)<a href="#//api/name/deflateBag">&ndash; deflateBag</a> \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/initBagWithName:andObjects:" title="initBagWithName:andObjects:"></a>
+	<h3 class="subsubtitle method-title">initBagWithName:andObjects:</h3>
+	<div class="method-subsection brief-description">
+		<p>Initializes a newly allocated <a href="#//api/name/bag">bag</a> with the specified <a href="#//api/name/name">name</a> adding to it the objects contained in the given array.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (id)initBagWithName:(NSString *)<em>theName</em> andObjects:(NSArray *)<em>someObjects</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theName</em></dt>
+			<dd><p>the <a href="#//api/name/name">name</a> of the <a href="#//api/name/bag">bag</a>. Can be nil.</p></dd>
+		</dl>
+		<dl class="argument-def parameter-def">
+			<dt><em>theObjects</em></dt>
+			<dd><p>is a required array of objects conforming to the \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>A <a href="#//api/name/bag">bag</a> only containing the objects with conform to the \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink upon success, nil otherwise.
+@throws NSFUnexpectedParameterException is thrown if theObjects is nil.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Initializes a newly allocated <a href="#//api/name/bag">bag</a> with the specified <a href="#//api/name/name">name</a> adding to it the objects contained in the given array.</p><div class="warning"><p><strong>Warning:</strong> If theObjects is nil, an NSFUnexpectedParameterException will be thrown.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/bagWithObjects:">+ bagWithObjects:</a> + (NSFNanoBag<em>)<a href="#//api/name/bagWithObjects:">+ bagWithObjects:</a>(NSArray </em>)theObjects \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/isEqualToNanoBag:" title="isEqualToNanoBag:"></a>
+	<h3 class="subsubtitle method-title">isEqualToNanoBag:</h3>
+	<div class="method-subsection brief-description">
+		<p>Compares the receiving <a href="#//api/name/bag">bag</a> to another <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (BOOL)isEqualToNanoBag:(NSFNanoBag *)<em>otherNanoBag</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>otherNanoBag</em></dt>
+			<dd><p>is a <a href="#//api/name/bag">bag</a>.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>YES if the contents of otherNanoBag are equal to the contents of the receiving <a href="#//api/name/bag">bag</a>, otherwise NO.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Compares the receiving <a href="#//api/name/bag">bag</a> to another <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/reloadBagWithError:" title="reloadBagWithError:"></a>
+	<h3 class="subsubtitle method-title">reloadBagWithError:</h3>
+	<div class="method-subsection brief-description">
+		<p>Refreshes the <a href="#//api/name/bag">bag</a> to match the contents stored in the document <a href="#//api/name/store">store</a>. The unsaved contents are preserved.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (BOOL)reloadBagWithError:(out NSError **)<em>outError</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>outError</em></dt>
+			<dd><p>is used if an error occurs. May be NULL.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>YES upon success, NO otherwise.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Refreshes the <a href="#//api/name/bag">bag</a> to match the contents stored in the document <a href="#//api/name/store">store</a>. The unsaved contents are preserved.</p><div class="note"><p><strong>Note:</strong> Check properties <a href="#//api/name/savedObjects">savedObjects</a>, <a href="#//api/name/unsavedObjects">unsavedObjects</a> and <a href="#//api/name/removedObjects">removedObjects</a> to find out the current state of the <a href="#//api/name/bag">bag</a>.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/saveAndReturnError:">&ndash; saveAndReturnError:</a> &ndash; (BOOL)<a href="#//api/name/saveAndReturnError:">&ndash; saveAndReturnError:</a>(out NSError **)outError \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/undoChangesWithError:">&ndash; undoChangesWithError:</a> &ndash; (BOOL)<a href="#//api/name/undoChangesWithError:">&ndash; undoChangesWithError:</a>(out NSError **)outError \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/removeAllObjects" title="removeAllObjects"></a>
+	<h3 class="subsubtitle method-title">removeAllObjects</h3>
+	<div class="method-subsection brief-description">
+		<p>Empties the <a href="#//api/name/bag">bag</a> of all its elements.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (void)removeAllObjects</code></div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Empties the <a href="#//api/name/bag">bag</a> of all its elements.</p>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/removeObject:">&ndash; removeObject:</a> &ndash; (void)<a href="#//api/name/removeObject:">&ndash; removeObject:</a>(id &lt;<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>>)theObject \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a>(NSArray *)theObjects \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a> &ndash; (void)<a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a>(NSString *)theObjectKey \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a>(NSArray *)theKeys \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/removeObject:" title="removeObject:"></a>
+	<h3 class="subsubtitle method-title">removeObject:</h3>
+	<div class="method-subsection brief-description">
+		<p>Removes the specified object from the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (void)removeObject:(id&lt;NSFNanoObjectProtocol&gt;)<em>theObject</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theObject</em></dt>
+			<dd><p>the object to be removed from the <a href="#//api/name/bag">bag</a>.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Removes the specified object from the <a href="#//api/name/bag">bag</a>.</p><div class="warning"><p><strong>Warning:</strong> The object must be \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a>(NSArray *)theObjects \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a> &ndash; (void)<a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a>(NSString *)theObjectKey \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a>(NSArray *)theKeys \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> &ndash; (void)<a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/removeObjectWithKey:" title="removeObjectWithKey:"></a>
+	<h3 class="subsubtitle method-title">removeObjectWithKey:</h3>
+	<div class="method-subsection brief-description">
+		<p>Removes the object with a given <a href="#//api/name/key">key</a> from the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (void)removeObjectWithKey:(NSString *)<em>theObjectKey</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theObjectKey</em></dt>
+			<dd><p>the <a href="#//api/name/key">key</a> of the object to be removed from the <a href="#//api/name/bag">bag</a>.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Removes the object with a given <a href="#//api/name/key">key</a> from the <a href="#//api/name/bag">bag</a>.</p><div class="warning"><p><strong>Warning:</strong> The object referenced by theObjectKey must be \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/removeObject:">&ndash; removeObject:</a> &ndash; (void)<a href="#//api/name/removeObject:">&ndash; removeObject:</a>(id &lt;<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>>)theObject \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a>(NSArray *)theObjects \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a>(NSArray *)theKeys \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> &ndash; (void)<a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/removeObjectsInArray:" title="removeObjectsInArray:"></a>
+	<h3 class="subsubtitle method-title">removeObjectsInArray:</h3>
+	<div class="method-subsection brief-description">
+		<p>Removes the list of objects from the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (void)removeObjectsInArray:(NSArray *)<em>theObjects</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theObjects</em></dt>
+			<dd><p>the list of objects to be removed from the <a href="#//api/name/bag">bag</a>.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Removes the list of objects from the <a href="#//api/name/bag">bag</a>.</p><div class="warning"><p><strong>Warning:</strong> The objects of the array must be \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/removeObject:">&ndash; removeObject:</a> &ndash; (void)<a href="#//api/name/removeObject:">&ndash; removeObject:</a>(id &lt;<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>>)theObject \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a> &ndash; (void)<a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a>(NSString *)theObjectKey \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsWithKeysInArray:">&ndash; removeObjectsWithKeysInArray:</a>(NSArray *)theKeys \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> &ndash; (void)<a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/removeObjectsWithKeysInArray:" title="removeObjectsWithKeysInArray:"></a>
+	<h3 class="subsubtitle method-title">removeObjectsWithKeysInArray:</h3>
+	<div class="method-subsection brief-description">
+		<p>Removes from the <a href="#//api/name/bag">bag</a> the objects specified by elements in a given array.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (void)removeObjectsWithKeysInArray:(NSArray *)<em>theKeys</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>theKeys</em></dt>
+			<dd><p>an array of objects specifying the keys to remove from the <a href="#//api/name/bag">bag</a></p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Removes from the <a href="#//api/name/bag">bag</a> the objects specified by elements in a given array.</p><div class="warning"><p><strong>Warning:</strong> The objects referenced by theKeys must be \link <a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>::initNanoObjectFromDictionaryRepresentation:forKey:store: NSFNanoObjectProtocol\endlink-compliant.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/removeObject:">&ndash; removeObject:</a> &ndash; (void)<a href="#//api/name/removeObject:">&ndash; removeObject:</a>(id &lt;<a href="../Protocols/NSFNanoObjectProtocol.html">NSFNanoObjectProtocol</a>>)theObject \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a> &ndash; (void)<a href="#//api/name/removeObjectsInArray:">&ndash; removeObjectsInArray:</a>(NSArray *)theObjects \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a> &ndash; (void)<a href="#//api/name/removeObjectWithKey:">&ndash; removeObjectWithKey:</a>(NSString *)theObjectKey \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> &ndash; (void)<a href="#//api/name/removeAllObjects">&ndash; removeAllObjects</a> \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/saveAndReturnError:" title="saveAndReturnError:"></a>
+	<h3 class="subsubtitle method-title">saveAndReturnError:</h3>
+	<div class="method-subsection brief-description">
+		<p>Saves the <a href="#//api/name/bag">bag</a> and its contents. Also, saves all the changes made since the last save.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (BOOL)saveAndReturnError:(out NSError **)<em>outError</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>outError</em></dt>
+			<dd><p>is used if an error occurs. May be NULL.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>YES upon success, NO otherwise.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Saves the <a href="#//api/name/bag">bag</a> and its contents. Also, saves all the changes made since the last save.</p><div class="note"><p><strong>Note:</strong> Check property <a href="#//api/name/hasUnsavedChanges">hasUnsavedChanges</a> to find out whether the <a href="#//api/name/bag">bag</a> has unsaved contents.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/reloadBagWithError:">&ndash; reloadBagWithError:</a> &ndash; (BOOL)<a href="#//api/name/reloadBagWithError:">&ndash; reloadBagWithError:</a>(out NSError **)outError \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/undoChangesWithError:">&ndash; undoChangesWithError:</a> &ndash; (BOOL)<a href="#//api/name/undoChangesWithError:">&ndash; undoChangesWithError:</a>(out NSError **)outError \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+						<div class="section-method">
+	<a name="//api/name/undoChangesWithError:" title="undoChangesWithError:"></a>
+	<h3 class="subsubtitle method-title">undoChangesWithError:</h3>
+	<div class="method-subsection brief-description">
+		<p>Discards the changes made in the <a href="#//api/name/bag">bag</a>.</p>
+	</div>
+	<div class="method-subsection method-declaration"><code>- (BOOL)undoChangesWithError:(out NSError **)<em>outError</em></code></div>
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+		<dl class="argument-def parameter-def">
+			<dt><em>outError</em></dt>
+			<dd><p>is used if an error occurs. May be NULL.</p></dd>
+		</dl>
+	</div>
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>YES upon success, NO otherwise.</p>
+	</div>
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Discards the changes made in the <a href="#//api/name/bag">bag</a>.</p><div class="note"><p><strong>Note:</strong> Check properties <a href="#//api/name/savedObjects">savedObjects</a>, <a href="#//api/name/unsavedObjects">unsavedObjects</a> and <a href="#//api/name/removedObjects">removedObjects</a> to find out the current state of the <a href="#//api/name/bag">bag</a>.</p></div>
+	</div>
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+			<li><code><p>\link <a href="#//api/name/saveAndReturnError:">&ndash; saveAndReturnError:</a> &ndash; (BOOL)<a href="#//api/name/saveAndReturnError:">&ndash; saveAndReturnError:</a>(out NSError **)outError \endlink</p></code></li>
+			<li><code><p>\link <a href="#//api/name/reloadBagWithError:">&ndash; reloadBagWithError:</a> &ndash; (BOOL)<a href="#//api/name/reloadBagWithError:">&ndash; reloadBagWithError:</a>(out NSError **)outError \endlink</p></code></li>
+		</ul>
+	</div>
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">NSFNanoBag.h</code><br />
+	</div>
+</div>
+					</div>
+				</div>
+				<div class="main-navigation navigation-bottom">
+					<ul>
+	<li><a href="../index.html">Index</a></li>
+	<li><a href="../hierarchy.html">Hierarchy</a></li>
+</ul>
+				</div>
+				<div id="footer">
+					<hr />
+					<div class="footer-copyright">
+						<p><span class="copyright">&copy; 2013 Tito Ciuro. All rights reserved. (Last updated: 2013-01-22)</span><br />
+						<span class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.0.5 (build 789)</a>.</span></p>
+					</div>
+				</div>
+			</div>
+		</article>
+		<script type="text/javascript">
+			function jumpToChange()
+			{
+				window.location.hash = this.options[this.selectedIndex].value;
+			}
+			function toggleTOC()
+			{
+				var contents = document.getElementById('contents');
+				var tocContainer = document.getElementById('tocContainer');
+				if (this.getAttribute('class') == 'open')
+				{
+					this.setAttribute('class', '');
+					contents.setAttribute('class', '');
+					tocContainer.setAttribute('class', '');
+					window.name = "hideTOC";
+				}
+				else
+				{
+					this.setAttribute('class', 'open');
+					contents.setAttribute('class', 'isShowingTOC');
+					tocContainer.setAttribute('class', 'isShowingTOC');
+					window.name = "";
+				}
+				return false;
+			}
+			function toggleTOCEntryChildren(e)
+			{
+				e.stopPropagation();
+				var currentClass = this.getAttribute('class');
+				if (currentClass == 'children') {
+					this.setAttribute('class', 'children open');
+				}
+				else if (currentClass == 'children open') {
+					this.setAttribute('class', 'children');
+				}
+				return false;
+			}
+			function tocEntryClick(e)
+			{
+				e.stopPropagation();
+				return true;
+			}
+			function init()
+			{
+				var selectElement = document.getElementById('jumpTo');
+				selectElement.addEventListener('change', jumpToChange, false);
+				var tocButton = document.getElementById('table_of_contents');
+				tocButton.addEventListener('click', toggleTOC, false);
+				var taskTreeItem = document.getElementById('task_treeitem');
+				if (taskTreeItem.getElementsByTagName('li').length > 0)
+				{
+					taskTreeItem.setAttribute('class', 'children');
+					taskTreeItem.firstChild.setAttribute('class', 'disclosure');
+				}
+				var tocList = document.getElementById('toc');
+				var tocEntries = tocList.getElementsByTagName('li');
+				for (var i = 0; i < tocEntries.length; i++) {
+					tocEntries[i].addEventListener('click', toggleTOCEntryChildren, false);
+				}
+				var tocLinks = tocList.getElementsByTagName('a');
+				for (var i = 0; i < tocLinks.length; i++) {
+					tocLinks[i].addEventListener('click', tocEntryClick, false);
+				}
+				if (window.name == "hideTOC") {
+					toggleTOC.call(tocButton);
+				}
+			}
+			window.onload = init;
+			// If showing in Xcode, hide the TOC and Header
+			if (navigator.userAgent.match(/xcode/i)) {
+				document.getElementById("contents").className = "hideInXcode"
+				document.getElementById("tocContainer").className = "hideInXcode"
+				document.getElementById("top_header").className = "hideInXcode"
+			}
+		</script>
+	</body>
+</html>