Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified	Actions
📁 ..	-	2025-05-25 12:37
📄 Control_Field.php <?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 "php-marc", * that is part of the Emilda Project (http://www.emilda.org). Christoffer * Landtman generously agreed to make the "php-marc" 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 <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @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_Control_Field extends File_MARC_Field /* * The File_MARC_Control_Field class represents a single control field * in a MARC record. * * A MARC control field consists of a tag name and control data. * * @category File_Formats * @package File_MARC * @author Christoffer Landtman <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @link http://pear.php.net/package/File_MARC / class File_MARC_Control_Field extends File_MARC_Field { // {{{ Properties /* * Value of field, if field is a Control field * @var string / protected $data; // }}} // {{{ Constructor: function __construct() /* * Field init function * * Create a new {@link File_MARC_Control_Field} object from passed arguments * * @param string $tag tag * @param string $data control field data * @param string $ind1 placeholder for class strictness * @param string $ind2 placeholder for class strictness / function __construct($tag, $data, $ind1 = null, $ind2 = null) { $this->data = $data; parent::__construct($tag); } // }}} // {{{ Destructor: function __destruct() /* * Destroys the control field / function __destruct() { $this->data = null; parent::__destruct(); } // }}} // {{{ Explicit destructor: function delete() /* * Destroys the control field * * @return true / function delete() { $this->__destruct(); } // }}} // {{{ getData() /* * Get control field data * * @return string returns data in control field / function getData() { return (string)$this->data; } // }}} // {{{ isEmpty() /* * Is empty * * Checks if the field contains data * * @return bool Returns true if the field is empty, otherwise false / function isEmpty() { return ($this->data) ? false : true; } // }}} // {{{ setData() /* * Set control field data * * @param string $data data for the control field * * @return bool returns the new data in the control field / function setData($data) { $this->data = $data; return $this->getData(); } // }}} // {{{ __toString() /* * Return as a formatted string * * Return the control field as a formatted string for pretty printing * * @return string Formatted output of control Field / function __toString() { return sprintf("%3s %s", $this->tag, $this->data); } // }}} // {{{ toRaw() /* * Return as raw MARC * * Return the control field formatted in Raw MARC for saving into MARC files * * @return string Raw MARC */ function toRaw() { return (string)$this->data.File_MARC::END_OF_FIELD; } // }}} } // }}}	4.52 KB	2024-07-17 10:10
📄 Data_Field.php <?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 "php-marc", * that is part of the Emilda Project (http://www.emilda.org). Christoffer * Landtman generously agreed to make the "php-marc" 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 <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @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_Data_Field extends File_MARC_Field /* * The File_MARC_Data_Field class represents a single field in a MARC record. * * A MARC data field consists of a tag name, two indicators which may be null, * and zero or more subfields represented by {@link File_MARC_Subfield} objects. * Subfields are held within a linked list structure. * * @category File_Formats * @package File_MARC * @author Christoffer Landtman <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @link http://pear.php.net/package/File_MARC / class File_MARC_Data_Field extends File_MARC_Field { // {{{ properties /* * Value of the first indicator * @var string / protected $ind1; /* * Value of the second indicator * @var string / protected $ind2; /* * Linked list of subfields * @var File_MARC_List / protected $subfields; // }}} // {{{ Constructor: function __construct() /* * {@link File_MARC_Data_Field} constructor * * Create a new {@link File_MARC_Data_Field} object. The only required * parameter is a tag. This enables programs to build up new fields * programmatically. * * <code> * // Example: Create a new data field * * // We can optionally create an array of subfields first * $subfields[] = new File_MARC_Subfield('a', 'Scott, Daniel.'); * * // Create the new 100 field complete with a _a subfield and an indicator * $new_field = new File_MARC_Data_Field('100', $subfields, 0, null); * </code> * * @param string $tag tag * @param array $subfields array of {@link File_MARC_Subfield} objects * @param string $ind1 first indicator * @param string $ind2 second indicator / function __construct($tag, array $subfields = null, $ind1 = null, $ind2 = null) { $this->subfields = new File_MARC_List(); parent::__construct($tag); $this->ind1 = $this->_validateIndicator($ind1); $this->ind2 = $this->_validateIndicator($ind2); // we'll let users add subfields after if they so desire if ($subfields) { $this->addSubfields($subfields); } } // }}} // {{{ Destructor: function __destruct() /* * Destroys the data field / function __destruct() { $this->subfields = null; $this->ind1 = null; $this->ind2 = null; parent::__destruct(); } // }}} // {{{ Explicit destructor: function delete() /* * Destroys the data field * * @return true / function delete() { $this->__destruct(); } // }}} // {{{ protected function _validateIndicator() /* * Validates an indicator field * * Validates the value passed in for an indicator. This routine ensures * that an indicator is a single character. If the indicator value is null, * then this method returns a single character. * * If the indicator value contains more than a single character, this * throws an exception. * * @param string $indicator Value of the indicator to be validated * * @return string Returns the indicator, or space if the indicator was null / private function _validateIndicator($indicator) { if ($indicator == null) { $indicator = ' '; } elseif (strlen($indicator) > 1) { $errorMessage = File_MARC_Exception::formatError(File_MARC_Exception::$messages[File_MARC_Exception::ERROR_INVALID_INDICATOR], array("tag" => $this->getTag(), "indicator" => $indicator)); throw new File_MARC_Exception($errorMessage, File_MARC_Exception::ERROR_INVALID_INDICATOR); } return $indicator; } // }}} // {{{ appendSubfield() /* * Appends subfield to subfield list * * Adds a File_MARC_Subfield object to the end of the existing list * of subfields. * * @param File_MARC_Subfield $new_subfield The subfield to add * * @return File_MARC_Subfield the new File_MARC_Subfield object / function appendSubfield(File_MARC_Subfield $new_subfield) { / Append as the last field in the record / $this->subfields->appendNode($new_subfield); return $new_subfield; } // }}} // {{{ prependSubfield() /* * Prepends subfield to subfield liss * * Adds a File_MARC_Subfield object to the start of the existing list * of subfields. * * @param File_MARC_Subfield $new_subfield The subfield to add * * @return File_MARC_Subfield the new File_MARC_Subfield object / function prependSubfield(File_MARC_Subfield $new_subfield) { $this->subfields->prependNode($new_subfield); return $new_subfield; } // }}} // {{{ insertSubfield() /* * Inserts a field in the MARC record relative to an existing field * * Inserts a {@link File_MARC_Subfield} object before or after an existing * subfield. * * @param File_MARC_Subfield $new_field The subfield to add * @param File_MARC_Subfield $existing_field The target subfield * @param bool $before Insert the subfield before the existing subfield if true; after the existing subfield if false * * @return File_MARC_Subfield The new subfield / function insertSubfield(File_MARC_Subfield $new_field, File_MARC_Subfield $existing_field, $before = false) { switch ($before) { / Insert before the specified subfield in the record / case true: $this->subfields->insertNode($new_field, $existing_field, true); break; / Insert after the specified subfield in the record / case false: $this->subfields->insertNode($new_field, $existing_field); break; default: $errorMessage = File_MARC_Exception::formatError(File_MARC_Exception::$messages[File_MARC_Exception::ERROR_INSERTSUBFIELD_MODE], array("mode" => $mode)); throw new File_MARC_Exception($errorMessage, File_MARC_Exception::ERROR_INSERTSUBFIELD_MODE); return false; } return $new_field; } // }}} // {{{ addSubfields() /* * Adds an array of subfields to a {@link File_MARC_Data_Field} object * * Appends subfields to existing subfields in the order in which * they appear in the array. For finer grained control of the subfield * order, use {@link appendSubfield()}, {@link prependSubfield()}, * or {@link insertSubfield()} to add each subfield individually. * * @param array $subfields array of {@link File_MARC_Subfield} objects * * @return int returns the number of subfields that were added / function addSubfields(array $subfields) { / * Just in case someone passes in a single File_MARC_Subfield * instead of an array / if ($subfields instanceof File_MARC_Subfield) { $this->appendSubfield($subfields); return 1; } // Add subfields $cnt = 0; foreach ($subfields as $subfield) { $this->appendSubfield($subfield); $cnt++; } return $cnt; } // }}} // {{{ deleteSubfield() /* * Delete a subfield from the field. * * @param File_MARC_Subfield $subfield The subfield to delete * * @return bool Success or failure / function deleteSubfield(File_MARC_Subfield $subfield) { if ($this->subfields->deleteNode($subfield)) { return true; } return false; } // }}} // {{{ getIndicator() /* * Get the value of an indicator * * @param int $ind number of the indicator (1 or 2) * * @return string returns indicator value if it exists, otherwise false / function getIndicator($ind) { if ($ind == 1) { return (string)$this->ind1; } elseif ($ind == 2) { return (string)$this->ind2; } else { $errorMessage = File_MARC_Exception::formatError(File_MARC_Exception::$messages[File_MARC_Exception::ERROR_INVALID_INDICATOR_REQUEST], array("indicator" => $indicator)); throw new File_MARC_Exception($errorMessage, File_MARC_Exception::ERROR_INVALID_INDICATOR_REQUEST); } return false; } // }}} // {{{ setIndicator() /* * Set the value of an indicator * * @param int $ind number of the indicator (1 or 2) * @param string $value value of the indicator * * @return string returns indicator value if it exists, otherwise false / function setIndicator($ind, $value) { switch ($ind) { case 1: $this->ind1 = $this->_validateIndicator($value); break; case 2: $this->ind2 = $this->_validateIndicator($value); break; default: $errorMessage = File_MARC_Exception::formatError(File_MARC_Exception::$messages[File_MARC_Exception::ERROR_INVALID_INDICATOR_REQUEST], array("indicator" => $ind)); throw new File_MARC_Exception($errorMessage, File_MARC_Exception::ERROR_INVALID_INDICATOR_REQUEST); return false; } return $this->getIndicator($ind); } // }}} // {{{ getSubfield() /* * Returns the first subfield that matches a requested code. * * @param string $code subfield code for which the * {@link File_MARC_Subfield} is retrieved * * @return File_MARC_Subfield returns the first subfield that matches * $code, or false if no codes match $code / function getSubfield($code = null) { // iterate merrily through the subfields looking for the requested code foreach ($this->subfields as $sf) { if ($sf->getCode() == $code) { return $sf; } } // No matches were found return false; } // }}} // {{{ getSubfields() /* * Returns an array of subfields that match a requested code, * or a {@link File_MARC_List} that contains all of the subfields * if the requested code is null. * * @param string $code subfield code for which the * {@link File_MARC_Subfield} is retrieved * * @return File_MARC_List\|array returns a linked list of all subfields * if $code is null, an array of {@link File_MARC_Subfield} objects if * one or more subfields match, or false if no codes match $code / function getSubfields($code = null) { $results = array(); // return all subfields if no specific subfields were requested if ($code === null) { $results = $this->subfields; return $results; } // iterate merrily through the subfields looking for the requested code foreach ($this->subfields as $sf) { if ($sf->getCode() == $code) { $results[] = $sf; } } return $results; } // }}} // {{{ isEmpty() /* * Checks if the field is empty. * * Checks if the field is empty. If the field has at least one subfield * with data, it is not empty. * * @return bool Returns true if the field is empty, otherwise false / function isEmpty() { // If $this->subfields is null, we must have deleted it if (!$this->subfields) { return true; } // Iterate through the subfields looking for some data foreach ($this->subfields as $subfield) { // Check if subfield has data if (!$subfield->isEmpty()) { return false; } } // It is empty return true; } // }}} /* * ========== OUTPUT METHODS ========== / // {{{ __toString() /* * Return Field formatted * * Return Field as a formatted string. * * @return string Formatted output of Field / function __toString() { // Variables $lines = array(); // Process tag and indicators $pre = sprintf("%3s %1s%1s", $this->tag, $this->ind1, $this->ind2); // Process subfields foreach ($this->subfields as $subfield) { $lines[] = sprintf("%6s _%1s%s", $pre, $subfield->getCode(), $subfield->getData()); $pre = ""; } return join("\n", $lines); } // }}} // {{{ toRaw() /* * Return Field in Raw MARC * * Return the Field formatted in Raw MARC for saving into MARC files * * @return string Raw MARC */ function toRaw() { $subfields = array(); foreach ($this->subfields as $subfield) { if (!$subfield->isEmpty()) { $subfields[] = $subfield->toRaw(); } } return (string)$this->ind1.$this->ind2.implode("", $subfields).File_MARC::END_OF_FIELD; } // }}} } // }}}	14.6 KB	2024-07-17 10:10
📄 Exception.php <?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 "php-marc", * that is part of the Emilda Project (http://www.emilda.org). Christoffer * Landtman generously agreed to make the "php-marc" 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 <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @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_Exception extends PEAR_Exception /* * The File_MARC_Exception class enables error-handling * for the File_MARC package. * * @category File_Formats * @package File_MARC * @author Dan Scott <dscott@laurentian.ca> * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @link http://pear.php.net/package/File_MARC / class File_MARC_Exception extends PEAR_Exception { // {{{ Error codes /* * File could not be opened / const ERROR_INVALID_FILE = -1; /* * User passed an unknown SOURCE_ constant / const ERROR_INVALID_SOURCE = -2; /* * MARC record ended with an invalid terminator / const ERROR_INVALID_TERMINATOR = -3; /* * No directory was found for the MARC record / const ERROR_NO_DIRECTORY = -4; /* * An entry in the MARC directory was not 12 bytes / const ERROR_INVALID_DIRECTORY_LENGTH = -5; /* * An entry in the MARC directory specified an invalid tag / const ERROR_INVALID_DIRECTORY_TAG = -6; /* * An entry in the MARC directory specified an invalid tag length / const ERROR_INVALID_DIRECTORY_TAG_LENGTH = -7; /* * An entry in the MARC directory specified an invalid field offset / const ERROR_INVALID_DIRECTORY_OFFSET = -8; /* * An entry in the MARC directory runs past the end of the record / const ERROR_INVALID_DIRECTORY = -9; /* * A field does not end with the expected end-of-field character / const ERROR_FIELD_EOF = -10; /* * A field has invalid indicators / const ERROR_INVALID_INDICATORS = -11; /* * A subfield is defined, but has no data / const ERROR_EMPTY_SUBFIELD = -12; /* * An indicator other than 1 or 2 was requested / const ERROR_INVALID_INDICATOR_REQUEST = -13; /* * An invalid mode for adding a field was specified / const ERROR_INSERTFIELD_MODE = -14; /* * An invalid object was passed instead of a File_MARC_Field object / const ERROR_INVALID_FIELD = -15; /* * An invalid object was passed instead of a File_MARC_Subfield object / const ERROR_INVALID_SUBFIELD = -16; /* * An invalid mode for adding a subfield was specified / const ERROR_INSERTSUBFIELD_MODE = -17; /* * The length in the MARC leader does not match the actual record length / const ERROR_INCORRECT_LENGTH = -18; /* * The length field in the leader was less than five characters long / const ERROR_MISSING_LENGTH = -19; /* * A five-digit length could not be found in the MARC leader / const ERROR_NONNUMERIC_LENGTH = -20; /* * Tag does not adhere to MARC standards / const ERROR_INVALID_TAG = -21; /* * A field has invalid indicators / const ERROR_INVALID_INDICATOR = -22; // }}} // {{{ error messages public static $messages = array( self::ERROR_EMPTY_SUBFIELD => 'No subfield data found in tag "%tag%"', self::ERROR_FIELD_EOF => 'Field for tag "%tag%" does not end with an end of field character', self::ERROR_INCORRECT_LENGTH => 'Invalid record length: Leader says "%record_length%" bytes; actual record length is "%actual%"', self::ERROR_INSERTFIELD_MODE => 'insertField() mode "%mode%" was not recognized', self::ERROR_INSERTSUBFIELD_MODE => 'insertSubfield() mode "%mode%" was not recognized', self::ERROR_INVALID_DIRECTORY => 'Directory entry for tag "%tag%" runs past the end of the record', self::ERROR_INVALID_DIRECTORY_LENGTH => 'Invalid directory length', self::ERROR_INVALID_DIRECTORY_OFFSET => 'Invalid offset "%offset%" for tag "%tag%" in directory', self::ERROR_INVALID_DIRECTORY_TAG => 'Invalid tag "%tag%" in directory', self::ERROR_INVALID_DIRECTORY_TAG_LENGTH => 'Invalid length "%len%" in directory for tag "%tag%"', self::ERROR_INVALID_FIELD => 'Specified field must be a File_MARC_Data_Field or File_MARC_Control_Field object, but was "%field%"', self::ERROR_INVALID_FILE => 'Invalid input file "%filename%"', self::ERROR_INVALID_INDICATOR_REQUEST => 'Attempt to access indicator "%indicator%" failed; 1 and 2 are the only valid indicators', self::ERROR_INVALID_INDICATORS => 'Invalid indicators "%indicators%" forced to blanks for tag "%tag%"', self::ERROR_INVALID_SOURCE => "Invalid source for MARC records", self::ERROR_INVALID_SUBFIELD => 'Specified field must be a File_MARC_Subfield object, but was "%class%"', self::ERROR_INVALID_TAG => 'Tag "%tag%" is not a valid tag.', self::ERROR_INVALID_TERMINATOR => 'Invalid record terminator', self::ERROR_MISSING_LENGTH => "Couldn't find record length", self::ERROR_NO_DIRECTORY => 'No directory found', self::ERROR_NONNUMERIC_LENGTH => 'Record length "%record_length%" is not numeric', self::ERROR_INVALID_INDICATOR => 'Illegal indicator "%indicator%" in field "%tag%" forced to blank', ); // }}} // {{{ formatError() /* * Replaces placeholder tokens in an error message with actual values. * * This method enables you to internationalize the messages for the * File_MARC class by simply replacing the File_MARC_Exception::$messages * array with translated values for the messages. * * @param string $message Error message containing placeholders * @param array $errorValues Actual values to substitute for placeholders * * @return string Formatted message */ public static function formatError($message, $errorValues) { foreach ($errorValues as $token => $value) { $message = preg_replace("/\%$token\%/", $value, $message); } return $message; } // }}} } // }}}	7.38 KB	2024-07-17 10:10
📄 Field.php <?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 "php-marc", * that is part of the Emilda Project (http://www.emilda.org). Christoffer * Landtman generously agreed to make the "php-marc" 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 <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @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_Field extends Structures_LinkedList_DoubleNode /* * The File_MARC_Field class is expected to be extended to reflect the * requirements of control and data fields. * * Every MARC field contains a tag name. * * @category File_Formats * @package File_MARC * @author Christoffer Landtman <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @link http://pear.php.net/package/File_MARC / class File_MARC_Field extends Structures_LinkedList_DoubleNode { // {{{ properties /* * The tag name of the Field * @var string / protected $tag; // }}} // {{{ Constructor: function __construct() /* * File_MARC_Field constructor * * Create a new {@link File_MARC_Field} object from passed arguments. We * define placeholders for the arguments required by child classes. * * @param string $tag tag * @param string $subfields placeholder for subfields or control data * @param string $ind1 placeholder for first indicator * @param string $ind2 placeholder for second indicator / function __construct($tag, $subfields = null, $ind1 = null, $ind2 = null) { $this->tag = $tag; // Check if valid tag if (!preg_match("/^[0-9A-Za-z]{3}$/", $tag)) { $errorMessage = File_MARC_Exception::formatError(File_MARC_Exception::$messages[File_MARC_Exception::ERROR_INVALID_TAG], array("tag" => $tag)); throw new File_MARC_Exception($errorMessage, File_MARC_Exception::ERROR_INVALID_TAG); } } // }}} // {{{ Destructor: function __destruct() /* * Destroys the data field / function __destruct() { $this->tag = null; parent::__destruct(); } // }}} // {{{ getTag() /* * Returns the tag for this {@link File_MARC_Field} object * * @return string returns the tag number of the field / function getTag() { return (string)$this->tag; } // }}} // {{{ setTag() /* * Sets the tag for this {@link File_MARC_Field} object * * @param string $tag new value for the tag * * @return string returns the tag number of the field / function setTag($tag) { $this->tag = $tag; return $this->getTag(); } // }}} // {{{ isEmpty() /* * Is empty * * Checks if the field is empty. * * @return bool Returns true if the field is empty, otherwise false / function isEmpty() { if ($this->getTag()) { return false; } // It is empty return true; } // }}} // {{{ isControlField() /* * Is control field * * Checks if the field is a control field. * * @return bool Returns true if the field is a control field, otherwise false / function isControlField() { if (get_class($this) == 'File_MARC_Control_Field') { return true; } return false; } // }}} // {{{ isDataField() /* * Is data field * * Checks if the field is a data field. * * @return bool Returns true if the field is a data field, otherwise false / function isDataField() { if (get_class($this) == 'File_MARC_Data_Field') { return true; } return false; } // }}} /* * ========== OUTPUT METHODS ========== / // {{{ __toString() /* * Return Field formatted * * Return Field as a formatted string. * * @return string Formatted output of Field / function __toString() { return (string)$this->getTag(); } // }}} // {{{ toRaw() /* * Return field in raw MARC format (stub) * * Return the field formatted in raw MARC for saving into MARC files. This * stub method is extended by the child classes. * * @return bool Raw MARC / function toRaw() { return false; } // }}} // {{{ formatField() /* * Pretty print a MARC_Field object without tags, indicators, etc. * * @param array $exclude Subfields to exclude from formatted output * * @return string Returns the formatted field data */ function formatField($exclude = array('2')) { if ($this->isControlField()) { return $this->getData(); } else { $out = ''; foreach ($this->getSubfields() as $subfield) { if (substr($this->getTag(), 0, 1) == '6' and (in_array($subfield->getCode(), array('v','x','y','z')))) { $out .= ' -- ' . $subfield->getData(); } elseif (!in_array($subfield->getCode(), $exclude)) { $out .= ' ' . $subfield->getData(); } } return trim($out); } } // }}} } // }}}	6.48 KB	2024-07-17 10:10
📁 Lint	-	2025-05-25 12:37
📄 Lint.php <?php /* vim: set expandtab shiftwidth=4 tabstop=4 softtabstop=4 foldmethod=marker: / /* * Lint for MARC records * * This module is adapted from the MARC::Lint CPAN module for Perl, maintained by * Bryan Baldus <eijabb@cpan.org> and available at http://search.cpan.org/~eijabb/ * * Current MARC::Lint version used as basis for this module: 1.44 * * 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 Demian Katz <demian.katz@villanova.edu> * @author Dan Scott <dscott@laurentian.ca> * @copyright 2003-2008 Oy Realnode Ab, Dan Scott * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @version CVS: $Id: Record.php 308146 2011-02-08 20:36:20Z dbs $ * @link http://pear.php.net/package/File_MARC / require_once 'File/MARC/Lint/CodeData.php'; require_once 'Validate/ISPN.php'; // {{{ class File_MARC_Lint /* * Class for testing validity of MARC records against MARC21 standard. * * @category File_Formats * @package File_MARC * @author Demian Katz <demian.katz@villanova.edu> * @author Dan Scott <dscott@laurentian.ca> * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @link http://pear.php.net/package/File_MARC / class File_MARC_Lint { // {{{ properties /* * Rules used for testing records * @var array / protected $rules; /* * A File_MARC_Lint_CodeData object for validating codes * @var File_MARC_Lint_CodeData / protected $data; /* * Warnings generated during analysis * @var array / protected $warnings = array(); // }}} // {{{ Constructor: function __construct() /* * Start function * * Set up rules for testing MARC records. * * @return true / public function __construct() { $this->parseRules(); $this->data = new File_MARC_Lint_CodeData(); } // }}} // {{{ getWarnings() /* * Check the provided MARC record and return an array of warning messages. * * @param File_MARC_Record $marc Record to check * * @return array / public function checkRecord($marc) { // Reset warnings: $this->warnings = array(); // Fail if we didn't get a valid object: if (!is_a($marc, 'File_MARC_Record')) { $this->warn('Must pass a File_MARC_Record object to checkRecord'); } else { $this->checkDuplicate1xx($marc); $this->checkMissing245($marc); $this->standardFieldChecks($marc); } return $this->warnings; } // }}} // {{{ warn() /* * Add a warning. * * @param string $warning Warning to add * * @return void / protected function warn($warning) { $this->warnings[] = $warning; } // }}} // {{{ checkDuplicate1xx() /* * Check for multiple 1xx fields. * * @param File_MARC_Record $marc Record to check * * @return void / protected function checkDuplicate1xx($marc) { $result = $marc->getFields('1[0-9][0-9]', true); $count = count($result); if ($count > 1) { $this->warn( "1XX: Only one 1XX tag is allowed, but I found $count of them." ); } } // }}} // {{{ checkMissing245() /* * Check for missing 245 field. * * @param File_MARC_Record $marc Record to check * * @return void / protected function checkMissing245($marc) { $result = $marc->getFields('245'); if (count($result) == 0) { $this->warn('245: No 245 tag.'); } } // }}} // {{{ standardFieldChecks() /* * Check all fields against the standard rules encoded in the class. * * @param File_MARC_Record $marc Record to check * * @return void / protected function standardFieldChecks($marc) { $fieldsSeen = array(); foreach ($marc->getFields() as $current) { $tagNo = $current->getTag(); // if 880 field, inherit rules from tagno in subfield _6 if ($tagNo == 880) { if ($sub6 = $current->getSubfield(6)) { $tagNo = substr($sub6->getData(), 0, 3); $tagrules = isset($this->rules[$tagNo]) ? $this->rules[$tagNo] : null; // 880 is repeatable, but its linked field may not be if (isset($tagrules['repeatable']) && $tagrules['repeatable'] == 'NR' && isset($fieldsSeen['880.'.$tagNo]) ) { $this->warn("$tagNo: Field is not repeatable."); } $fieldsSeen['880.'.$tagNo] = isset($fieldsSeen['880.'.$tagNo]) ? $fieldsSeen['880.'.$tagNo] + 1 : 1; } else { $this->warn("880: No subfield 6."); $tagRules = null; } } else { // Default case -- not an 880 field: $tagrules = isset($this->rules[$tagNo]) ? $this->rules[$tagNo] : null; if (isset($tagrules['repeatable']) && $tagrules['repeatable'] == 'NR' && isset($fieldsSeen[$tagNo]) ) { $this->warn("$tagNo: Field is not repeatable."); } $fieldsSeen[$tagNo] = isset($fieldsSeen[$tagNo]) ? $fieldsSeen[$tagNo] + 1 : 1; } // Treat data fields differently from control fields: if (intval(ltrim($tagNo, '0')) >= 10) { if (!empty($tagrules)) { $this->checkIndicators($tagNo, $current, $tagrules); $this->checkSubfields($tagNo, $current, $tagrules); } } else { // Control field: if (strstr($current->toRaw(), chr(hexdec('1F')))) { $this->warn( "$tagNo: Subfields are not allowed in fields lower than 010" ); } } // Check to see if a checkxxx() function exists, and call it on the // field if it does $method = 'check' . $tagNo; if (method_exists($this, $method)) { $this->$method($current); } } } // }}} // {{{ checkIndicators() /* * Check the indicators for the provided field. * * @param string $tagNo Tag number being checked * @param File_MARC_Field $field Field to check * @param array $rules Rules to use for checking * * @return void / protected function checkIndicators($tagNo, $field, $rules) { for ($i = 1; $i <= 2; $i++) { $ind = $field->getIndicator($i); if ($ind === false \|\| $ind == ' ') { $ind = 'b'; } if (!strstr($rules['ind' . $i]['values'], $ind)) { // Make indicator blank value human-readable for message: if ($ind == 'b') { $ind = 'blank'; } $this->warn( "$tagNo: Indicator $i must be " . $rules['ind' . $i]['hr_values'] . " but it's \"$ind\"" ); } } } // }}} // {{{ checkSubfields() /* * Check the subfields for the provided field. * * @param string $tagNo Tag number being checked * @param File_MARC_Field $field Field to check * @param array $rules Rules to use for checking * * @return void / protected function checkSubfields($tagNo, $field, $rules) { $subSeen = array(); foreach ($field->getSubfields() as $current) { $code = $current->getCode(); $data = $current->getData(); $subrules = isset($rules['sub' . $code]) ? $rules['sub' . $code] : null; if (empty($subrules)) { $this->warn("$tagNo: Subfield _$code is not allowed."); } elseif ($subrules['repeatable'] == 'NR' && isset($subSeen[$code])) { $this->warn("$tagNo: Subfield _$code is not repeatable."); } if (preg_match('/\r\|\t\|\n/', $data)) { $this->warn( "$tagNo: Subfield _$code has an invalid control character" ); } $subSeen[$code] = isset($subSeen[$code]) ? $subSeen[$code]++ : 1; } } // }}} // {{{ check020() /* * Looks at 020$a and reports errors if the check digit is wrong. * Looks at 020$z and validates number if hyphens are present. * * @param File_MARC_Field $field Field to check * * @return void / protected function check020($field) { foreach ($field->getSubfields() as $current) { $data = $current->getData(); // remove any hyphens $isbn = str_replace('-', '', $data); // remove nondigits $isbn = preg_replace('/^\D(\d{9,12}[X\d])\b.$/', '$1', $isbn); if ($current->getCode() == 'a') { if ((substr($data, 0, strlen($isbn)) != $isbn)) { $this->warn("020: Subfield a may have invalid characters."); } // report error if no space precedes a qualifier in subfield a if (preg_match('/\(/', $data) && !preg_match('/[X0-9] \(/', $data)) { $this->warn( "020: Subfield a qualifier must be preceded by space, $data." ); } // report error if unable to find 10-13 digit string of digits in // subfield 'a' if (!preg_match('/(?:^\d{10}$)\|(?:^\d{13}$)\|(?:^\d{9}X$)/', $isbn)) { $this->warn( "020: Subfield a has the wrong number of digits, $data." ); } else { if (strlen($isbn) == 10) { if (!Validate_ISPN::isbn10($isbn)) { $this->warn("020: Subfield a has bad checksum, $data."); } } else if (strlen($isbn) == 13) { if (!Validate_ISPN::isbn13($isbn)) { $this->warn( "020: Subfield a has bad checksum (13 digit), $data." ); } } } } else if ($current->getCode() == 'z') { // look for valid isbn in 020$z if (preg_match('/^ISBN/', $data) \|\| preg_match('/^\d\-\d+/', $data) ) { // ################################################## // ## Turned on for now--Comment to unimplement #### // ################################################## if ((strlen($isbn) == 10) && (Validate_ISPN::isbn10($isbn) == 1) ) { $this->warn("020: Subfield z is numerically valid."); } } } } } // }}} // {{{ check041() /** * Warns if subfields are not evenly divisible by 3 unless second indicator is 7 * (future implementation would ensure that each subfield is exactly 3 characters * unless ind2 is 7--since subfields are now repeatable. This is not implemented * here due to the large number of records needing to be corrected.). Validates * against the MARC Code List for Languages (<http://www.loc.gov/marc/>). * * @param File_MARC_Field $field Field to check * * @return void / protected function check041($field) { // warn if length of each subfield is not divisible by 3 unless ind2 is 7 if ($field->getIndicator(2) != '7') { foreach ($field->getSubfields() as $sub) { $code = $sub->getCode(); $data = $sub->getData(); if (strlen($data) % 3 != 0) { $this->warn( "041: Subfield _$code must be evenly divisible by 3 or " . "exactly three characters if ind2 is not 7, ($data)." ); } else { for ($i = 0; $i < strlen($data); $i += 3) { $chk = substr($data, $i, 3); if (!in_array($chk, $this->data->languageCodes)) { $obs = $this->data->obsoleteLanguageCodes; if (in_array($chk, $obs)) { $this->warn( "041: Subfield _$code, $data, may be obsolete." ); } else { $this->warn( "041: Subfield _$code, $data ($chk)," . " is not valid." ); } } } } } } } // }}} // {{{ check043() /* * Warns if each subfield a is not exactly 7 characters. Validates each code * against the MARC code list for Geographic Areas (<http://www.loc.gov/marc/>). * * @param File_MARC_Field $field Field to check * * @return void / protected function check043($field) { foreach ($field->getSubfields('a') as $suba) { // warn if length of subfield a is not exactly 7 $data = $suba->getData(); if (strlen($data) != 7) { $this->warn("043: Subfield _a must be exactly 7 characters, $data"); } else if (!in_array($data, $this->data->geogAreaCodes)) { if (in_array($data, $this->data->obsoleteGeogAreaCodes)) { $this->warn("043: Subfield _a, $data, may be obsolete."); } else { $this->warn("043: Subfield _a, $data, is not valid."); } } } } // }}} // {{{ check245() /* * -Makes sure $a exists (and is first subfield). * -Warns if last character of field is not a period * --Follows LCRI 1.0C, Nov. 2003 rather than MARC21 rule * -Verifies that $c is preceded by / (space-/) * -Verifies that initials in $c are not spaced * -Verifies that $b is preceded by :;= (space-colon, space-semicolon, * space-equals) * -Verifies that $h is not preceded by space unless it is dash-space * -Verifies that data of $h is enclosed in square brackets * -Verifies that $n is preceded by . (period) * --As part of that, looks for no-space period, or dash-space-period * (for replaced elipses) * -Verifies that $p is preceded by , (no-space-comma) when following $n and * . (period) when following other subfields. * -Performs rudimentary article check of 245 2nd indicator vs. 1st word of * 245$a (for manual verification). * * Article checking is done by internal checkArticle method, which should work * for 130, 240, 245, 440, 630, 730, and 830. * * @param File_MARC_Field $field Field to check * * @return void / protected function check245($field) { if (count($field->getSubfields('a')) == 0) { $this->warn("245: Must have a subfield _a."); } // Convert subfields to array and set flags indicating which subfields are // present while we're at it. $tmp = $field->getSubfields(); $hasSubfields = $subfields = array(); foreach ($tmp as $current) { $subfields[] = $current; $hasSubfields[$current->getCode()] = true; } // 245 must end in period (may want to make this less restrictive by allowing // trailing spaces) // do 2 checks--for final punctuation (MARC21 rule), and for period // (LCRI 1.0C, Nov. 2003) $lastChar = substr($subfields[count($subfields)-1]->getData(), -1); if (!in_array($lastChar, array('.', '?', '!'))) { $this->warn("245: Must end with . (period)."); } else if ($lastChar != '.') { $this->warn( "245: MARC21 allows ? or ! as final punctuation but LCRI 1.0C, Nov." . " 2003, requires period." ); } // Check for first subfield // subfield a should be first subfield (or 2nd if subfield '6' is present) if (isset($hasSubfields['6'])) { // make sure there are at least 2 subfields if (count($subfields) < 2) { $this->warn("245: May have too few subfields."); } else { $first = $subfields[0]->getCode(); $second = $subfields[1]->getCode(); if ($first != '6') { $this->warn("245: First subfield must be _6, but it is $first"); } if ($second != 'a') { $this->warn( "245: First subfield after subfield _6 must be _a, but it " . "is _$second" ); } } } else { // 1st subfield must be 'a' $first = $subfields[0]->getCode(); if ($first != 'a') { $this->warn("245: First subfield must be _a, but it is _$first"); } } // End check for first subfield // subfield c, if present, must be preceded by / // also look for space between initials if (isset($hasSubfields['c'])) { foreach ($subfields as $i => $current) { // 245 subfield c must be preceded by / (space-/) if ($current->getCode() == 'c') { if ($i > 0 && !preg_match('/\s\/$/', $subfields[$i-1]->getData()) ) { $this->warn("245: Subfield _c must be preceded by /"); } // 245 subfield c initials should not have space if (preg_match('/\b\w\. \b\w\./', $current->getData())) { $this->warn( "245: Subfield _c initials should not have a space." ); } break; } } } // each subfield b, if present, should be preceded by :;= (colon, semicolon, // or equals sign) if (isset($hasSubfields['b'])) { // 245 subfield b should be preceded by space-:;= (colon, semicolon, or // equals sign) foreach ($subfields as $i => $current) { if ($current->getCode() == 'b' && $i > 0 && !preg_match('/ [:;=]$/', $subfields[$i-1]->getData()) ) { $this->warn( "245: Subfield _b should be preceded by space-colon, " . "space-semicolon, or space-equals sign." ); } } } // each subfield h, if present, should be preceded by non-space if (isset($hasSubfields['h'])) { // 245 subfield h should not be preceded by space foreach ($subfields as $i => $current) { // report error if subfield 'h' is preceded by space (unless // dash-space) if ($current->getCode() == 'h') { $prev = $subfields[$i-1]->getData(); if ($i > 0 && !preg_match('/(\S$)\|(\-\- $)/', $prev)) { $this->warn( "245: Subfield _h should not be preceded by space." ); } // report error if subfield 'h' does not start with open square // bracket with a matching close bracket; could have check // against list of valid values here $data = $current->getData(); if (!preg_match('/^\[\w\s\w\]/', $data)) { $this->warn( "245: Subfield _h must have matching square brackets," . " $data." ); } } } } // each subfield n, if present, must be preceded by . (period) if (isset($hasSubfields['n'])) { // 245 subfield n must be preceded by . (period) foreach ($subfields as $i => $current) { // report error if subfield 'n' is not preceded by non-space-period // or dash-space-period if ($current->getCode() == 'n' && $i > 0) { $prev = $subfields[$i-1]->getData(); if (!preg_match('/(\S\.$)\|(\-\- \.$)/', $prev)) { $this->warn( "245: Subfield _n must be preceded by . (period)." ); } } } } // each subfield p, if present, must be preceded by a , (no-space-comma) // if it follows subfield n, or by . (no-space-period or // dash-space-period) following other subfields if (isset($hasSubfields['p'])) { // 245 subfield p must be preceded by . (period) or , (comma) foreach ($subfields as $i => $current) { if ($current->getCode() == 'p' && $i > 0) { $prev = $subfields[$i-1]; // case for subfield 'n' being field before this one (allows // dash-space-comma) if ($prev->getCode() == 'n' && !preg_match('/(\S,$)\|(\-\- ,$)/', $prev->getData()) ) { $this->warn( "245: Subfield _p must be preceded by , (comma) " . "when it follows subfield _n." ); } else if ($prev->getCode() != 'n' && !preg_match('/(\S\.$)\|(\-\- \.$)/', $prev->getData()) ) { $this->warn( "245: Subfield _p must be preceded by . (period)" . " when it follows a subfield other than _n." ); } } } } // check for invalid 2nd indicator $this->checkArticle($field); } // }}} // {{{ checkArticle() /** * Check of articles is based on code from Ian Hamilton. This version is more * limited in that it focuses on English, Spanish, French, Italian and German * articles. Certain possible articles have been removed if they are valid * English non-articles. This version also disregards 008_language/041 codes * and just uses the list of articles to provide warnings/suggestions. * * source for articles = <http://www.loc.gov/marc/bibliographic/bdapp-e.html> * * Should work with fields 130, 240, 245, 440, 630, 730, and 830. Reports error * if another field is passed in. * * @param File_MARC_Field $field Field to check * * @return void / protected function checkArticle($field) { // add articles here as needed // Some omitted due to similarity with valid words (e.g. the German 'die'). static $article = array( 'a' => 'eng glg hun por', 'an' => 'eng', 'das' => 'ger', 'dem' => 'ger', 'der' => 'ger', 'ein' => 'ger', 'eine' => 'ger', 'einem' => 'ger', 'einen' => 'ger', 'einer' => 'ger', 'eines' => 'ger', 'el' => 'spa', 'en' => 'cat dan nor swe', 'gl' => 'ita', 'gli' => 'ita', 'il' => 'ita mlt', 'l' => 'cat fre ita mlt', 'la' => 'cat fre ita spa', 'las' => 'spa', 'le' => 'fre ita', 'les' => 'cat fre', 'lo' => 'ita spa', 'los' => 'spa', 'os' => 'por', 'the' => 'eng', 'um' => 'por', 'uma' => 'por', 'un' => 'cat spa fre ita', 'una' => 'cat spa ita', 'une' => 'fre', 'uno' => 'ita', ); // add exceptions here as needed // may want to make keys lowercase static $exceptions = array( 'A & E', 'A-', 'A+', 'A is ', 'A isn\'t ', 'A l\'', 'A la ', 'A posteriori', 'A priori', 'A to ', 'El Nino', 'El Salvador', 'L-', 'La Salle', 'Las Vegas', 'Lo mein', 'Los Alamos', 'Los Angeles', ); // get tagno to determine which indicator to check and for reporting $tagNo = $field->getTag(); // retrieve tagno from subfield 6 if 880 field if ($tagNo == '880' && ($sub6 = $field->getSubfield('6'))) { $tagNo = substr($sub6->getData(), 0, 3); } // $ind holds nonfiling character indicator value $ind = ''; // $first_or_second holds which indicator is for nonfiling char value $first_or_second = ''; if (in_array($tagNo, array(130, 630, 730))) { $ind = $field->getIndicator(1); $first_or_second = '1st'; } else if (in_array($tagNo, array(240, 245, 440, 830))) { $ind = $field->getIndicator(2); $first_or_second = '2nd'; } else { $this->warn( 'Internal error: ' . $tagNo . " is not a valid field for article checking\n" ); return; } if (!is_numeric($ind)) { $this->warn($tagNo . ": Non-filing indicator is non-numeric"); return; } // get subfield 'a' of the title field $titleField = $field->getSubfield('a'); $title = $titleField ? $titleField->getData() : ''; $char1_notalphanum = 0; // check for apostrophe, quote, bracket, or parenthesis, before first word // remove if found and add to non-word counter while (preg_match('/^["\'\[\(]/', $title)) { $char1_notalphanum++; $title = preg_replace('/^["\'\[\(]/', '', $title); } // split title into first word + rest on space, parens, bracket, apostrophe, // quote, or hyphen preg_match('/^([^ \(\)\[\]\'"\-]+)([ \(\)\[\]\'"\-])?(.)/i', $title, $hits); $firstword = isset($hits[1]) ? $hits[1] : ''; $separator = isset($hits[2]) ? $hits[2] : ''; $etc = isset($hits[3]) ? $hits[3] : ''; // get length of first word plus the number of chars removed above plus one // for the separator $nonfilingchars = strlen($firstword) + $char1_notalphanum + 1; // check to see if first word is an exception $isan_exception = false; foreach ($exceptions as $current) { if (substr($title, 0, strlen($current)) == $current) { $isan_exception = true; break; } } // lowercase chars of $firstword for comparison with article list $firstword = strtolower($firstword); // see if first word is in the list of articles and not an exception $isan_article = !$isan_exception && isset($article[$firstword]); // if article then $nonfilingchars should match $ind if ($isan_article) { // account for quotes, apostrophes, parens, or brackets before 2nd word if (strlen($separator) && preg_match('/^[ \(\)\[\]\'"\-]+/', $etc)) { while (preg_match('/^[ "\'\[\]\(\)]/', $etc)) { $nonfilingchars++; $etc = preg_replace('/^[ "\'\[\]\(\)]/', '', $etc); } } if ($nonfilingchars != $ind) { $this->warn( $tagNo . ": First word, $firstword, may be an article, check " . "$first_or_second indicator ($ind)." ); } } else { // not an article so warn if $ind is not 0 if ($ind != '0') { $this->warn( $tagNo . ": First word, $firstword, does not appear to be an " . "article, check $first_or_second indicator ($ind)." ); } } } // }}} // {{{ parseRules() /** * Support method for constructor to load MARC rules. * * @return void / protected function parseRules() { // Break apart the rule data on line breaks: $lines = explode("\n", $this->getRawRules()); // Each group of data is split by a blank line -- process one group // at a time: $currentGroup = array(); foreach ($lines as $currentLine) { if (empty($currentLine) && !empty($currentGroup)) { $this->processRuleGroup($currentGroup); $currentGroup = array(); } else { $currentGroup[] = preg_replace("/\s+/", " ", $currentLine); } } // Still have unprocessed data after the loop? Handle it now: if (!empty($currentGroup)) { $this->processRuleGroup($currentGroup); } } // }}} // {{{ processRuleGroup() /* * Support method for parseRules() -- process one group of lines representing * a single tag. * * @param array $rules Rule lines to process * * @return void / protected function processRuleGroup($rules) { // The first line is guaranteed to exist and gives us some basic info: list($tag, $repeatable, $description) = explode(' ', $rules[0]); $this->rules[$tag] = array( 'repeatable' => $repeatable, 'desc' => $description ); // We may or may not have additional details: for ($i = 1; $i < count($rules); $i++) { list($key, $value, $lineDesc) = explode(' ', $rules[$i]); if (substr($key, 0, 3) == 'ind') { // Expand ranges: $value = str_replace('0-9', '0123456789', $value); $this->rules[$tag][$key] = array( 'values' => $value, 'hr_values' => $this->getHumanReadableIndicatorValues($value), 'desc'=> $lineDesc ); } else { if (strlen($key) <= 1) { $this->rules[$tag]['sub' . $key] = array( 'repeatable' => $value, 'desc' => $lineDesc ); } elseif (strstr($key, '-')) { list($startKey, $endKey) = explode('-', $key); for ($key = $startKey; $key <= $endKey; $key++) { $this->rules[$tag]['sub' . $key] = array( 'repeatable' => $value, 'desc' => $lineDesc ); } } } } } // }}} // {{{ getHumanReadableIndicatorValues() /* * Turn a set of indicator rules into a human-readable list. * * @param string $rules Indicator rules * * @return string / protected function getHumanReadableIndicatorValues($rules) { // No processing needed for blank rule: if ($rules == 'blank') { return $rules; } // Create string: $string = ''; $length = strlen($rules); for ($i = 0; $i < $length; $i++) { $current = substr($rules, $i, 1); if ($current == 'b') { $current = 'blank'; } $string .= $current; if ($length - $i == 2) { $string .= ' or '; } else if ($length - $i > 2) { $string .= ', '; } } return $string; } // }}} // {{{ getRawRules() /* * Support method for parseRules() -- get the raw rules from MARC::Lint. * * @return string */ protected function getRawRules() { // When updating rules, don't forget to escape the dollar signs in the text! // It would be simpler to change from HEREDOC to NOWDOC syntax, but that // would raise the requirements to PHP 5.3. // @codingStandardsIgnoreStart return <<<RULES 001 NR CONTROL NUMBER ind1 blank Undefined ind2 blank Undefined NR Undefined 002 NR LOCALLY DEFINED (UNOFFICIAL) ind1 blank Undefined ind2 blank Undefined NR Undefined 003 NR CONTROL NUMBER IDENTIFIER ind1 blank Undefined ind2 blank Undefined NR Undefined 005 NR DATE AND TIME OF LATEST TRANSACTION ind1 blank Undefined ind2 blank Undefined NR Undefined 006 R FIXED-LENGTH DATA ELEMENTS--ADDITIONAL MATERIAL CHARACTERISTICS--GENERAL INFORMATION ind1 blank Undefined ind2 blank Undefined R Undefined 007 R PHYSICAL DESCRIPTION FIXED FIELD--GENERAL INFORMATION ind1 blank Undefined ind2 blank Undefined R Undefined 008 NR FIXED-LENGTH DATA ELEMENTS--GENERAL INFORMATION ind1 blank Undefined ind2 blank Undefined NR Undefined 010 NR LIBRARY OF CONGRESS CONTROL NUMBER ind1 blank Undefined ind2 blank Undefined a NR LC control number b R NUCMC control number z R Canceled/invalid LC control number 8 R Field link and sequence number 013 R PATENT CONTROL INFORMATION ind1 blank Undefined ind2 blank Undefined a NR Number b NR Country c NR Type of number d R Date e R Status f R Party to document 6 NR Linkage 8 R Field link and sequence number 015 R NATIONAL BIBLIOGRAPHY NUMBER ind1 blank Undefined ind2 blank Undefined a R National bibliography number z R Canceled/Invalid national bibliography number 2 NR Source 6 NR Linkage 8 R Field link and sequence number 016 R NATIONAL BIBLIOGRAPHIC AGENCY CONTROL NUMBER ind1 b7 National bibliographic agency ind2 blank Undefined a NR Record control number z R Canceled or invalid record control number 2 NR Source 8 R Field link and sequence number 017 R COPYRIGHT OR LEGAL DEPOSIT NUMBER ind1 blank Undefined ind2 b8 Undefined a R Copyright or legal deposit number b NR Assigning agency d NR Date i NR Display text z R Canceled/invalid copyright or legal deposit number 2 NR Source 6 NR Linkage 8 R Field link and sequence number 018 NR COPYRIGHT ARTICLE-FEE CODE ind1 blank Undefined ind2 blank Undefined a NR Copyright article-fee code 6 NR Linkage 8 R Field link and sequence number 020 R INTERNATIONAL STANDARD BOOK NUMBER ind1 blank Undefined ind2 blank Undefined a NR International Standard Book Number c NR Terms of availability z R Canceled/invalid ISBN 6 NR Linkage 8 R Field link and sequence number 022 R INTERNATIONAL STANDARD SERIAL NUMBER ind1 b01 Level of international interest ind2 blank Undefined a NR International Standard Serial Number l NR ISSN-L m R Canceled ISSN-L y R Incorrect ISSN z R Canceled ISSN 2 NR Source 6 NR Linkage 8 R Field link and sequence number 024 R OTHER STANDARD IDENTIFIER ind1 0123478 Type of standard number or code ind2 b01 Difference indicator a NR Standard number or code c NR Terms of availability d NR Additional codes following the standard number or code z R Canceled/invalid standard number or code 2 NR Source of number or code 6 NR Linkage 8 R Field link and sequence number 025 R OVERSEAS ACQUISITION NUMBER ind1 blank Undefined ind2 blank Undefined a R Overseas acquisition number 8 R Field link and sequence number 026 R FINGERPRINT IDENTIFIER ind1 blank Undefined ind2 blank Undefined a R First and second groups of characters b R Third and fourth groups of characters c NR Date d R Number of volume or part e NR Unparsed fingerprint 2 NR Source 5 R Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 027 R STANDARD TECHNICAL REPORT NUMBER ind1 blank Undefined ind2 blank Undefined a NR Standard technical report number z R Canceled/invalid number 6 NR Linkage 8 R Field link and sequence number 028 R PUBLISHER NUMBER ind1 012345 Type of publisher number ind2 0123 Note/added entry controller a NR Publisher number b NR Source 6 NR Linkage 8 R Field link and sequence number 030 R CODEN DESIGNATION ind1 blank Undefined ind2 blank Undefined a NR CODEN z R Canceled/invalid CODEN 6 NR Linkage 8 R Field link and sequence number 031 R MUSICAL INCIPITS INFORMATION ind1 blank Undefined ind2 blank Undefined a NR Number of work b NR Number of movement c NR Number of excerpt d R Caption or heading e NR Role g NR Clef m NR Voice/instrument n NR Key signature o NR Time signature p NR Musical notation q R General note r NR Key or mode s R Coded validity note t R Text incipit u R Uniform Resource Identifier y R Link text z R Public note 2 NR System code 6 NR Linkage 8 R Field link and sequence number 032 R POSTAL REGISTRATION NUMBER ind1 blank Undefined ind2 blank Undefined a NR Postal registration number b NR Source (agency assigning number) 6 NR Linkage 8 R Field link and sequence number 033 R DATE/TIME AND PLACE OF AN EVENT ind1 b012 Type of date in subfield \$a ind2 b012 Type of event a R Formatted date/time b R Geographic classification area code c R Geographic classification subarea code 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 034 R CODED CARTOGRAPHIC MATHEMATICAL DATA ind1 013 Type of scale ind2 b01 Type of ring a NR Category of scale b R Constant ratio linear horizontal scale c R Constant ratio linear vertical scale d NR Coordinates--westernmost longitude e NR Coordinates--easternmost longitude f NR Coordinates--northernmost latitude g NR Coordinates--southernmost latitude h R Angular scale j NR Declination--northern limit k NR Declination--southern limit m NR Right ascension--eastern limit n NR Right ascension--western limit p NR Equinox r NR Distance from earth s R G-ring latitude t R G-ring longitude x NR Beginning date y NR Ending date z NR Name of extraterrestrial body 2 NR Source 6 NR Linkage 8 R Field link and sequence number 035 R SYSTEM CONTROL NUMBER ind1 blank Undefined ind2 blank Undefined a NR System control number z R Canceled/invalid control number 6 NR Linkage 8 R Field link and sequence number 036 NR ORIGINAL STUDY NUMBER FOR COMPUTER DATA FILES ind1 blank Undefined ind2 blank Undefined a NR Original study number b NR Source (agency assigning number) 6 NR Linkage 8 R Field link and sequence number 037 R SOURCE OF ACQUISITION ind1 blank Undefined ind2 blank Undefined a NR Stock number b NR Source of stock number/acquisition c R Terms of availability f R Form of issue g R Additional format characteristics n R Note 6 NR Linkage 8 R Field link and sequence number 038 NR RECORD CONTENT LICENSOR ind1 blank Undefined ind2 blank Undefined a NR Record content licensor 6 NR Linkage 8 R Field link and sequence number 040 NR CATALOGING SOURCE ind1 blank Undefined ind2 blank Undefined a NR Original cataloging agency b NR Language of cataloging c NR Transcribing agency d R Modifying agency e NR Description conventions 6 NR Linkage 8 R Field link and sequence number 041 R LANGUAGE CODE ind1 b01 Translation indication ind2 b7 Source of code a R Language code of text/sound track or separate title b R Language code of summary or abstract d R Language code of sung or spoken text e R Language code of librettos f R Language code of table of contents g R Language code of accompanying material other than librettos h R Language code of original and/or intermediate translations of text j R Language code of subtitles or captions 2 NR Source of code 6 NR Linkage 8 R Field link and sequence number 042 NR AUTHENTICATION CODE ind1 blank Undefined ind2 blank Undefined a R Authentication code 043 NR GEOGRAPHIC AREA CODE ind1 blank Undefined ind2 blank Undefined a R Geographic area code b R Local GAC code c R ISO code 2 R Source of local code 6 NR Linkage 8 R Field link and sequence number 044 NR COUNTRY OF PUBLISHING/PRODUCING ENTITY CODE ind1 blank Undefined ind2 blank Undefined a R MARC country code b R Local subentity code c R ISO country code 2 R Source of local subentity code 6 NR Linkage 8 R Field link and sequence number 045 NR TIME PERIOD OF CONTENT ind1 b012 Type of time period in subfield \$b or \$c ind2 blank Undefined a R Time period code b R Formatted 9999 B.C. through C.E. time period c R Formatted pre-9999 B.C. time period 6 NR Linkage 8 R Field link and sequence number 046 R SPECIAL CODED DATES ind1 blank Undefined ind2 blank Undefined a NR Type of date code b NR Date 1 (B.C. date) c NR Date 1 (C.E. date) d NR Date 2 (B.C. date) e NR Date 2 (C.E. date) j NR Date resource modified k NR Beginning or single date created l NR Ending date created m NR Beginning of date valid n NR End of date valid 2 NR Source of date 6 NR Linkage 8 R Field link and sequence number 047 R FORM OF MUSICAL COMPOSITION CODE ind1 blank Undefined ind2 b7 Source of code a R Form of musical composition code 2 NR Source of code 8 R Field link and sequence number 048 R NUMBER OF MUSICAL INSTRUMENTS OR VOICES CODE ind1 blank Undefined ind2 b7 Source specified in subfield \$2 a R Performer or ensemble b R Soloist 2 NR Source of code 8 R Field link and sequence number 050 R LIBRARY OF CONGRESS CALL NUMBER ind1 b01 Existence in LC collection ind2 04 Source of call number a R Classification number b NR Item number 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 051 R LIBRARY OF CONGRESS COPY, ISSUE, OFFPRINT STATEMENT ind1 blank Undefined ind2 blank Undefined a NR Classification number b NR Item number c NR Copy information 8 R Field link and sequence number 052 R GEOGRAPHIC CLASSIFICATION ind1 b17 Code source ind2 blank Undefined a NR Geographic classification area code b R Geographic classification subarea code d R Populated place name 2 NR Code source 6 NR Linkage 8 R Field link and sequence number 055 R CLASSIFICATION NUMBERS ASSIGNED IN CANADA ind1 b01 Existence in LAC collection ind2 0123456789 Type, completeness, source of class/call number a NR Classification number b NR Item number 2 NR Source of call/class number 8 R Field link and sequence number 060 R NATIONAL LIBRARY OF MEDICINE CALL NUMBER ind1 b01 Existence in NLM collection ind2 04 Source of call number a R Classification number b NR Item number 8 R Field link and sequence number 061 R NATIONAL LIBRARY OF MEDICINE COPY STATEMENT ind1 blank Undefined ind2 blank Undefined a R Classification number b NR Item number c NR Copy information 8 R Field link and sequence number 066 NR CHARACTER SETS PRESENT ind1 blank Undefined ind2 blank Undefined a NR Primary G0 character set b NR Primary G1 character set c R Alternate G0 or G1 character set 070 R NATIONAL AGRICULTURAL LIBRARY CALL NUMBER ind1 01 Existence in NAL collection ind2 blank Undefined a R Classification number b NR Item number 8 R Field link and sequence number 071 R NATIONAL AGRICULTURAL LIBRARY COPY STATEMENT ind1 blank Undefined ind2 blank Undefined a R Classification number b NR Item number c NR Copy information 8 R Field link and sequence number 072 R SUBJECT CATEGORY CODE ind1 blank Undefined ind2 07 Source specified in subfield \$2 a NR Subject category code x R Subject category code subdivision 2 NR Source 6 NR Linkage 8 R Field link and sequence number 074 R GPO ITEM NUMBER ind1 blank Undefined ind2 blank Undefined a NR GPO item number z R Canceled/invalid GPO item number 8 R Field link and sequence number 080 R UNIVERSAL DECIMAL CLASSIFICATION NUMBER ind1 blank Undefined ind2 blank Undefined a NR Universal Decimal Classification number b NR Item number x R Common auxiliary subdivision 2 NR Edition identifier 6 NR Linkage 8 R Field link and sequence number 082 R DEWEY DECIMAL CLASSIFICATION NUMBER ind1 01 Type of edition ind2 b04 Source of classification number a R Classification number b NR Item number m NR Standard or optional designation q NR Assigning agency 2 NR Edition number 6 NR Linkage 8 R Field link and sequence number 083 R ADDITIONAL DEWEY DECIMAL CLASSIFICATION NUMBER ind1 01 Type of edition ind2 blank Undefined a R Classification number c R Classification number--Ending number of span m NR Standard or optional designation q NR Assigning agency y R Table sequence number for internal subarrangement or add table z R Table identification 2 NR Edition number 6 NR Linkage 8 R Field link and sequence number 084 R OTHER CLASSIFICATION NUMBER ind1 blank Undefined ind2 blank Undefined a R Classification number b NR Item number 2 NR Source of number 6 NR Linkage 8 R Field link and sequence number 085 R SYNTHESIZED CLASSIFICATION NUMBER COMPONENTS ind1 blank Undefined ind2 blank Undefined a R Number where instructions are found-single number or beginning number of span b R Base number c R Classification number-ending number of span f R Facet designator r R Root number s R Digits added from classification number in schedule or external table t R Digits added from internal subarrangement or add table u R Number being analyzed v R Number in internal subarrangement or add table where instructions are found w R Table identification-Internal subarrangement or add table y R Table sequence number for internal subarrangement or add table z R Table identification 6 NR Linkage 8 R Field link and sequence number 086 R GOVERNMENT DOCUMENT CLASSIFICATION NUMBER ind1 b01 Number source ind2 blank Undefined a NR Classification number z R Canceled/invalid classification number 2 NR Number source 6 NR Linkage 8 R Field link and sequence number 088 R REPORT NUMBER ind1 blank Undefined ind2 blank Undefined a NR Report number z R Canceled/invalid report number 6 NR Linkage 8 R Field link and sequence number 100 NR MAIN ENTRY--PERSONAL NAME ind1 013 Type of personal name entry element ind2 blank Undefined a NR Personal name b NR Numeration c R Titles and other words associated with a name d NR Dates associated with a name e R Relator term f NR Date of a work g NR Miscellaneous information j R Attribution qualifier k R Form subheading l NR Language of a work n R Number of part/section of a work p R Name of part/section of a work q NR Fuller form of name t NR Title of a work u NR Affiliation 0 R Authority record control number 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 110 NR MAIN ENTRY--CORPORATE NAME ind1 012 Type of corporate name entry element ind2 blank Undefined a NR Corporate name or jurisdiction name as entry element b R Subordinate unit c NR Location of meeting d R Date of meeting or treaty signing e R Relator term f NR Date of a work g NR Miscellaneous information k R Form subheading l NR Language of a work n R Number of part/section/meeting p R Name of part/section of a work t NR Title of a work u NR Affiliation 0 R Authority record control number 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 111 NR MAIN ENTRY--MEETING NAME ind1 012 Type of meeting name entry element ind2 blank Undefined a NR Meeting name or jurisdiction name as entry element c NR Location of meeting d NR Date of meeting e R Subordinate unit f NR Date of a work g NR Miscellaneous information j R Relator term k R Form subheading l NR Language of a work n R Number of part/section/meeting p R Name of part/section of a work q NR Name of meeting following jurisdiction name entry element t NR Title of a work u NR Affiliation 0 R Authority record control number 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 130 NR MAIN ENTRY--UNIFORM TITLE ind1 0-9 Nonfiling characters ind2 blank Undefined a NR Uniform title d R Date of treaty signing f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version t NR Title of a work 0 R Authority record control number 6 NR Linkage 8 R Field link and sequence number 210 R ABBREVIATED TITLE ind1 01 Title added entry ind2 b0 Type a NR Abbreviated title b NR Qualifying information 2 R Source 6 NR Linkage 8 R Field link and sequence number 222 R KEY TITLE ind1 blank Specifies whether variant title and/or added entry is required ind2 0-9 Nonfiling characters a NR Key title b NR Qualifying information 6 NR Linkage 8 R Field link and sequence number 240 NR UNIFORM TITLE ind1 01 Uniform title printed or displayed ind2 0-9 Nonfiling characters a NR Uniform title d R Date of treaty signing f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version 0 R Authority record control number 6 NR Linkage 8 R Field link and sequence number 242 R TRANSLATION OF TITLE BY CATALOGING AGENCY ind1 01 Title added entry ind2 0-9 Nonfiling characters a NR Title b NR Remainder of title c NR Statement of responsibility, etc. h NR Medium n R Number of part/section of a work p R Name of part/section of a work y NR Language code of translated title 6 NR Linkage 8 R Field link and sequence number 243 NR COLLECTIVE UNIFORM TITLE ind1 01 Uniform title printed or displayed ind2 0-9 Nonfiling characters a NR Uniform title d R Date of treaty signing f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version 6 NR Linkage 8 R Field link and sequence number 245 NR TITLE STATEMENT ind1 01 Title added entry ind2 0-9 Nonfiling characters a NR Title b NR Remainder of title c NR Statement of responsibility, etc. f NR Inclusive dates g NR Bulk dates h NR Medium k R Form n R Number of part/section of a work p R Name of part/section of a work s NR Version 6 NR Linkage 8 R Field link and sequence number 246 R VARYING FORM OF TITLE ind1 0123 Note/added entry controller ind2 b012345678 Type of title a NR Title proper/short title b NR Remainder of title f NR Date or sequential designation g NR Miscellaneous information h NR Medium i NR Display text n R Number of part/section of a work p R Name of part/section of a work 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 247 R FORMER TITLE ind1 01 Title added entry ind2 01 Note controller a NR Title b NR Remainder of title f NR Date or sequential designation g NR Miscellaneous information h NR Medium n R Number of part/section of a work p R Name of part/section of a work x NR International Standard Serial Number 6 NR Linkage 8 R Field link and sequence number 250 NR EDITION STATEMENT ind1 blank Undefined ind2 blank Undefined a NR Edition statement b NR Remainder of edition statement 6 NR Linkage 8 R Field link and sequence number 254 NR MUSICAL PRESENTATION STATEMENT ind1 blank Undefined ind2 blank Undefined a NR Musical presentation statement 6 NR Linkage 8 R Field link and sequence number 255 R CARTOGRAPHIC MATHEMATICAL DATA ind1 blank Undefined ind2 blank Undefined a NR Statement of scale b NR Statement of projection c NR Statement of coordinates d NR Statement of zone e NR Statement of equinox f NR Outer G-ring coordinate pairs g NR Exclusion G-ring coordinate pairs 6 NR Linkage 8 R Field link and sequence number 256 NR COMPUTER FILE CHARACTERISTICS ind1 blank Undefined ind2 blank Undefined a NR Computer file characteristics 6 NR Linkage 8 R Field link and sequence number 257 NR COUNTRY OF PRODUCING ENTITY FOR ARCHIVAL FILMS ind1 blank Undefined ind2 blank Undefined a NR Country of producing entity 6 NR Linkage 8 R Field link and sequence number 258 R PHILATELIC ISSUE DATE ind1 blank Undefined ind2 blank Undefined a NR Issuing jurisdiction b NR Denomination 6 NR Linkage 8 R Field link and sequence number 260 R PUBLICATION, DISTRIBUTION, ETC. (IMPRINT) ind1 b23 Sequence of publishing statements ind2 blank Undefined a R Place of publication, distribution, etc. b R Name of publisher, distributor, etc. c R Date of publication, distribution, etc. d NR Plate or publisher's number for music (Pre-AACR 2) e R Place of manufacture f R Manufacturer g R Date of manufacture 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 261 NR IMPRINT STATEMENT FOR FILMS (Pre-AACR 1 Revised) ind1 blank Undefined ind2 blank Undefined a R Producing company b R Releasing company (primary distributor) d R Date of production, release, etc. e R Contractual producer f R Place of production, release, etc. 6 NR Linkage 8 R Field link and sequence number 262 NR IMPRINT STATEMENT FOR SOUND RECORDINGS (Pre-AACR 2) ind1 blank Undefined ind2 blank Undefined a NR Place of production, release, etc. b NR Publisher or trade name c NR Date of production, release, etc. k NR Serial identification l NR Matrix and/or take number 6 NR Linkage 8 R Field link and sequence number 263 NR PROJECTED PUBLICATION DATE ind1 blank Undefined ind2 blank Undefined a NR Projected publication date 6 NR Linkage 8 R Field link and sequence number 270 R ADDRESS ind1 b12 Level ind2 b07 Type of address a R Address b NR City c NR State or province d NR Country e NR Postal code f NR Terms preceding attention name g NR Attention name h NR Attention position i NR Type of address j R Specialized telephone number k R Telephone number l R Fax number m R Electronic mail address n R TDD or TTY number p R Contact person q R Title of contact person r R Hours z R Public note 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 300 R PHYSICAL DESCRIPTION ind1 blank Undefined ind2 blank Undefined a R Extent b NR Other physical details c R Dimensions e NR Accompanying material f R Type of unit g R Size of unit 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 306 NR PLAYING TIME ind1 blank Undefined ind2 blank Undefined a R Playing time 6 NR Linkage 8 R Field link and sequence number 307 R HOURS, ETC. ind1 b8 Display constant controller ind2 blank Undefined a NR Hours b NR Additional information 6 NR Linkage 8 R Field link and sequence number 310 NR CURRENT PUBLICATION FREQUENCY ind1 blank Undefined ind2 blank Undefined a NR Current publication frequency b NR Date of current publication frequency 6 NR Linkage 8 R Field link and sequence number 321 R FORMER PUBLICATION FREQUENCY ind1 blank Undefined ind2 blank Undefined a NR Former publication frequency b NR Dates of former publication frequency 6 NR Linkage 8 R Field link and sequence number 340 R PHYSICAL MEDIUM ind1 blank Undefined ind2 blank Undefined a R Material base and configuration b R Dimensions c R Materials applied to surface d R Information recording technique e R Support f R Production rate/ratio h R Location within medium i R Technical specifications of medium 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 342 R GEOSPATIAL REFERENCE DATA ind1 01 Geospatial reference dimension ind2 012345678 Geospatial reference method a NR Name b NR Coordinate or distance units c NR Latitude resolution d NR Longitude resolution e R Standard parallel or oblique line latitude f R Oblique line longitude g NR Longitude of central meridian or projection center h NR Latitude of projection origin or projection center i NR False easting j NR False northing k NR Scale factor l NR Height of perspective point above surface m NR Azimuthal angle o NR Landsat number and path number p NR Zone identifier q NR Ellipsoid name r NR Semi-major axis s NR Denominator of flattening ratio t NR Vertical resolution u NR Vertical encoding method v NR Local planar, local, or other projection or grid description w NR Local planar or local georeference information 2 NR Reference method used 6 NR Linkage 8 R Field link and sequence number 343 R PLANAR COORDINATE DATA ind1 blank Undefined ind2 blank Undefined a NR Planar coordinate encoding method b NR Planar distance units c NR Abscissa resolution d NR Ordinate resolution e NR Distance resolution f NR Bearing resolution g NR Bearing units h NR Bearing reference direction i NR Bearing reference meridian 6 NR Linkage 8 R Field link and sequence number 351 R ORGANIZATION AND ARRANGEMENT OF MATERIALS ind1 blank Undefined ind2 blank Undefined a R Organization b R Arrangement c NR Hierarchical level 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 352 R DIGITAL GRAPHIC REPRESENTATION ind1 blank Undefined ind2 blank Undefined a NR Direct reference method b R Object type c R Object count d NR Row count e NR Column count f NR Vertical count g NR VPF topology level i NR Indirect reference description q R Format of the digital image 6 NR Linkage 8 R Field link and sequence number 355 R SECURITY CLASSIFICATION CONTROL ind1 0123458 Controlled element ind2 blank Undefined a NR Security classification b R Handling instructions c R External dissemination information d NR Downgrading or declassification event e NR Classification system f NR Country of origin code g NR Downgrading date h NR Declassification date j R Authorization 6 NR Linkage 8 R Field link and sequence number 357 NR ORIGINATOR DISSEMINATION CONTROL ind1 blank Undefined ind2 blank Undefined a NR Originator control term b R Originating agency c R Authorized recipients of material g R Other restrictions 6 NR Linkage 8 R Field link and sequence number 362 R DATES OF PUBLICATION AND/OR SEQUENTIAL DESIGNATION ind1 01 Format of date ind2 blank Undefined a NR Dates of publication and/or sequential designation z NR Source of information 6 NR Linkage 8 R Field link and sequence number 363 R NORMALIZED DATE AND SEQUENTIAL DESIGNATION ind1 b01 Start/End designator ind2 b01 State of issuanceUndefined a NR First level of enumeration b NR Second level of enumeration c NR Third level of enumeration d NR Fourth level of enumeration e NR Fifth level of enumeration f NR Sixth level of enumeration g NR Alternative numbering scheme, first level of enumeration h NR Alternative numbering scheme, second level of enumeration i NR First level of chronology j NR Second level of chronology k NR Third level of chronology l NR Fourth level of chronology m NR Alternative numbering scheme, chronology u NR First level textual designation v NR First level of chronology, issuance x R Nonpublic note z R Public note 6 NR Linkage 8 NR Field link and sequence number 365 R TRADE PRICE ind1 blank Undefined ind2 blank Undefined a NR Price type code b NR Price amount c NR Currency code d NR Unit of pricing e NR Price note f NR Price effective from g NR Price effective until h NR Tax rate 1 i NR Tax rate 2 j NR ISO country code k NR MARC country code m NR Identification of pricing entity 2 NR Source of price type code 6 NR Linkage 8 R Field link and sequence number 366 R TRADE AVAILABILITY INFORMATION ind1 blank Undefined ind2 blank Undefined a NR Publishers' compressed title identification b NR Detailed date of publication c NR Availability status code d NR Expected next availability date e NR Note f NR Publishers' discount category g NR Date made out of print j NR ISO country code k NR MARC country code m NR Identification of agency 2 NR Source of availability status code 6 NR Linkage 8 R Field link and sequence number 400 R SERIES STATEMENT/ADDED ENTRY--PERSONAL NAME ind1 013 Type of personal name entry element ind2 01 Pronoun represents main entry a NR Personal name b NR Numeration c R Titles and other words associated with a name d NR Dates associated with a name e R Relator term f NR Date of a work g NR Miscellaneous information k R Form subheading l NR Language of a work n R Number of part/section of a work p R Name of part/section of a work t NR Title of a work u NR Affiliation v NR Volume number/sequential designation x NR International Standard Serial Number 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 410 R SERIES STATEMENT/ADDED ENTRY--CORPORATE NAME ind1 012 Type of corporate name entry element ind2 01 Pronoun represents main entry a NR Corporate name or jurisdiction name as entry element b R Subordinate unit c NR Location of meeting d R Date of meeting or treaty signing e R Relator term f NR Date of a work g NR Miscellaneous information k R Form subheading l NR Language of a work n R Number of part/section/meeting p R Name of part/section of a work t NR Title of a work u NR Affiliation v NR Volume number/sequential designation x NR International Standard Serial Number 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 411 R SERIES STATEMENT/ADDED ENTRY--MEETING NAME ind1 012 Type of meeting name entry element ind2 01 Pronoun represents main entry a NR Meeting name or jurisdiction name as entry element c NR Location of meeting d NR Date of meeting e R Subordinate unit f NR Date of a work g NR Miscellaneous information k R Form subheading l NR Language of a work n R Number of part/section/meeting p R Name of part/section of a work q NR Name of meeting following jurisdiction name entry element t NR Title of a work u NR Affiliation v NR Volume number/sequential designation x NR International Standard Serial Number 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 440 R SERIES STATEMENT/ADDED ENTRY--TITLE [OBSOLETE] ind1 blank Undefined ind2 0-9 Nonfiling characters a NR Title n R Number of part/section of a work p R Name of part/section of a work v NR Volume number/sequential designation x NR International Standard Serial Number w R Bibliographic record control number 0 R Authority record control number 6 NR Linkage 8 R Field link and sequence number 490 R SERIES STATEMENT ind1 01 Specifies whether series is traced ind2 blank Undefined a R Series statement l NR Library of Congress call number v R Volume number/sequential designation x NR International Standard Serial Number 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 500 R GENERAL NOTE ind1 blank Undefined ind2 blank Undefined a NR General note 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 501 R WITH NOTE ind1 blank Undefined ind2 blank Undefined a NR With note 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 502 R DISSERTATION NOTE ind1 blank Undefined ind2 blank Undefined a NR Dissertation note b NR Degree type c NR Name of granting institution d NR Year of degree granted g R Miscellaneous information o R Dissertation identifier 6 NR Linkage 8 R Field link and sequence number 504 R BIBLIOGRAPHY, ETC. NOTE ind1 blank Undefined ind2 blank Undefined a NR Bibliography, etc. note b NR Number of references 6 NR Linkage 8 R Field link and sequence number 505 R FORMATTED CONTENTS NOTE ind1 0128 Display constant controller ind2 b0 Level of content designation a NR Formatted contents note g R Miscellaneous information r R Statement of responsibility t R Title u R Uniform Resource Identifier 6 NR Linkage 8 R Field link and sequence number 506 R RESTRICTIONS ON ACCESS NOTE ind1 b01 Restriction ind2 blank Undefined a NR Terms governing access b R Jurisdiction c R Physical access provisions d R Authorized users e R Authorization f R Standard terminology for access restiction u R Uniform Resource Identifier 2 NR Source of term 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 507 NR SCALE NOTE FOR GRAPHIC MATERIAL ind1 blank Undefined ind2 blank Undefined a NR Representative fraction of scale note b NR Remainder of scale note 6 NR Linkage 8 R Field link and sequence number 508 R CREATION/PRODUCTION CREDITS NOTE ind1 blank Undefined ind2 blank Undefined a NR Creation/production credits note 6 NR Linkage 8 R Field link and sequence number 510 R CITATION/REFERENCES NOTE ind1 01234 Coverage/location in source ind2 blank Undefined a NR Name of source b NR Coverage of source c NR Location within source x NR International Standard Serial Number 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 511 R PARTICIPANT OR PERFORMER NOTE ind1 01 Display constant controller ind2 blank Undefined a NR Participant or performer note 6 NR Linkage 8 R Field link and sequence number 513 R TYPE OF REPORT AND PERIOD COVERED NOTE ind1 blank Undefined ind2 blank Undefined a NR Type of report b NR Period covered 6 NR Linkage 8 R Field link and sequence number 514 NR DATA QUALITY NOTE ind1 blank Undefined ind2 blank Undefined a NR Attribute accuracy report b R Attribute accuracy value c R Attribute accuracy explanation d NR Logical consistency report e NR Completeness report f NR Horizontal position accuracy report g R Horizontal position accuracy value h R Horizontal position accuracy explanation i NR Vertical positional accuracy report j R Vertical positional accuracy value k R Vertical positional accuracy explanation m NR Cloud cover u R Uniform Resource Identifier z R Display note 6 NR Linkage 8 R Field link and sequence number 515 R NUMBERING PECULIARITIES NOTE ind1 blank Undefined ind2 blank Undefined a NR Numbering peculiarities note 6 NR Linkage 8 R Field link and sequence number 516 R TYPE OF COMPUTER FILE OR DATA NOTE ind1 b8 Display constant controller ind2 blank Undefined a NR Type of computer file or data note 6 NR Linkage 8 R Field link and sequence number 518 R DATE/TIME AND PLACE OF AN EVENT NOTE ind1 blank Undefined ind2 blank Undefined a NR Date/time and place of an event note 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 520 R SUMMARY, ETC. ind1 b012348 Display constant controller ind2 blank Undefined a NR Summary, etc. note b NR Expansion of summary note c NR Assigning agency u R Uniform Resource Identifier 2 NR Source 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 521 R TARGET AUDIENCE NOTE ind1 b012348 Display constant controller ind2 blank Undefined a R Target audience note b NR Source 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 522 R GEOGRAPHIC COVERAGE NOTE ind1 b8 Display constant controller ind2 blank Undefined a NR Geographic coverage note 6 NR Linkage 8 R Field link and sequence number 524 R PREFERRED CITATION OF DESCRIBED MATERIALS NOTE ind1 b8 Display constant controller ind2 blank Undefined a NR Preferred citation of described materials note 2 NR Source of schema used 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 525 R SUPPLEMENT NOTE ind1 blank Undefined ind2 blank Undefined a NR Supplement note 6 NR Linkage 8 R Field link and sequence number 526 R STUDY PROGRAM INFORMATION NOTE ind1 08 Display constant controller ind2 blank Undefined a NR Program name b NR Interest level c NR Reading level d NR Title point value i NR Display text x R Nonpublic note z R Public note 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 530 R ADDITIONAL PHYSICAL FORM AVAILABLE NOTE ind1 blank Undefined ind2 blank Undefined a NR Additional physical form available note b NR Availability source c NR Availability conditions d NR Order number u R Uniform Resource Identifier 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 533 R REPRODUCTION NOTE ind1 blank Undefined ind2 blank Undefined a NR Type of reproduction b R Place of reproduction c R Agency responsible for reproduction d NR Date of reproduction e NR Physical description of reproduction f R Series statement of reproduction m R Dates and/or sequential designation of issues reproduced n R Note about reproduction 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 7 NR Fixed-length data elements of reproduction 8 R Field link and sequence number 534 R ORIGINAL VERSION NOTE ind1 blank Undefined ind2 blank Undefined a NR Main entry of original b NR Edition statement of original c NR Publication, distribution, etc. of original e NR Physical description, etc. of original f R Series statement of original k R Key title of original l NR Location of original m NR Material specific details n R Note about original o R Other resource identifier p NR Introductory phrase t NR Title statement of original x R International Standard Serial Number z R International Standard Book Number 6 NR Linkage 8 R Field link and sequence number 535 R LOCATION OF ORIGINALS/DUPLICATES NOTE ind1 12 Additional information about custodian ind2 blank Undefined a NR Custodian b R Postal address c R Country d R Telecommunications address g NR Repository location code 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 536 R FUNDING INFORMATION NOTE ind1 blank Undefined ind2 blank Undefined a NR Text of note b R Contract number c R Grant number d R Undifferentiated number e R Program element number f R Project number g R Task number h R Work unit number 6 NR Linkage 8 R Field link and sequence number 538 R SYSTEM DETAILS NOTE ind1 blank Undefined ind2 blank Undefined a NR System details note i NR Display text u R Uniform Resource Identifier 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 540 R TERMS GOVERNING USE AND REPRODUCTION NOTE ind1 blank Undefined ind2 blank Undefined a NR Terms governing use and reproduction b NR Jurisdiction c NR Authorization d NR Authorized users u R Uniform Resource Identifier 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 541 R IMMEDIATE SOURCE OF ACQUISITION NOTE ind1 b01 Undefined ind2 blank Undefined a NR Source of acquisition b NR Address c NR Method of acquisition d NR Date of acquisition e NR Accession number f NR Owner h NR Purchase price n R Extent o R Type of unit 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 542 R INFORMATION RELATING TO COPYRIGHT STATUS ind1 b01 Relationship ind2 blank Undefined a NR Personal creator b NR Personal creator death date c NR Corporate creator d R Copyright holder e R Copyright holder contact information f R Copyright statement g NR Copyright date h R Copyright renewal date i NR Publication date j NR Creation date k R Publisher l NR Copyright status m NR Publication status n R Note o NR Research date q NR Assigning agency r NR Jurisdiction of copyright assessment s NR Source of information u R Uniform Resource Identifier 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 544 R LOCATION OF OTHER ARCHIVAL MATERIALS NOTE ind1 b01 Relationship ind2 blank Undefined a R Custodian b R Address c R Country d R Title e R Provenance n R Note 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 545 R BIOGRAPHICAL OR HISTORICAL DATA ind1 b01 Type of data ind2 blank Undefined a NR Biographical or historical note b NR Expansion u R Uniform Resource Identifier 6 NR Linkage 8 R Field link and sequence number 546 R LANGUAGE NOTE ind1 blank Undefined ind2 blank Undefined a NR Language note b R Information code or alphabet 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 547 R FORMER TITLE COMPLEXITY NOTE ind1 blank Undefined ind2 blank Undefined a NR Former title complexity note 6 NR Linkage 8 R Field link and sequence number 550 R ISSUING BODY NOTE ind1 blank Undefined ind2 blank Undefined a NR Issuing body note 6 NR Linkage 8 R Field link and sequence number 552 R ENTITY AND ATTRIBUTE INFORMATION NOTE ind1 blank Undefined ind2 blank Undefined a NR Entity type label b NR Entity type definition and source c NR Attribute label d NR Attribute definition and source e R Enumerated domain value f R Enumerated domain value definition and source g NR Range domain minimum and maximum h NR Codeset name and source i NR Unrepresentable domain j NR Attribute units of measurement and resolution k NR Beginning date and ending date of attribute values l NR Attribute value accuracy m NR Attribute value accuracy explanation n NR Attribute measurement frequency o R Entity and attribute overview p R Entity and attribute detail citation u R Uniform Resource Identifier z R Display note 6 NR Linkage 8 R Field link and sequence number 555 R CUMULATIVE INDEX/FINDING AIDS NOTE ind1 b08 Display constant controller ind2 blank Undefined a NR Cumulative index/finding aids note b R Availability source c NR Degree of control d NR Bibliographic reference u R Uniform Resource Identifier 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 556 R INFORMATION ABOUT DOCUMENTATION NOTE ind1 b8 Display constant controller ind2 blank Undefined a NR Information about documentation note z R International Standard Book Number 6 NR Linkage 8 R Field link and sequence number 561 R OWNERSHIP AND CUSTODIAL HISTORY ind1 b01 Undefined ind2 blank Undefined a NR History 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 562 R COPY AND VERSION IDENTIFICATION NOTE ind1 blank Undefined ind2 blank Undefined a R Identifying markings b R Copy identification c R Version identification d R Presentation format e R Number of copies 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 563 R BINDING INFORMATION ind1 blank Undefined ind2 blank Undefined a NR Binding note u R Uniform Resource Identifier 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 565 R CASE FILE CHARACTERISTICS NOTE ind1 b08 Display constant controller ind2 blank Undefined a NR Number of cases/variables b R Name of variable c R Unit of analysis d R Universe of data e R Filing scheme or code 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 567 R METHODOLOGY NOTE ind1 b8 Display constant controller ind2 blank Undefined a NR Methodology note 6 NR Linkage 8 R Field link and sequence number 580 R LINKING ENTRY COMPLEXITY NOTE ind1 blank Undefined ind2 blank Undefined a NR Linking entry complexity note 6 NR Linkage 8 R Field link and sequence number 581 R PUBLICATIONS ABOUT DESCRIBED MATERIALS NOTE ind1 b8 Display constant controller ind2 blank Undefined a NR Publications about described materials note z R International Standard Book Number 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 583 R ACTION NOTE ind1 b01 Undefined ind2 blank Undefined a NR Action b R Action identification c R Time/date of action d R Action interval e R Contingency for action f R Authorization h R Jurisdiction i R Method of action j R Site of action k R Action agent l R Status n R Extent o R Type of unit u R Uniform Resource Identifier x R Nonpublic note z R Public note 2 NR Source of term 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 584 R ACCUMULATION AND FREQUENCY OF USE NOTE ind1 blank Undefined ind2 blank Undefined a R Accumulation b R Frequency of use 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 585 R EXHIBITIONS NOTE ind1 blank Undefined ind2 blank Undefined a NR Exhibitions note 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 586 R AWARDS NOTE ind1 b8 Display constant controller ind2 blank Undefined a NR Awards note 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 600 R SUBJECT ADDED ENTRY--PERSONAL NAME ind1 013 Type of personal name entry element ind2 01234567 Thesaurus a NR Personal name b NR Numeration c R Titles and other words associated with a name d NR Dates associated with a name e R Relator term f NR Date of a work g NR Miscellaneous information h NR Medium j R Attribution qualifier k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work q NR Fuller form of name r NR Key for music s NR Version t NR Title of a work u NR Affiliation v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 610 R SUBJECT ADDED ENTRY--CORPORATE NAME ind1 012 Type of corporate name entry element ind2 01234567 Thesaurus a NR Corporate name or jurisdiction name as entry element b R Subordinate unit c NR Location of meeting d R Date of meeting or treaty signing e R Relator term f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section/meeting o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version t NR Title of a work u NR Affiliation v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 611 R SUBJECT ADDED ENTRY--MEETING NAME ind1 012 Type of meeting name entry element ind2 01234567 Thesaurus a NR Meeting name or jurisdiction name as entry element c NR Location of meeting d NR Date of meeting e R Subordinate unit f NR Date of a work g NR Miscellaneous information h NR Medium j R Relator term k R Form subheading l NR Language of a work n R Number of part/section/meeting p R Name of part/section of a work q NR Name of meeting following jurisdiction name entry element s NR Version t NR Title of a work u NR Affiliation v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 630 R SUBJECT ADDED ENTRY--UNIFORM TITLE ind1 0-9 Nonfiling characters ind2 01234567 Thesaurus a NR Uniform title d R Date of treaty signing e R Relator term f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version t NR Title of a work v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 648 R SUBJECT ADDED ENTRY--CHRONOLOGICAL TERM ind1 blank Undefined ind2 01234567 Thesaurus a NR Chronological term v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 650 R SUBJECT ADDED ENTRY--TOPICAL TERM ind1 b012 Level of subject ind2 01234567 Thesaurus a NR Topical term or geographic name as entry element b NR Topical term following geographic name as entry element c NR Location of event d NR Active dates e NR Relator term v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 651 R SUBJECT ADDED ENTRY--GEOGRAPHIC NAME ind1 blank Undefined ind2 01234567 Thesaurus a NR Geographic name e R Relator term v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 653 R INDEX TERM--UNCONTROLLED ind1 b012 Level of index term ind2 b0123456 Type of term or name a R Uncontrolled term 6 NR Linkage 8 R Field link and sequence number 654 R SUBJECT ADDED ENTRY--FACETED TOPICAL TERMS ind1 b012 Level of subject ind2 blank Undefined a R Focus term b R Non-focus term c R Facet/hierarchy designation e R Relator term v R Form subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 655 R INDEX TERM--GENRE/FORM ind1 b0 Type of heading ind2 01234567 Thesaurus a NR Genre/form data or focus term b R Non-focus term c R Facet/hierarchy designation v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of term 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 656 R INDEX TERM--OCCUPATION ind1 blank Undefined ind2 7 Source of term a NR Occupation k NR Form v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of term 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 657 R INDEX TERM--FUNCTION ind1 blank Undefined ind2 7 Source of term a NR Function v R Form subdivision x R General subdivision y R Chronological subdivision z R Geographic subdivision 0 R Authority record control number 2 NR Source of term 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 658 R INDEX TERM--CURRICULUM OBJECTIVE ind1 blank Undefined ind2 blank Undefined a NR Main curriculum objective b R Subordinate curriculum objective c NR Curriculum code d NR Correlation factor 2 NR Source of term or code 6 NR Linkage 8 R Field link and sequence number 662 R SUBJECT ADDED ENTRY--HIERARCHICAL PLACE NAME ind1 blank Undefined ind2 blank Undefined a R Country or larger entity b NR First-order political jurisdiction c R Intermediate political jurisdiction d NR City e R Relator term f R City subsection g R Other nonjurisdictional geographic region and feature h R Extraterrestrial area 0 R Authority record control number 2 NR Source of heading or term 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 700 R ADDED ENTRY--PERSONAL NAME ind1 013 Type of personal name entry element ind2 b2 Type of added entry a NR Personal name b NR Numeration c R Titles and other words associated with a name d NR Dates associated with a name e R Relator term f NR Date of a work g NR Miscellaneous information h NR Medium j R Attribution qualifier k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work q NR Fuller form of name r NR Key for music s NR Version t NR Title of a work u NR Affiliation x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 4 R Relator code 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 710 R ADDED ENTRY--CORPORATE NAME ind1 012 Type of corporate name entry element ind2 b2 Type of added entry a NR Corporate name or jurisdiction name as entry element b R Subordinate unit c NR Location of meeting d R Date of meeting or treaty signing e R Relator term f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section/meeting o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version t NR Title of a work u NR Affiliation x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 4 R Relator code 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 711 R ADDED ENTRY--MEETING NAME ind1 012 Type of meeting name entry element ind2 b2 Type of added entry a NR Meeting name or jurisdiction name as entry element c NR Location of meeting d NR Date of meeting e R Subordinate unit f NR Date of a work g NR Miscellaneous information h NR Medium j R Relator term k R Form subheading l NR Language of a work n R Number of part/section/meeting p R Name of part/section of a work q NR Name of meeting following jurisdiction name entry element s NR Version t NR Title of a work u NR Affiliation x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 4 R Relator code 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 720 R ADDED ENTRY--UNCONTROLLED NAME ind1 b12 Type of name ind2 blank Undefined a NR Name e R Relator term 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 730 R ADDED ENTRY--UNIFORM TITLE ind1 0-9 Nonfiling characters ind2 b2 Type of added entry a NR Uniform title d R Date of treaty signing f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version t NR Title of a work x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 740 R ADDED ENTRY--UNCONTROLLED RELATED/ANALYTICAL TITLE ind1 0-9 Nonfiling characters ind2 b2 Type of added entry a NR Uncontrolled related/analytical title h NR Medium n R Number of part/section of a work p R Name of part/section of a work 5 NR Institution to which field applies 6 NR Linkage 8 R Field link and sequence number 751 R ADDED ENTRY--GEOGRAPHIC NAME ind1 blank Undefined ind2 blank Undefined a NR Geographic name e R Relator term 0 R Authority record control number 2 NR Source of heading or term 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 752 R ADDED ENTRY--HIERARCHICAL PLACE NAME ind1 blank Undefined ind2 blank Undefined a NR Country or larger entity b NR First-order political jurisdiction c NR Intermediate political jurisdiction d NR City f R City subsection g R Other nonjurisdictional geographic region and feature h R Extraterrestrial area 0 R Authority record control number 2 NR Source of heading or term 6 NR Linkage 8 R Field link and sequence number 753 R SYSTEM DETAILS ACCESS TO COMPUTER FILES ind1 blank Undefined ind2 blank Undefined a NR Make and model of machine b NR Programming language c NR Operating system 6 NR Linkage 8 R Field link and sequence number 754 R ADDED ENTRY--TAXONOMIC IDENTIFICATION ind1 blank Undefined ind2 blank Undefined a R Taxonomic name c R Taxonomic category d R Common or alternative name x R Non-public note z R Public note 0 R Authority record control number 2 NR Source of taxonomic identification 6 NR Linkage 8 R Field link and sequence number 760 R MAIN SERIES ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text m NR Material-specific details n R Note o R Other item identifier s NR Uniform title t NR Title w R Record control number x NR International Standard Serial Number y NR CODEN designation 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 762 R SUBSERIES ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text m NR Material-specific details n R Note o R Other item identifier s NR Uniform title t NR Title w R Record control number x NR International Standard Serial Number y NR CODEN designation 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 765 R ORIGINAL LANGUAGE ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 767 R TRANSLATION ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 770 R SUPPLEMENT/SPECIAL ISSUE ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 772 R SUPPLEMENT PARENT ENTRY ind1 01 Note controller ind2 b08 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Stan dard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 773 R HOST ITEM ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier p NR Abbreviated title q NR Enumeration and first page r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 3 NR Materials specified 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 774 R CONSTITUENT UNIT ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 775 R OTHER EDITION ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication e NR Language code f NR Country code g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 776 R ADDITIONAL PHYSICAL FORM ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 777 R ISSUED WITH ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier s NR Uniform title t NR Title w R Record control number x NR International Standard Serial Number y NR CODEN designation 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 780 R PRECEDING ENTRY ind1 01 Note controller ind2 01234567 Type of relationship a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 785 R SUCCEEDING ENTRY ind1 01 Note controller ind2 012345678 Type of relationship a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standa rd Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 786 R DATA SOURCE ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text j NR Period of content k R Series data for related item m NR Material-specific details n R Note o R Other item identifier p NR Abbreviated title r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number v NR Source Contribution w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 787 R NONSPECIFIC RELATIONSHIP ENTRY ind1 01 Note controller ind2 b8 Display constant controller a NR Main entry heading b NR Edition c NR Qualifying information d NR Place, publisher, and date of publication g R Relationship information h NR Physical description i NR Display text k R Series data for related item m NR Material-specific details n R Note o R Other item identifier r R Report number s NR Uniform title t NR Title u NR Standard Technical Report Number w R Record control number x NR International Standard Serial Number y NR CODEN designation z R International Standard Book Number 6 NR Linkage 7 NR Control subfield 8 R Field link and sequence number 800 R SERIES ADDED ENTRY--PERSONAL NAME ind1 013 Type of personal name entry element ind2 blank Undefined a NR Personal name b NR Numeration c R Titles and other words associated with a name d NR Dates associated with a name e R Relator term f NR Date of a work g NR Miscellaneous information h NR Medium j R Attribution qualifier k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work q NR Fuller form of name r NR Key for music s NR Version t NR Title of a work u NR Affiliation v NR Volume/sequential designation w R Bibliographic record control number x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 810 R SERIES ADDED ENTRY--CORPORATE NAME ind1 012 Type of corporate name entry element ind2 blank Undefined a NR Corporate name or jurisdiction name as entry element b R Subordinate unit c NR Location of meeting d R Date of meeting or treaty signing e R Relator term f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section/meeting o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version t NR Title of a work u NR Affiliation v NR Volume/sequential designation w R Bibliographic record control number x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 811 R SERIES ADDED ENTRY--MEETING NAME ind1 012 Type of meeting name entry element ind2 blank Undefined a NR Meeting name or jurisdiction name as entry element c NR Location of meeting d NR Date of meeting e R Subordinate unit f NR Date of a work g NR Miscellaneous information h NR Medium j R Relator term k R Form subheading l NR Language of a work n R Number of part/section/meeting p R Name of part/section of a work q NR Name of meeting following jurisdiction name entry element s NR Version t NR Title of a work u NR Affiliation v NR Volume/sequential designation w R Bibliographic record control number x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 4 R Relator code 6 NR Linkage 8 R Field link and sequence number 830 R SERIES ADDED ENTRY--UNIFORM TITLE ind1 blank Undefined ind2 0-9 Nonfiling characters a NR Uniform title d R Date of treaty signing f NR Date of a work g NR Miscellaneous information h NR Medium k R Form subheading l NR Language of a work m R Medium of performance for music n R Number of part/section of a work o NR Arranged statement for music p R Name of part/section of a work r NR Key for music s NR Version t NR Title of a work v NR Volume/sequential designation w R Bibliographic record control number x NR International Standard Serial Number 0 R Authority record control number 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 841 NR HOLDINGS CODED DATA VALUES 842 NR TEXTUAL PHYSICAL FORM DESIGNATOR 843 R REPRODUCTION NOTE 844 NR NAME OF UNIT 845 R TERMS GOVERNING USE AND REPRODUCTION NOTE 850 R HOLDING INSTITUTION ind1 blank Undefined ind2 blank Undefined a R Holding institution 8 R Field link and sequence number 852 R LOCATION ind1 b012345678 Shelving scheme ind2 b012 Shelving order a NR Location b R Sublocation or collection c R Shelving location d R Former shelving location e R Address f R Coded location qualifier g R Non-coded location qualifier h NR Classification part i R Item part j NR Shelving control number k R Call number prefix l NR Shelving form of title m R Call number suffix n NR Country code p NR Piece designation q NR Piece physical condition s R Copyright article-fee code t NR Copy number u R Uniform Resource Identifier x R Nonpublic note z R Public note 2 NR Source of classification or shelving scheme 3 NR Materials specified 6 NR Linkage 8 NR Sequence number 853 R CAPTIONS AND PATTERN--BASIC BIBLIOGRAPHIC UNIT 854 R CAPTIONS AND PATTERN--SUPPLEMENTARY MATERIAL 855 R CAPTIONS AND PATTERN--INDEXES 856 R ELECTRONIC LOCATION AND ACCESS ind1 b012347 Access method ind2 b0128 Relationship a R Host name b R Access number c R Compression information d R Path f R Electronic name h NR Processor of request i R Instruction j NR Bits per second k NR Password l NR Logon m R Contact for access assistance n NR Name of location of host o NR Operating system p NR Port q NR Electronic format type r NR Settings s R File size t R Terminal emulation u R Uniform Resource Identifier v R Hours access method available w R Record control number x R Nonpublic note y R Link text z R Public note 2 NR Access method 3 NR Materials specified 6 NR Linkage 8 R Field link and sequence number 863 R ENUMERATION AND CHRONOLOGY--BASIC BIBLIOGRAPHIC UNIT 864 R ENUMERATION AND CHRONOLOGY--SUPPLEMENTARY MATERIAL 865 R ENUMERATION AND CHRONOLOGY--INDEXES 866 R TEXTUAL HOLDINGS--BASIC BIBLIOGRAPHIC UNIT 867 R TEXTUAL HOLDINGS--SUPPLEMENTARY MATERIAL 868 R TEXTUAL HOLDINGS--INDEXES 876 R ITEM INFORMATION--BASIC BIBLIOGRAPHIC UNIT 877 R ITEM INFORMATION--SUPPLEMENTARY MATERIAL 878 R ITEM INFORMATION--INDEXES 880 R ALTERNATE GRAPHIC REPRESENTATION ind1 Same as associated field ind2 Same as associated field 6 NR Linkage 882 NR REPLACEMENT RECORD INFORMATION ind1 blank Undefined ind2 blank Undefined a R Replacement title i R Explanatory text w R Replacement bibliographic record control number 6 NR Linkage 8 R Field link and sequence number 886 R FOREIGN MARC INFORMATION FIELD ind1 012 Type of field ind2 blank Undefined a NR Tag of the foreign MARC field b NR Content of the foreign MARC field c-z NR Foreign MARC subfield 0-1 NR Foreign MARC subfield 2 NR Source of data 4 NR Source of data 3-9 NR Source of data 887 R NON-MARC INFORMATION FIELD ind1 blank Undefined ind2 blank Undefined a NR Content of non-MARC field 2 NR Source of data RULES; // @codingStandardsIgnoreEnd } // }}} } // }}}	128.67 KB	2024-07-17 10:10
📄 List.php <?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 "php-marc", * that is part of the Emilda Project (http://www.emilda.org). Christoffer * Landtman generously agreed to make the "php-marc" 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 <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @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 Structures_LinkedList_Double /* * The File_MARC_List class extends the Structures_LinkedList_Double 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. * * <code> * // Iterate through the fields in a record with key=>value iteration * foreach ($record->getFields() as $tag=>$value) { * print "$tag: "; * if ($value instanceof File_MARC_Control_Field) { * print $value->getData(); * } * else { * // Iterate through the subfields in this data field * foreach ($value->getSubfields() as $code=>$subdata) { * print "_$code"; * } * } * print "\n"; * } * </code> * * @category File_Formats * @package File_MARC * @author Dan Scott <dscott@laurentian.ca> * @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 Structures_LinkedList_Double { // {{{ 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->current() instanceof File_MARC_Field) { return $this->current()->getTag(); } elseif ($this->current() instanceof File_MARC_Subfield) { return $this->current()->getCode(); } return false; } // }}} } // }}}	3.41 KB	2024-07-17 10:10
📄 Record.php <?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 "php-marc", * that is part of the Emilda Project (http://www.emilda.org). Christoffer * Landtman generously agreed to make the "php-marc" 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 <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @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_Record /* * Represents a single MARC record * * A MARC record contains a leader and zero or more fields held within a * linked list structure. Fields are represented by {@link File_MARC_Data_Field} * objects. * * @category File_Formats * @package File_MARC * @author Christoffer Landtman <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @link http://pear.php.net/package/File_MARC / class File_MARC_Record { // {{{ properties /* * Contains a linked list of {@link File_MARC_Data_Field} objects for * this record * @var File_MARC_List / protected $fields; /* * Record leader * @var string / protected $leader; /* * Non-fatal warnings generated during parsing * @var array / protected $warnings; /* * XMLWriter for writing collections * * @var XMLWriter / protected $marcxml; /* * MARC instance for access to the XML header/footer methods * We need this so that we can properly wrap a collection of MARC records. * * @var File_MARC / protected $marc; // }}} // {{{ Constructor: function __construct() /* * Start function * * Set all variables to defaults to create new File_MARC_Record object * * @param File_MARC $marc MARC record from File_MARC or File_MARCXML * * @return true / function __construct($marc = null) { $this->fields = new File_MARC_List(); $this->setLeader(str_repeat(' ', 24)); if (!$marc) { $marc = new File_MARC(null, File_MARC::SOURCE_STRING); // oh the hack } $this->marc = $marc; $this->marcxml = $marc->getXMLWriter(); } // }}} // {{{ Destructor: function __destruct() /* * Destroys the data field / function __destruct() { $this->fields = null; $this->warnings = null; } // }}} // {{{ getLeader() /* * Get MARC leader * * Returns the leader for the MARC record. No validation * on the specified leader is performed. * * @return string returns the leader / function getLeader() { return (string)$this->leader; } // }}} // {{{ setLeader() /* * Set MARC record leader * * Sets the leader for the MARC record. No validation * on the specified leader is performed. * * @param string $leader Leader * * @return string returns the leader / function setLeader($leader) { $this->leader = $leader; return $this->leader; } // }}} // {{{ appendField() /* * Appends field to MARC record * * Adds a {@link File_MARC_Control_Field} or {@link File_MARC_Data_Field} * object to the end of the existing list of fields. * * @param File_MARC_Field $new_field The field to add * * @return File_MARC_Field The field that was added / function appendField(File_MARC_Field $new_field) { / Append as the last field in the record / $this->fields->appendNode($new_field); return $new_field; } // }}} // {{{ prependField() /* * Prepends field to MARC record * * Adds a {@link File_MARC_Control_Field} or {@link File_MARC_Data_Field} * object to the start of to the existing list of fields. * * @param File_MARC_Field $new_field The field to add * * @return File_MARC_Field The field that was added / function prependField(File_MARC_Field $new_field) { $this->fields->prependNode($new_field); return $new_field; } // }}} // {{{ insertField() /* * Inserts a field in the MARC record relative to an existing field * * Inserts a {@link File_MARC_Control_Field} or {@link File_MARC_Data_Field} * object before or after a specified existing field. * * <code> * // Example: Insert a new field before the first 650 field * * // Create the new field * $subfields[] = new File_MARC_Subfield('a', 'Scott, Daniel.'); * $new_field = new File_MARC_Data_Field('100', $subfields, 0, null); * * // Retrieve the target field for our insertion point * $subject = $record->getFields('650'); * * // Insert the new field * if (is_array($subject)) { * $record->insertField($new_field, $subject[0], true); * } * elseif ($subject) { * $record->insertField($new_field, $subject, true); * } * </code> * * @param File_MARC_Field $new_field The field to add * @param File_MARC_Field $existing_field The target field * @param bool $before Insert the new field before the existing field if true, after the existing field if false * * @return File_MARC_Field The field that was added / function insertField(File_MARC_Field $new_field, File_MARC_Field $existing_field, $before = false) { switch ($before) { / Insert before the specified field in the record / case true: $this->fields->insertNode($new_field, $existing_field, true); break; / Insert after the specified field in the record / case false: $this->fields->insertNode($new_field, $existing_field); break; default: $errorMessage = File_MARC_Exception::formatError(File_MARC_Exception::$messages[File_MARC_Exception::ERROR_INSERTFIELD_MODE], array("mode" => $before)); throw new File_MARC_Exception($errorMessage, File_MARC_Exception::ERROR_INSERTFIELD_MODE); } return $new_field; } // }}} // {{{ _buildDirectory() /* * Build record directory * * Generate the directory of the record according to the current contents * of the record. * * @return array Array ($fields, $directory, $total, $base_address) / private function _buildDirectory() { // Vars $fields = array(); $directory = array(); $data_end = 0; foreach ($this->fields as $field) { // No empty fields allowed if (!$field->isEmpty()) { // Get data in raw format $str = $field->toRaw(); $fields[] = $str; // Create directory entry $len = strlen($str); $direntry = sprintf("%03s%04d%05d", $field->getTag(), $len, $data_end); $directory[] = $direntry; $data_end += $len; } } /* * Rules from MARC::Record::USMARC / $base_address = File_MARC::LEADER_LEN + // better be 24 (count($directory) File_MARC::DIRECTORY_ENTRY_LEN) + // all the directory entries 1; // end-of-field marker $total = $base_address + // stuff before first field $data_end + // Length of the fields 1; // End-of-record marker return array($fields, $directory, $total, $base_address); } // }}} // {{{ setLeaderLengths() /** * Set MARC record leader lengths * * Set the Leader lengths of the record according to defaults specified in * {@link http://www.loc.gov/marc/bibliographic/ecbdldrd.html} * * @param int $record_length Record length * @param int $base_address Base address of data * * @return bool Success or failure / function setLeaderLengths($record_length, $base_address) { if (!is_int($record_length)) { return false; } if (!is_int($base_address)) { return false; } // Set record length $this->setLeader(substr_replace($this->getLeader(), sprintf("%05d", $record_length), 0, 5)); $this->setLeader(substr_replace($this->getLeader(), sprintf("%05d", $base_address), File_MARC::DIRECTORY_ENTRY_LEN, 5)); $this->setLeader(substr_replace($this->getLeader(), '22', 10, 2)); $this->setLeader(substr_replace($this->getLeader(), '4500', 20, 4)); if (strlen($this->getLeader()) > File_MARC::LEADER_LEN) { // Avoid incoming leaders that are mangled to be overly long $this->setLeader(substr($this->getLeader(), 0, File_MARC::LEADER_LEN)); $this->addWarning("Input leader was too long; truncated to " . File_MARC::LEADER_LEN . " characters"); } return true; } // }}} // {{{ getField() /* * Return the first {@link File_MARC_Data_Field} or * {@link File_MARC_Control_Field} object that matches the specified tag * name. Returns false if no match is found. * * @param string $spec tag name * @param bool $pcre if true, then match as a regular expression * * @return {@link File_MARC_Data_Field}\|{@link File_MARC_Control_Field} first field that matches the requested tag name / function getField($spec = null, $pcre = null) { foreach ($this->fields as $field) { if (($pcre && preg_match("/$spec/", $field->getTag())) \|\| (!$pcre && $spec == $field->getTag()) ) { return $field; } } return false; } // }}} // {{{ getFields() /* * Return an array or {@link File_MARC_List} containing all * {@link File_MARC_Data_Field} or {@link File_MARC_Control_Field} objects * that match the specified tag name. If the tag name is omitted all * fields are returned. * * @param string $spec tag name * @param bool $pcre if true, then match as a regular expression * * @return File_MARC_List\|array {@link File_MARC_Data_Field} or * {@link File_MARC_Control_Field} objects that match the requested tag name / function getFields($spec = null, $pcre = null) { if (!$spec) { return $this->fields; } // Okay, we're actually looking for something specific $matches = array(); foreach ($this->fields as $field) { if (($pcre && preg_match("/$spec/", $field->getTag())) \|\| (!$pcre && $spec == $field->getTag()) ) { $matches[] = $field; } } return $matches; } // }}} // {{{ deleteFields() /* * Delete all occurrences of a field matching a tag name from the record. * * @param string $tag tag for the fields to be deleted * @param bool $pcre if true, then match as a regular expression * * @return int number of fields that were deleted / function deleteFields($tag, $pcre = null) { $cnt = 0; foreach ($this->getFields() as $field) { if (($pcre && preg_match("/$tag/", $field->getTag())) \|\| (!$pcre && $tag == $field->getTag()) ) { $field->delete(); $cnt++; } } return $cnt; } // }}} // {{{ addWarning() /* * Add a warning to the MARC record that something non-fatal occurred during * parsing. * * @param string $warning warning message * * @return true / public function addWarning($warning) { $this->warnings[] = $warning; } // }}} // {{{ getWarnings() /* * Return the array of warnings from the MARC record. * * @return array warning messages / public function getWarnings() { return $this->warnings; } // }}} // {{{ output methods /* * ========== OUTPUT METHODS ========== / // {{{ toRaw() /* * Return the record in raw MARC format. * * If you have modified an existing MARC record or created a new MARC * record, use this method to save the record for use in other programs * that accept the MARC format -- for example, your integrated library * system. * * <code> * // Example: Modify a record and save the output to a file * $record->deleteFields('650'); * * // Now that the record has no subject fields, save it to disk * fopen($file, '/home/dan/no_subject.mrc', 'w'); * fwrite($file, $record->toRaw()); * fclose($file); * </code> * * @return string Raw MARC data / function toRaw() { list($fields, $directory, $record_length, $base_address) = $this->_buildDirectory(); $this->setLeaderLengths($record_length, $base_address); /* * Glue together all parts / return $this->getLeader().implode("", $directory).File_MARC::END_OF_FIELD.implode("", $fields).File_MARC::END_OF_RECORD; } // }}} // {{{ __toString() /* * Return the MARC record in a pretty printed string * * This method produces an easy-to-read textual display of a MARC record. * * The structure is roughly: * <tag> <ind1> <ind2> _<code><data> * _<code><data> * * @return string Formatted representation of MARC record / function __toString() { // Begin output $formatted = "LDR " . $this->getLeader() . "\n"; foreach ($this->fields as $field) { if (!$field->isEmpty()) { $formatted .= $field->__toString() . "\n"; } } return $formatted; } // }}} // {{{ toJSON() /* * Return the MARC record in JSON format * * This method produces a JSON representation of a MARC record. The input * encoding must be UTF8, otherwise the returned values will be corrupted. * * @return string representation of MARC record in JSON format * * @todo Fix encoding input / output issues (PHP 6.0 required?) / function toJSON() { $json = new StdClass(); $json->leader = utf8_encode($this->getLeader()); / Start fields / $fields = array(); foreach ($this->fields as $field) { if (!$field->isEmpty()) { switch(get_class($field)) { case "File_MARC_Control_Field": $fields[] = array(utf8_encode($field->getTag()) => utf8_encode($field->getData())); break; case "File_MARC_Data_Field": $subs = array(); foreach ($field->getSubfields() as $sf) { $subs[] = array(utf8_encode($sf->getCode()) => utf8_encode($sf->getData())); } $contents = new StdClass(); $contents->ind1 = utf8_encode($field->getIndicator(1)); $contents->ind2 = utf8_encode($field->getIndicator(2)); $contents->subfields = $subs; $fields[] = array(utf8_encode($field->getTag()) => $contents); break; } } } / End fields and record / $json->fields = $fields; return json_encode($json); } // }}} // {{{ toJSONHash() /* * Return the MARC record in Bill Dueber's MARC-HASH JSON format * * This method produces a JSON representation of a MARC record as defined * at http://robotlibrarian.billdueber.com/new-interest-in-marc-hash-json/ * The input * encoding must be UTF8, otherwise the returned values will * be corrupted. * * @return string representation of MARC record in JSON format * * @todo Fix encoding input / output issues (PHP 6.0 required?) / function toJSONHash() { $json = new StdClass(); $json->type = "marc-hash"; $json->version = array(1, 0); $json->leader = utf8_encode($this->getLeader()); / Start fields / $fields = array(); foreach ($this->fields as $field) { if (!$field->isEmpty()) { switch(get_class($field)) { case "File_MARC_Control_Field": $fields[] = array(utf8_encode($field->getTag()), utf8_encode($field->getData())); break; case "File_MARC_Data_Field": $subs = array(); foreach ($field->getSubfields() as $sf) { $subs[] = array(utf8_encode($sf->getCode()), utf8_encode($sf->getData())); } $contents = array( utf8_encode($field->getTag()), utf8_encode($field->getIndicator(1)), utf8_encode($field->getIndicator(2)), $subs ); $fields[] = $contents; break; } } } / End fields and record / $json->fields = $fields; return json_encode($json); } // }}} // {{{ toXML() /* * Return the MARC record in MARCXML format * * This method produces an XML representation of a MARC record that * attempts to adhere to the MARCXML standard documented at * http://www.loc.gov/standards/marcxml/ * * @param string $encoding output encoding for the MARCXML record * @param bool $indent pretty-print the MARCXML record * @param bool $single wrap the <record> element in a <collection> element * * @return string representation of MARC record in MARCXML format * * @todo Fix encoding input / output issues (PHP 6.0 required?) */ function toXML($encoding = "UTF-8", $indent = true, $single = true) { $this->marcxml->setIndent($indent); if ($single) { $this->marcxml->startElement("collection"); $this->marcxml->writeAttribute("xmlns", "http://www.loc.gov/MARC21/slim"); $this->marcxml->startElement("record"); } else { $this->marcxml->startElement("record"); $this->marcxml->writeAttribute("xmlns", "http://www.loc.gov/MARC21/slim"); } // MARCXML schema has some strict requirements // We'll set reasonable defaults to avoid invalid MARCXML $xmlLeader = $this->getLeader(); // Record status if ($xmlLeader[5] == " ") { // Default to "n" (new record) $xmlLeader[5] = "n"; } // Type of record if ($xmlLeader[6] == " ") { // Default to "a" (language material) $xmlLeader[6] = "a"; } $this->marcxml->writeElement("leader", $xmlLeader); foreach ($this->fields as $field) { if (!$field->isEmpty()) { switch(get_class($field)) { case "File_MARC_Control_Field": $this->marcxml->startElement("controlfield"); $this->marcxml->writeAttribute("tag", $field->getTag()); $this->marcxml->text($field->getData()); $this->marcxml->endElement(); // end control field break; case "File_MARC_Data_Field": $this->marcxml->startElement("datafield"); $this->marcxml->writeAttribute("tag", $field->getTag()); $this->marcxml->writeAttribute("ind1", $field->getIndicator(1)); $this->marcxml->writeAttribute("ind2", $field->getIndicator(2)); foreach ($field->getSubfields() as $subfield) { $this->marcxml->startElement("subfield"); $this->marcxml->writeAttribute("code", $subfield->getCode()); $this->marcxml->text($subfield->getData()); $this->marcxml->endElement(); // end subfield } $this->marcxml->endElement(); // end data field break; } } } $this->marcxml->endElement(); // end record if ($single) { $this->marcxml->endElement(); // end collection $this->marcxml->endDocument(); } return $this->marcxml->outputMemory(); } // }}} } // }}}	21.77 KB	2024-07-17 10:10
📄 Subfield.php <?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 "php-marc", * that is part of the Emilda Project (http://www.emilda.org). Christoffer * Landtman generously agreed to make the "php-marc" 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 <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @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_Subfield extends Structures_LinkedList_DoubleNode /* * The File_MARC_Subfield class represents a single subfield in a MARC * record field. * * Represents a subfield within a MARC field and implements all management * functions related to a single subfield. This class also implements * the possibility of duplicate subfields within a single field, for example * 650 _z Test1 _z Test2. * * @category File_Formats * @package File_MARC * @author Christoffer Landtman <landtman@realnode.com> * @author Dan Scott <dscott@laurentian.ca> * @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1 * @link http://pear.php.net/package/File_MARC / class File_MARC_Subfield extends Structures_LinkedList_DoubleNode { // {{{ properties /* * Subfield code, e.g. _a, _b * @var string / protected $code; /* * Data contained by the subfield * @var string / protected $data; // }}} // {{{ Constructor: function __construct() /* * File_MARC_Subfield constructor * * Create a new subfield to represent the code and data * * @param string $code Subfield code * @param string $data Subfield data / function __construct($code, $data) { $this->code = $code; $this->data = $data; } // }}} // {{{ Destructor: function __destruct() /* * Destroys the subfield / function __destruct() { $this->code = null; $this->data = null; parent::__destruct(); } // }}} // {{{ Explicit destructor: function delete() /* * Destroys the subfield * * @return true / function delete() { $this->__destruct(); } // }}} // {{{ getCode() /* * Return code of the subfield * * @return string Tag name / function getCode() { return (string)$this->code; } // }}} // {{{ getData() /* * Return data of the subfield * * @return string data / function getData() { return (string)$this->data; } // }}} // {{{ __toString() /* * Return string representation of subfield * * @return string String representation / public function __toString() { $pretty = '[' . $this->getCode() . ']: ' . $this->getData(); return $pretty; } // }}} // {{{ toRaw() /* * Return the USMARC representation of the subfield * * @return string USMARC representation / function toRaw() { $result = File_MARC::SUBFIELD_INDICATOR.$this->code.$this->data; return (string)$result; } // }}} // {{{ setCode() /* * Sets code of the subfield * * @param string $code new code for the subfield * * @return string code / function setCode($code) { if ($code) { // could check more stringently; m/[a-Z]/ or the likes $this->code = $code; } else { // code must be _something_; raise error return false; } return true; } // }}} // {{{ setData() /* * Sets data of the subfield * * @param string $data new data for the subfield * * @return string data / function setData($data) { $this->data = $data; return true; } // }}} // {{{ isEmpty() /* * Checks whether the subfield is empty or not * * @return bool True or false */ function isEmpty() { // There is data if ($this->data) { return false; } // There is no data return true; } // }}} } // }}}	5.23 KB	2024-07-17 10:10

Terminal