From 4579b0013e17e70fb66f34bc53fc2b617780276d Mon Sep 17 00:00:00 2001
From: jeffail <ash@jeffs.eu>
Date: Sun, 19 Jul 2015 19:15:32 +0000
Subject: [PATCH] Update README

---
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/README.md b/README.md
index 61a19d5..a204099 100644
--- a/README.md
+++ b/README.md
@@ -46,6 +46,22 @@ value, ok = jsonParsed.Path("does.not.exist").Data().(float64)
 ...
 ```
 
+###Iterating objects
+
+```go
+...
+
+jsonParsed, _ := gabs.ParseJSON([]byte(`{"object":{ "first": 1, "second": 2, "third": 3 }}`))
+
+// S is shorthand for Search
+children, _ := jsonParsed.S("object").ChildrenMap()
+for key, child := range children {
+	fmt.Printf("key: %v, value: %v\n", key, child.Data().(string))
+}
+
+...
+```
+
 ###Iterating arrays
 
 ```go
@@ -165,6 +181,37 @@ Will print:
 {"foo":{"array":[10,20,30]}}
 ```
 
+Working with arrays by index:
+
+```go
+...
+
+jsonObj := gabs.New()
+
+// Create an array with the length of 3
+jsonObj.ArrayOfSize(3, "foo")
+
+jsonObj.S("foo").SetIndex("test1", 0)
+jsonObj.S("foo").SetIndex("test2", 1)
+
+// Create an embedded array with the length of 3
+jsonObj.S("foo").ArrayOfSizeI(3, 2)
+
+jsonObj.S("foo").Index(2).SetIndex(1, 0)
+jsonObj.S("foo").Index(2).SetIndex(2, 1)
+jsonObj.S("foo").Index(2).SetIndex(3, 2)
+
+fmt.Println(jsonObj.String())
+
+...
+```
+
+Will print:
+
+```
+{"foo":["test1","test2",[1,2,3]]}
+```
+
 ###Converting back to JSON
 
 This is the easiest part: