Extract method Collection::first()

Author: danmichaelo

src/Collection.php

@@ -3,6 +3,7 @@
 namespace Scriptotek\Marc;
 
 use File_MARC_Record;
+use Scriptotek\Marc\Exceptions\RecordNotFound;
 use Scriptotek\Marc\Exceptions\UnknownRecordType;
 use Scriptotek\Marc\Importers\Importer;
 
@@ -99,6 +100,21 @@ public function toArray()
         return iterator_to_array($this);
     }
 
+    /**
+     * Return the first record in the collection.
+     *
+     * @return BibliographicRecord|HoldingsRecord|AuthorityRecord
+     * @throws RecordNotFound if the collection is empty
+     */
+    public function first()
+    {
+        $this->rewind();
+        if (is_null($this->current())) {
+            throw new RecordNotFound();
+        }
+        return $this->current();
+    }
+
     /**
      * Creates a Record object from a File_MARC_Record object.
      *

src/Record.php

@@ -130,13 +130,7 @@ public function getFields($spec = null, $pcre = null)
      */
     public static function fromFile($filename)
     {
-        $records = Collection::fromFile($filename)->toArray();
-
-        if (!count($records)) {
-            throw new RecordNotFound();
-        }
-
-        return $records[0];
+        return Collection::fromFile($filename)->first();
     }
 
     /**
@@ -151,13 +145,7 @@ public static function fromFile($filename)
      */
     public static function fromString($data)
     {
-        $records = Collection::fromString($data)->toArray();
-
-        if (!count($records)) {
-            throw new RecordNotFound();
-        }
-
-        return $records[0];
+        return Collection::fromString($data)->first();
     }
 
     /*************************************************************************