From be9325ffc9a18d945b91a7d90a1d49df92dcfc0d Mon Sep 17 00:00:00 2001
From: Ben Ramsey <ben@benramsey.com>
Date: Sun, 20 Jan 2013 11:07:25 -0600
Subject: [PATCH] Updated example in README to show usage of try/catch for
 dependencies

---
 README.md | 39 ++++++++++++++++++++++++++-------------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 319b53a..a55b955 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@ library are recommended. However, this library is designed to work on 32-bit
 builds of PHP without Moontoast\Math, with some degraded functionality. Please
 check the API documention for more information.
 
-If a particular requirement is not present, then a `[\Rhumsaa\Uuid\Exception\UnsatisfiedDependencyException][]`
+If a particular requirement is not present, then a `Rhumsaa\Uuid\Exception\UnsatisfiedDependencyException`
 is thrown, allowing one to catch a bad call in an environment where the call is
 not supported and gracefully degrade.
 
@@ -26,23 +26,36 @@ not supported and gracefully degrade.
 
 ```php
 <?php
+require 'vendor/autoload.php';
+
 use Rhumsaa\Uuid\Uuid;
+use Rhumsaa\Uuid\Exception\UnsatisfiedDependencyException;
 
-// Generate a version 1 (time-based) UUID
-$uuid1 = Uuid::uuid1();
-echo $uuid1 . "\n"; // e4eaaaf2-d142-11e1-b3e4-080027620cdd
+try {
 
-// Generate a version 3 (name-based and hashed with MD5) UUID
-$uuid3 = Uuid::uuid3(Uuid::NAMESPACE_DNS, 'php.net');
-echo $uuid3 . "\n"; // 11a38b9a-b3da-360f-9353-a5a725514269
+    // Generate a version 1 (time-based) UUID
+    $uuid1 = Uuid::uuid1();
+    echo $uuid1 . "\n"; // e4eaaaf2-d142-11e1-b3e4-080027620cdd
 
-// Generate a version 4 (random) UUID
-$uuid4 = Uuid::uuid4();
-echo $uuid4 . "\n"; // 25769c6c-d34d-4bfe-ba98-e0ee856f3e7a
+    // Generate a version 3 (name-based and hashed with MD5) UUID
+    $uuid3 = Uuid::uuid3(Uuid::NAMESPACE_DNS, 'php.net');
+    echo $uuid3 . "\n"; // 11a38b9a-b3da-360f-9353-a5a725514269
 
-// Generate a version 5 (name-based and hashed with SHA1) UUID
-$uuid5 = Uuid::uuid5(Uuid::NAMESPACE_DNS, 'php.net');
-echo $uuid5 . "\n"; // c4a760a8-dbcf-5254-a0d9-6a4474bd1b62
+    // Generate a version 4 (random) UUID
+    $uuid4 = Uuid::uuid4();
+    echo $uuid4 . "\n"; // 25769c6c-d34d-4bfe-ba98-e0ee856f3e7a
+
+    // Generate a version 5 (name-based and hashed with SHA1) UUID
+    $uuid5 = Uuid::uuid5(Uuid::NAMESPACE_DNS, 'php.net');
+    echo $uuid5 . "\n"; // c4a760a8-dbcf-5254-a0d9-6a4474bd1b62
+
+} catch (UnsatisfiedDependencyException $e) {
+
+    // Some dependency was not met. Either the method cannot be called on a
+    // 32-bit system, or it can, but it relies on Moontoast\Math to be present.
+    echo 'Caught exception: ' . $e->getMessage() . "\n";
+
+}
 ```
 
 ## Installation