<h2>File Contents: //opt/cloudlinux/alt-php70/root/usr/share/pear/File/MARC/List.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='//opt/cloudlinux/alt-php70/root/usr/share/pear/File/MARC/List.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

/* vim: set expandtab shiftwidth=4 tabstop=4 softtabstop=4 foldmethod=marker: */

/**
 * Parser for MARC records
 *
 * This package is based on the PHP MARC package, originally called &quot;php-marc&quot;,
 * that is part of the Emilda Project (http://www.emilda.org). Christoffer
 * Landtman generously agreed to make the &quot;php-marc&quot; code available under the
 * GNU LGPL so it could be used as the basis of this PEAR package.
 *
 * PHP version 5
 *
 * LICENSE: This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 2.1 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * @category  File_Formats
 * @package   File_MARC
 * @author    Christoffer Landtman &lt;landtman@realnode.com&gt;
 * @author    Dan Scott &lt;dscott@laurentian.ca&gt;
 * @copyright 2003-2008 Oy Realnode Ab, Dan Scott
 * @license   http://www.gnu.org/copyleft/lesser.html  LGPL License 2.1
 * @version   CVS: $Id$
 * @link      http://pear.php.net/package/File_MARC
 */

// {{{ class File_MARC_List extends SplDoublyLinkedList
/**
 * The File_MARC_List class extends the SplDoublyLinkedList class
 * to override the key() method in a meaningful way for foreach() iterators.
 *
 * For the list of {@link File_MARC_Field} objects in a {@link File_MARC_Record}
 * object, the key() method returns the tag name of the field.
 *
 * For the list of {@link File_MARC_Subfield} objects in a {@link
 * File_MARC_Data_Field} object, the key() method returns the code of
 * the subfield.
 *
 * &lt;code&gt;
 * // Iterate through the fields in a record with key=&gt;value iteration
 * foreach ($record-&gt;getFields() as $tag=&gt;$value) {
 *     print &quot;$tag: &quot;;
 *     if ($value instanceof File_MARC_Control_Field) {
 *         print $value-&gt;getData();
 *     }
 *     else {
 *         // Iterate through the subfields in this data field
 *         foreach ($value-&gt;getSubfields() as $code=&gt;$subdata) {
 *             print &quot;_$code&quot;;
 *         }
 *     }
 *     print &quot;\n&quot;;
 * }
 * &lt;/code&gt;
 *
 * @category File_Formats
 * @package  File_MARC
 * @author   Dan Scott &lt;dscott@laurentian.ca&gt;
 * @license  http://www.gnu.org/copyleft/lesser.html  LGPL License 2.1
 * @link     http://pear.php.net/package/File_MARC
 */
class File_MARC_List extends SplDoublyLinkedList
{

    // {{{ properties
    /**
     * Position of the subfield
     * @var int
     */
    protected $position;

    // }}}

    // {{{ key()
    /**
     * Returns the tag for a {@link File_MARC_Field} object, or the code
     * for a {@link File_MARC_Subfield} object.
     *
     * This method enables you to use a foreach iterator to retrieve
     * the tag or code as the key for the iterator.
     *
     * @return string returns the tag or code
     */
    function key()
    {
        if ($this-&gt;current() instanceof File_MARC_Field) {
            return $this-&gt;current()-&gt;getTag();
        } elseif ($this-&gt;current() instanceof File_MARC_Subfield) {
            return $this-&gt;current()-&gt;getCode();
        }
        return false;
    }
    // }}}

    // {{{ function insertNode()
    /**
     * Inserts a node into the linked list, based on a reference node that
     * already exists in the list.
     *
     * @param mixed $new_node      New node to add to the list
     * @param mixed $existing_node Reference position node
     * @param bool  $before        Insert new node before or after the existing node
     *
     * @return bool Success or failure
     **/
    public function insertNode($new_node, $existing_node, $before = false)
    {
        $pos = 0;
        $exist_pos = $existing_node-&gt;getPosition();
        $this-&gt;rewind();

        // Now add the node according to the requested mode
        switch ($before) {

        case true:
            $this-&gt;add($exist_pos, $new_node);
            break;

        // after
        case false:
            if ($this-&gt;offsetExists($exist_pos + 1)) {
                $this-&gt;add($exist_pos + 1, $new_node);
            } else {
                $this-&gt;appendNode($new_node);
                return true;
            }
            break;
        }

        // Fix positions
        $this-&gt;rewind();
        while ($n = $this-&gt;current()) {
            $n-&gt;setPosition($pos);
            $this-&gt;next();
            $pos++;
        }

        return true;
    }
    // }}}

    // {{{ function appendNode()
    /**
     * Adds a node onto the linked list.
     *
     * @param mixed $new_node New node to add to the list
     *
     * @return void
     **/
    public function appendNode($new_node)
    {
        $pos = $this-&gt;count();
        $new_node-&gt;setPosition($pos);
        $this-&gt;push($new_node);
    }
    // }}}

    // {{{ function prependNode()
    /**
     * Adds a node to the start of the linked list.
     *
     * @param mixed $new_node New node to add to the list
     *
     * @return void
     **/
    public function prependNode($new_node)
    {
        $this-&gt;insertNode($new_node, $this-&gt;bottom(), true);
    }
    // }}}

    // {{{ function deleteNode()
    /**
     * Deletes a node from the linked list.
     *
     * @param mixed $node Node to delete from the list
     *
     * @return void
     **/
    public function deleteNode($node)
    {
        $target_pos = $node-&gt;getPosition();
        $this-&gt;rewind();
        $pos = 0;

        // Omit target node and adjust pos of remainder
        $done = false;
        try {
            while ($n = $this-&gt;current()) {
                if ($pos == $target_pos &amp;&amp; !$done) {
                    $done = true;
                    $this-&gt;next();
                    $this-&gt;offsetUnset($pos);
                } elseif ($pos &gt;= $target_pos) {
                    $n-&gt;setPosition($pos);
                    $pos++;
                    $this-&gt;next();
                } else {
                    $pos++;
                    $this-&gt;next();
                }
            }
        }
        catch (Exception $e) {
            // no-op - shift() throws an exception, sigh
        }

    }
    // }}}

    // {{{ setPosition()
    /**
     * Sets position of the subfield
     *
     * @param string $pos new position of the subfield
     *
     * @return void
     */
    function setPosition($pos)
    {
        $this-&gt;position = $pos;
    }
    // }}}

    // {{{ getPosition()
    /**
     * Return position of the subfield
     *
     * @return int data
     */
    function getPosition()
    {
        return $this-&gt;position;
    }
    // }}}

}
// }}}

</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2F%2Fopt%2Fcloudlinux%2Falt-php70%2Froot%2Fusr%2Fshare%2Fpear%2FFile%2FMARC'>⬅ Back to Directory</a>