XMLReader::readとは何？わかりやすく解説 Weblio辞書

PHP関数リファレンス

索引トップ用語の索引ランキング

XMLReader::read

(PHP 5 >= 5.1.2)
XMLReader::read — ドキュメント内の次のノードに移動する

説明

class XMLReader {
bool read ( void )
} ドキュメント内の次のノードにカーソルを移動します。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

参考

XMLReader::moveToElement

XMLReader::moveToAttribute

XMLReader::next

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlReader.Read メソッド

派生クラスでオーバーライドされると、ストリームから次のノードを読み取ります。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 Read As Boolean

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As Boolean

returnValue = instance.Read

public abstract bool Read ()

C++

public:
virtual bool Read () abstract

public abstract boolean Read ()

JScript

public abstract function Read () : boolean

戻り値
次のノードが正常に読み取られた場合は true。それ以上読み取る対象となるノードが存在しない場合は false。

例外

例外の種類	条件
XmlException	XML の解析中にエラーが発生しました。

解説

XmlReader が最初に作成および初期化されたときは、使用できる情報はありません。Read を呼び出して、最初のノードを読み取る必要があります。

使用例

XML を読み込み、各ノードを表示する例を次に示します。

Visual Basic

reader.MoveToContent()
' Parse the file and display each of the nodes.
While reader.Read()
  Select Case reader.NodeType
    Case XmlNodeType.Element
      Console.Write("<{0}>", reader.Name)
    Case XmlNodeType.Text
      Console.Write(reader.Value)
    Case XmlNodeType.CDATA
      Console.Write("<![CDATA[{0}]]>", reader.Value)
    Case XmlNodeType.ProcessingInstruction
      Console.Write("<?{0} {1}?>", reader.Name,
 reader.Value)
    Case XmlNodeType.Comment
      Console.Write("<!--{0}-->", reader.Value)
    Case XmlNodeType.XmlDeclaration
      Console.Write("<?xml version='1.0'?>")
    Case XmlNodeType.Document
    Case XmlNodeType.DocumentType
      Console.Write("<!DOCTYPE {0} [{1}]", reader.Name,
 reader.Value)
    Case XmlNodeType.EntityReference
      Console.Write(reader.Name)
    Case XmlNodeType.EndElement
      Console.Write("</{0}>", reader.Name)
  End Select
End While

reader.MoveToContent();
  // Parse the file and display each of the nodes.
  while (reader.Read()) {
    switch (reader.NodeType) {
      case XmlNodeType.Element:
          Console.Write("<{0}>", reader.Name);
          break;
      case XmlNodeType.Text:
          Console.Write(reader.Value);
          break;
       case XmlNodeType.CDATA:
           Console.Write("<![CDATA[{0}]]>", reader.Value);
           break;
       case XmlNodeType.ProcessingInstruction:
           Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
           break;
       case XmlNodeType.Comment:
           Console.Write("<!--{0}-->", reader.Value);
           break;
       case XmlNodeType.XmlDeclaration:
           Console.Write("<?xml version='1.0'?>");
           break;
       case XmlNodeType.Document:
           break;
       case XmlNodeType.DocumentType:
           Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
           break;
       case XmlNodeType.EntityReference:
           Console.Write(reader.Name);
           break;
       case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
   } 
}

このサンプルでは、items.xml ファイルを使用しています。

<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY
 number "123">]>
<Items>
  <Item>Test with
 an entity: &number;</Item>
  <Item>Test with
 a child element <more/>
 stuff</Item>
  <Item>Test with
 a CDATA section <![CDATA[<456>]]>
 def</Item>
  <Item>Test with
 a char entity: &#65;</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>