XML_RDDL::getResourcesByPurpose()

XML_RDDL::getResourcesByPurpose() -- selects all resources of a specified nature

概要

require_once 'XML/RDDL.php';

array XML_RDDL::getResourcesByPurpose (string $purpose)

説明

Gets all resources of a given purpose from an RDDL document. You have to call XML_RDDL::parseRDDL() first. The purpose of a resource is specified by the 'xlink:arcrole' attribute. The purpose of a resource link determines what the link will be used for. Frequently the purpose of a link can be determined from the nature of the referenced resource. For example the purpose of an XML Schema is typically schema validation, yet a schema may be comprised of a number of included modules and even when included modules are themselves an XML Schema, the purpose is as a module. You can find a list of well known purposes at http://www.rddl.org/purposes/.

パラメータ

返り値

array array containing all resources with the specified purpose.

注意

この関数は、スタティックにコールする ことはできません。

Usage example

例 58-1Getting all normative references


<?php
require_once "XML/RDDL.php";
// create new parser
$rddl   = &new XML_RDDL();
    
// parse a document that contains RDDL resources
$result = $rddl->parseRDDL('http://www.rddl.org');
// check for error
if (PEAR::isError($result)) {
    echo sprintf( "ERROR: %s (code %d)", $result->getMessage(), $result->getCode());
    exit;
}
// get all normative references
$ref = $rddl->getResourcesByPurpose('http://www.rddl.org/purposes#normative-reference');
echo "<pre>";
print_r($ref);
echo "</pre>";
?>