Expat (XML Parser Toolkit) ѳĥ⥸塼
                     version 0.6.1

                                                    

- 

ܥ⥸塼ϡRuby James Clark  XML Parser Toolkit
"expat" (http://www.jclark.com/xml/expat.html) إ
뤿γĥ⥸塼Ǥ

ݡȤƤ expat ΥСϡ1.2 ޤ 1.95.0
(http://sourceforge.net/projects/expat/) Ǥ


- 󥹥ȡ

Ruby-1.4 ʹߤǤưǧƤޤRuby-1.6.1 ʹߤ
Ѥ򤪤ᤷޤޤexpat-1.2 ޤ expat-1.95.0 
ɬפǤ

ޤ expat 򥳥ѥ뤷Ƥ expat-1.95.0 Ȥ
ϡconfigure; make; make install ǥ󥹥ȡǤޤ
expat-1.2 ξ Makefile ŬԽ make Ƥ


 xmlparser ⥸塼򥳥ѥ뤷ޤexpat-1.2  
xmlparser ǥ쥯ȥβʳǥѥ뤷䡤
expat-1.95.0 ɸʳΥǥ쥯ȥ˥󥹥ȡ뤷
ϡexpat Υإåե饤֥ΰ֤ extconf.rb 
ץǻꤷƤ

   --with-xmlparse-lib=/path/to/expat/xmlparse
   --with-xmlparse-include=/path/to/expat/xmlparse

Perl  XML::Parser  󥳡ǥ󥰥ޥåפѤ
 --with-perl-enc-map ץǥǥ쥯ȥꤷƲ
Encodings ǥ쥯ȥ EUC-JP Shift_JIS Υޥ
פäƤޤɬפʤŬʥǥ쥯ȥ˥ԡƤ


̾Υ⥸塼륤󥹥ȡԤäƤ

  ruby extconf.rb --with-perl-enc-map=/usr/local/lib/XML/Parser/Encodings
  make
  make site-install


- Ȥ

ruby  make Ū˥󥯤Ƥʤϡ

  require "xmlparser"

ȤƤѤƤ

ѡ̤ˡȤơ٥ȥϥɥˡ
ƥ졼ȤƻȤˡޤ

٥ȥϥɥˡ SAX (Simple API for XML) 
Ƥޤ

٥ȥϥɥȤ硤Ū XMLParser 饹Ѿ
٥ȥϥɥ᥽åɤƻȤäƤ
private ᥽åɤˤƤۤǤ礦
XMLParser 饹Υ󥹥󥹤ðۥ᥽åɤƤ⹽
ޤ󡣥٥ȥϥɥ餬Ƥʤʸˡå
ޤ

  ᥽å̾               | ٥
  -------------------------+-------------------
  startElement             | ȳϥ
  endElement               | Ƚλ
  character                | ʸǡ
  processingInstruction    | PI
  unparsedEntityDecl       | оݳ
  notationDecl             | ˡ
  externalEntityRef        | λ
  comment                  |  (*1)
  startCdata               | CDATA 󳫻 (*1)
  endCdata                 | CDATA λ (*1)
  startNamespaceDecl       | Namespace  (*1)
  endNamespaceDecl         | Namespace λ (*1)
  startDoctypeDecl         | ʸ (*3)
  endDoctypeDecl           | ʸλ (*3)
  notStandalone            | standalone ǤϤʤ (*1)
  default                  | ¾
  defaultExpand            | default Ʊ (*2)
  unknownEncoding          | ̤ΤΥ󥳡ǥ
  elementDecl              | element declaration (*4)
  attlistDecl              | attlist declaration (*4)
  xmlDecl                  | XML declaration (*4)
  entityDecl               | entity declaration (*4)
  externalParsedEntityDecl | external parsed entity declaration (*5)
  internalParsedEntityDecl | internal parsed entity declaration (*5)

  *1 expat-1.1 ʹߤǻȤޤ
  *2 expat-1.1 ʹߤǻȤޤdefault ȤλȤ
     Ÿ뤳Ȥ㤤ޤdefaultExpand 
     default ̵뤷ޤ
  *3 expat-19990728 ʹߤǻȤޤ
  *4 expat-1.95.0 or later.
  *5 expat-1.2 only.

ȥåץ٥Ǵؿϴؿ̾դƲ
ޤޥ٥ȥϥɥƱ̾ˤƤޤͽʤ
Ȥޤȥåץ٥Ǵؿ Object
Υ᥽åɤȸʤޤXMLParser  Object 饹
Τǡ٥ȥϥɥƱ̾δؿ٥ȥϥɥȤ
ƸƤӽФƤޤΤǤդˡƤ XMLParser ֥
ȤƱ٥ȥϥɥȤΤǤСȥåץ٥δ
ȤƤ⹽ޤ



ƥ졼ȤƻȤˡϤ Ruby 餷(Ȼפ)꤫
Ǥ

ƥ졼ȤƻȤϤȤ٥ȥϥɥƤ
Ƥ̵뤵ޤƥ졼 ٥ȥס̾Ρ ǡ
Ȥ 3 Ĥѿ򥤥ƥ졼֥åϤޤ

  ٥ȥ                    | ̾            | ǡ
  ----------------------------------+-----------------+---------------
  START_ELEM                        | ̾    | °Υϥå
  END_ELEM                          | ̾    | nil
  CDATA                             | nil             | ʸ
  PI                                | PI ̾           | ʸ
  UNPARSED_ENTITY_DECL              | ̾          |  (*1)
  NOTATION_DECL                     | ˡ̾          |  (*2)
  EXTERNAL_ENTITY_REF               | ̾ (*5)     |  (*2)
  COMMENT (*3)                      | nil             | ʸ
  START_CDATA (*3)                  | nil             | nil
  END_CDATA (*3)                    | nil             | nil
  START_NAMESPACE_DECL (*3)         | prefix          | URI
  END_NAMESPACE_DECL (*3)           | prefix          | nil
  START_DOCTYPE_DECL (*6)           | ʸ̾        | nil
  END_DOCTYPE_DECL (*6)             | nil             | nil
  DEFAULT (*4)                      | nil             | ʸ
  ELEMENT_DECL (*7)                 | element name    | array (*8)
  ATTLIST_DECL (*7)                 | element name    | array (*9)
  XML_DECL (*7)                     | nil             | array (*10)
  ENTITY_DECL (*7)                  | entity name     | array (*11)
  EXTRNAL_PARSED_ENTITY_DECL (*12)  | entity name     | array (*13)
  INTERNAL_PARSED_ENTITY_DECL (*12) | entity name     | text

  *1 [URL١ƥ༱̻ҡ̻ҡˡ̾]
      URL١ˡ̾  nil ˤʤ뤳Ȥޤ
  *2 [URL١ƥ༱̻ҡ̻]
      URL١ƥ༱̻ҡ̻  nil ˤʤ뤳Ȥޤ
  *3 expat-1.1 ʹߤǻȤޤ
  *4 defaultExpand ͭˤʤΤ expat-1.1 ʹߤǤ
  *5 ƥ expat dzѥ᡼Τξ nil ˤʤޤ
  *6 expat-19990728 ʹߤǻȤޤ
  *7 expat-1.95.0 or later.
  *8 [type, quant, name, [...]]
  *9 [attname, atttype, default, isrequired]
  *10 [version, encoding, standalone]
  *11 [isPE, value, system ID, public ID, notation name]
  *12 expat-1.2 only.
  *13 [URL base, system ID, public ID]

UNPARSED_ENTITY_DECLNOTATION_DECLEXTERNAL_ENTITY_REF
COMMENTSTART_CDATAEND_CDATASTART_NAMESPACE_DECL
END_NAMESPACE_DECLDEFAULTELEMENT_DECLATTLIST_DECL
XML_DECLENTITY_DECLEXTERNAL_PARSED_ENTITY_DECL
INTERNAL_PARSED_ENTITY_DECL ȯΤϤ줾졤ߡ
unparsedEntityDeclnotationDeclexternalEntityRefcomment
startCdataendCdatastartNamespaceDeclendNamespaceDecl
default (ޤ defaultExpand)elementDeclattlistDecl
xmlDeclentityDeclexternalParsedEntityDecl
internalParsedEntityDecl ᥽åɤƤȤ


ʸ󥳡ǥ󥰤 UTF-8, UTF-16 бƤޤ
Ϥ UTF-8 Ǥʳʸ󥳡ǥ󥰤Ȥ
ʸ󥳡ǥ󥰤Ѵ<?xml ... ?> Ԥ
encoding="..." 񤭴Ƥ
ѥ XML_ENC_PATH ŬڤꤵƤ硤Perl
 XML::Parser Υ󥳡ǥ󥰥ޥåפѤǤޤ
ѥåˤϥ󥳡ǥ󥰥ޥåפϴޤޤƤʤΤǡ
CPAN  XML::Parser 뤤 XML::Encoding ⥸塼
ꤷ.enc եŬʥǥ쥯ȥ˥󥹥ȡ뤷Ʋ



XMLParser 饹:

 饹᥽å
    new(encoding = nil, nssep = nil)
      XML ѡ֥Ȥޤ˼Ԥ
      XMLParserError 㳰ȯޤ
      encoding Ȥʸ󥳡ǥ󥰤ꤹ
      ȤޤExpat бƤ륨󥳡ǥ̾
      (ISO-8859-1, UTF-8, US-ASCII, UTF-16)Ȥޤ
      Expat-ja ξ EUC-JP  Shift_JIS ȤϤǤ

      nssep ꤹֳ̾ĥͭˤʤޤ
      Ȥ°̾˥ץեåꤹȡ
      ̾°̾ URI ȥѡȤϢ뤷̾ˤ
      ޤnssep ǻꤵ줿ʸκǽʸѥ졼
      ˤʤޤ

      㤨

         <hoge:test xmlns:hoge="http://tristan.inse.co.jp/hoge/">

       nssep = '!' ǥѡȡ̾

         http://tristan.inse.co.jp/hoge/!test

      ˤʤޤ

      ѡνäѡ֥ȤκѤϤǤʤ
      ǡѡ˥ѡ֥ȤƤ

    new(parser, context, encoding = nil)
      ΥѡѤXML ѡ֥Ȥޤ
      ˼ԤXMLParserError 㳰ȯޤ
      externalEntityRef ٥Ȥȯʹߤ˸ƤӽФޤ
      parser Ȥ XML ѡ֥ȤꤷƲ
      context Ȥ externalEntityRef ٥ȤΥѡ
      ƥȤǤޤ
      encoding Ȥʸ󥳡ǥ󥰤ꤹ
      Ȥޤ

      ѡνäѡ֥ȤκѤϤǤʤ
      ǡѡ˥ѡ֥ȤƤ

    expatVersion()
      expat ΥСޤ


 ᥽å
    parse(str = nil, isFinal = true)
      str ѡޤѡ̤Ȥƥ٥ȥϥɥ餬
      ƤӽФޤƥ졼֥åꤷϡ
      ٥ȥϥɥϸƤӽФޤ

      isFinal  XML ޤǥѡ false, Ǹ
      ޤǤξ true ꤷƲά true Ǥ
      ̵ǸƤӽФȤǡѡνλؼ뤳Ȥ
      Ǥޤ

      str Ȥƥȥ꡼ϤȤǤޤString 
      ֥ȤǤϤʤpublic  gets ᥽åɤ
      Ƥ륪֥Ȥȥ꡼Ȥߤʤޤ
      ξ硤isFinal λ̵뤵졤gets  nil
      ֤ޤǥѡޤ

      ѡ顼򸡽Ф XMLParserError 㳰ȯޤ

    done
      ѡλѡλѤޤ
       GC ǤƤޤäƤꤢޤ󤬡ѥ᡼
      Τѡɬ externalEntityRef ٥
      DzƤ

    defaultCurrent
      ٥ȥϥɥǸƤӽФޤdefault ٥Ȥȯ
      ѡΥǡ뤳ȤǤޤ
      ٥ȥϥɥǤ defualt ٥Ȥȯ
      ޤ
      ƥ졼֥åǻȤä硤Υƥ졼֥
      ƤӽФ DEFAULT ˤʤޤdefault  ɥ顼
      ƤӽФʤȤդƲ

    setBase
      URL ١ꤷޤꤷͤϡ
      unparsedEntityDecl ᥽åɤʤɤΰȤϤޤ

    line
    column
    byteIndex
      ٥ȥϥɥǸƤӽФޤߤΥѡ֤
      ޤ
      ޤparse ᥽åɤ XMLParserError 㳰ȯ
      ˸ƤӽФȥ顼֤֤ޤ

    byteCount
      expat-1.1 ʹߤΥ᥽åɤǤ٥ȥϥɥǸƤӽ
      ޤߤΥ٥оݤĹ֤ޤΤ
       0 ֤ޤ

    getSpecifiedAttributes
      expat-1.1 ʹߤΥ᥽åɤǤ°ꤵ줿ͤǥե
      ͤΤ뤳ȤǤޤ
      °̾򥭡ꤵ줿ɤ (true/flase) ͤȤ
      ϥå֤ޤ
      startElement ٥ǸƤӽФƤ

    setParamEntityParsing(parsing)
      ƥ expat ΤߤΥ᥽åɤǤѥ᡼
      ѡ뤫ɤꤷޤ
      parsing ˤ
         PARAM_ENTITY_PARSING_NEVER
         PARAM_ENTITY_PARSING_UNLESS_STANDALONE
         PARAM_ENTITY_PARSING_ALWAYS
      Τ줫ꤷƤ

    setReturnNSTriplet(do_nst)
      ֤̾ͭʤȤˡURI + ̾ + ץե
      Ȥɤؼޤfalse λURI + 
      ̾Ǥ

      This method is for the expat-1.95.0 or later.

    getInputContext
      ϥХåեȸߥѡ֤ޤ

      This method is for the expat-1.95.0 or later.

    getIdAttribute
      ID °̾ޤ
      startElement ٥ǸƤӽФƤ

      This method is for the expat-1.2.


 ᥽å (٥ȥϥɥ)
    startElement(name, attrs)
      ȳϥդȸƤӽФޤname 
      ̾attrs °̾򥭡°ͤͤȤϥ
      Ǥ

    endElement(name)
      ȽλդȸƤӽФޤname 
      ̾Ǥ

    character(data)
      ƥȡCDATA դȸƤӽФޤ
      default ϥɥ餬̤ΤȤΤŸޤ

    processingInstruction(target, data)
      PI դȸƤӽФޤ

    unparsedEntityDecl(entityName, base, systemId, publicId, notationName)
      оݳդȸƤӽФޤ
      entityNamebasesystemIdpublicIdnotationName 
      줾̾URL ١ƥ༱̻ҡ̻ҡ
      ˡ̾ǤURL ١ˡ̾  nil ˤʤ뤳Ȥ
      ޤ

      ƥ졼ȤƻȤ硤unparsedEntityDecl 
      Ƥ뤫ɤå졤
      UNPARSED_ENTITY_DECL ٥Ȥȯ˱ƶͿޤ

    notationDecl(notationName, base, systemId, publicId)
      ˡդȸƤӽФޤ
      notationNamebasesystemIdpublicId Ϥ줾쵭ˡ
      ̾URL ١ƥ༱̻ҡ̻ҤǤURL ١
      ƥ༱̻ҡ̻  nil ˤʤ뤳Ȥ
      ޤ

      ƥ졼ȤƻȤ硤notationDecl Ƥ
      뤫ɤå졤NOTATION_DECL ٥Ȥ
      ȯ˱ƶͿޤ

    externalEntityRef(context, base, systemId, publicId)
      λȤդȸƤӽФޤ
      contextbasesystemIdpublicId Ϥ줾ѡ
      ƥȡURL ١ƥ༱̻ҡ̻ҤǤ
      URL ١̻  nil ˤʤ뤳Ȥޤ
      ѡƥȤϳΥѡѤΥѡ
      Ȥ context ȤѲǽǤ

      Υ٥ȤdzΤѡʤСΤϥѡ
      뤳ȤϤޤ

      ƥ졼ȤƻȤ硤externalEntityRef 
      Ƥ뤫ɤå졤
      ETERNAL_ENTITY_DEF ٥Ȥȯ˱ƶͿޤ

      
        def externalEntityRef(context, base, systemId, publicId)
          extp = self.type.new(self, context)
          file = if base.nil?; systemId; else base + "/" + systemId; end
          extp.parse(open(file))
          extp.done
        end

      ƥ expat Ǥϳѥ᡼λ (ӳ DTD 
      ֥å) դˤƤӽФޤξ
       context  nil ˤʤޤѥ᡼Τѡ
      ɬΥϥɥǥѡѡλ
       done ƤӽФƤ

    comment(data)
      expat-1.1 ʹߤΥ٥ȥϥɥǤȤդ
      ȸƤӽФޤ

      ƥ졼ȤƻȤ硤comment Ƥ뤫
      å졤COMMENT ٥Ȥȯ˱ƶ
      Ϳޤ

    startCdata()
      expat-1.1 ʹߤΥ٥ȥϥɥǤCDATA 
      ϻ˸ƤӽФޤCDATA Ƥ
      character ٥Ȥ𤵤ޤ

      ƥ졼ȤƻȤ硤startCdata Ƥ
      ɤå졤START_CDATA ٥Ȥȯ
      ˱ƶͿޤ

    endCdata()
      expat-1.1 ʹߤΥ٥ȥϥɥǤCDATA 
      λ˸ƤӽФޤ

      ƥ졼ȤƻȤ硤endCdata Ƥ뤫
      ɤå졤END_CDATA ٥Ȥȯ˱
      Ϳޤ

    startNamespaceDecl(prefix, uri)
      expat-1.1 ʹߤΥ٥ȥϥɥǤNamespace 
      Ȥγ˸ƤӽФޤprefix  xmlns 
      °ꤵ줿 nil ˤʤꡤuri ϶ URI 
      줿 nil ˤʤޤ

      ƥ졼ȤƻȤ硤startNamespaceDecl 
      뤫ɤå졤
      START_NAMESPACE_DECL ٥Ȥȯ˱ƶͿޤ

    endNamespaceDecl(prefix)
      expat-1.1 ʹߤΥ٥ȥϥɥǤNamespace 
      Ȥνλ˸ƤӽФޤprefix  xmlns 
      °ꤵ줿 nil ˤʤޤ

      ƥ졼ȤƻȤ硤endNamespaceDecl 
      뤫ɤå졤
      END_NAMESPACE_DECL ٥Ȥȯ˱ƶͿޤ

    startDoctypeDecl(doctypeName)
      expat-19990728 ʹߤΥ٥ȥϥɥǤDOCTYPE 
      ʸ̾򸫤ĤȸƤӽФޤdoctypeName 
      ʸ̾Ǥ

      ƥ졼ȤƻȤ硤startDoctypeDecl 
      뤫ɤå졤
      START_DOCTYPE_DECL ٥Ȥȯ˱ƶͿޤ

    endDoctypeDecl()
      expat-19990728 ʹߤΥ٥ȥϥɥǤDOCTYPE 
      νλ˸ƤӽФޤ

      ƥ졼ȤƻȤ硤endDoctypeDecl 
      뤫ɤå졤
      END_DOCTYPE_DECL ٥Ȥȯ˱ƶͿޤ

    default(data)
      ¾Υ٥ȤƤӽФʤä˸ƤӽФޤ
      Υ᥽åɤΤŸ޻ߤޤ
      ƥ졼ȤƻȤ硤default Ƥ뤫
      å졤DEFAULT ٥Ȥȯ
      ΤŸ˱ƶͿޤ

    defaultExpand(data)
      ¾Υ٥ȤƤӽФʤä˸ƤӽФޤ
      ƥ졼ȤƻȤ硤defaultExpand Ƥ
      뤫ɤå졤DEFAULT ٥Ȥȯ
      ƶͿޤ
      defalutExpand  default ᥽åɤͥ褷ޤ

    unknownEncoding(name)
      ѡϻXML Υѡ̤ΤΥ󥳡ǥ
      󥰤򸡽Ф˰٤ƤӽФޤ

      XMLEncoding ֥Ȥ֤Ʋ      

      ƥ졼ȤƻȤˤ⤳Υ٥ȥϥɥ餬Ƥ
      Ф졤ƥ졼֥åϸƤӽФޤ

      ܺ٤ϼ򻲾ȤƲ

    notStandalone()
      expat-1.1 ʹߤΥ٥ȥϥɥǤstandalone="yes" 
      Ǥʤ DTD ֥åȤѥ᡼Τ򻲾Ȥ
      ȸƤӽФޤ

      顼ȯ 0³Ԥ 
      1 ֤Ƥ

      ƥ졼ȤƻȤˤ⤳Υ٥ȥϥɥ餬Ƥ
      Ф졤ƥ졼֥åϸƤӽФޤ

      expat ϳ DTD ֥åȤѥ᡼ΤǤ
      ʤΤǡΥ٥Ȥȯ¾ XML ץ
      ƤӽФʤꡤǤʤꤹ٤⤷ޤ
      

    elementDecl(name, model)
      ˸ƤӽФޤ name ̾model 
      ƥǥ򤢤魯
        [type, quant, name, [children_model, ...]]
      Τ褦Ǥtype  "EMPTY""ANY""MIXED"
      "CHOICE""SEQ" Τ줫quant """?""*""+" 
      Τ줫Ǥname  nil ̾children_model 
      ϻҥǥǤ

      This method is for expat-1.95.0 or later.

      If you use iterator, this method is not called, but to
      define this affects to cause ELEMENT_DECL event.

    attlistDecl(elname, attname, att_type, dflt, isrequired)
      °˸ƤӽФޤelname ̾attname 
      °̾att_type °ηdflt Ͼά͡
      isrequired  #REQUIRED ɤ򤢤路ޤ

      This method is for expat-1.95.0 or later.

      If you use iterator, this method is not called, but to
      define this affects to cause ATTLIST_DECL event.

    xmlDecl(version, encoding, standalone)
      ʸƬ XML ӲϲǽΤΥƥ
      ˸ƤӽФޤƥǤ version  nil ˡ
      XML Ǥ encoding  nil ˤʤ뤳Ȥޤ
      standalone  -101 ͤȤޤ

      This method is for expat-1.95.0 or later.

      If you use iterator, this method is not called, but to
      define this affects to cause XML_DECL event.

    entityDecl(entityName, isparameter_entity, vale,
               base, systenId, publicId, notationName)
      ˸ƤӽФޤ

      This method is for expat-1.95.0 or later.

      If you use iterator, this method is not called, but to
      define this affects to cause ENTITY_DECL event.

    externalParsedEntityDecl(entityName,base, systemId, publicId)

      This method is for expat-1.2.

      If you use iterator, this method is not called, but to
      define this affects to cause
      EXTERNAL_PARSED_ENTITY_DECL event.

    internalParsedEntityDecl(entityName, replacementText)

      This method is for expat-1.2.

      If you use iterator, this method is not called, but to
      define this affects to cause
      INTERNAL_PARSED_ENTITY_DECL event.



̤Τʸ󥳡ǥ󥰤ˤĤ

unknownEncoding ᥽åɤȡѡϻXML 
Υѡ̤ΤΥ󥳡ǥ󥰤򸡽Ф˰٤
ƤӽФޤΥ٥Ȥ뤳Ȥǡexpat б
Ƥʤʸ󥳡ǥ(ܤΤʤ¿Хȥ󥳡
ǥ󥰤Τ)б뤳ȤǤޤ

unknownEncoding ᥽åɤ Perl Υ󥳡ǥ
ޥåפϻѤʤʤޤ

¾Υ٥ȤȰäơƥ졼ȤƸƤӽФ⥤٥
ȥϥɥ餬ƤӽФޤ

Ȥƥ󥳡ǥ̾ϤޤͤȤƤΥ
ǥ󥰤б XMLEncoding ֥Ȥ֤Ʋ
XMLEncoding ֥Ȱʳ֤ unknownEcoding ᥽
ɤ̤ξƱͤ㳰ȯޤ

εˤʸ󥳡ǥѴϤʤ٤Ǥ

XMLEncoding 饹
  ʸ󥳡ǥѴΤΥ饹ǤѤߥ᥽
  ɤ Latin-1 ѴԤʤޤΤޤ޻ȤȤ̵
  ̣ʤΤǡŬڤѴԤʤ褦᥽åɤʤ
  ȤäƲ

  lib/xmlencoding-ja.rb Ǥ

  ᥽å
    map(code)
      Υ󥳡ǥ󥰤ΥХ뤿
      Ū˸ƤӽФޤ
      code ϥХκǽΥХȤΥɥݥȤǡ00h
       FFh ޤǤϤޤ
      ͤȤưʲΤ줫֤ͤƲ

        0 ʾ : Unicode Υɥݥ
        -1     : ʥХ
        -n     : n ХȤ¿Х (2<=n<=4)

      㤨Сܸ EUC (JIS X 0201 ʤ JIS X 0212 
      ̵)ξϰʲΤ褦 map ᥽åɤƲ
      

        def map(i)
          return i if i < 128
          return -1 if i < 160 or i == 255
          return -2
        end

      ISO-2022-JP Τ褦ʾܤԤʤ󥳡ǥ󥰤
      бǤޤ

    convert(s)
      ʸ󥳡ǥѴΤŪ˰ʸ˸Ƥӽ
      ޤ
      s  map 줿Ĺ¿ХǤͤȤơ
      Unicode Υɥݥ() ʸȥ륨
      ǥ UCS2 ʸ֤Ʋ


- ޤ饤֥

Version 0.3.1  XML:DOM  XML::DOM::Builder
Ȥ饤֥źդޤ
ɥȤ̤ǡAPI ͤǤϤʤΤǡ
ɤѤǤ


XML::DOM ⥸塼 (xmltree.rb)
  XML ĥ꡼κԤʤΥ饤֥Ǥ
  API  W3C  Document Object Model (DOM) ˤۤȤɽ
  Ƥޤ

  饹
    NameNodeMap
    NodeList
    Node
    DocumentFragment<Node
    Document<Node
    CharacterData<Node
    Attr<Node
    Element<Node
    Text<CharacterData
    Comment<Data
    CDATASection<Text
    DocumentType<Node
    Notation<Node
    Entity<Node
    EntityReference<Node
    ProcessingInstruction<Node

XML::DOM::Builder 饹 (xmltreebuilder.rb)
  XML եѡƥĥ꡼ȤΩƤ뤿Υ饹Ǥ

XML::JapaneseTreeBuilder 饹 (xmltreebuilder-ja.rb)
  ܸ XML եѡƥĥ꡼ȤΩƤ뤿
  饹ǤޤꤪǤޤ

XML::DOM::Visitor (xmltreevisitor.rb)
  Visitor ѥȤ䤹뤿Υ饤֥Ǥ

XMLEncoding_ja 饹 (xmlencoding-ja.rb)
  XML::Encoding 饹μǤ

WGET ⥸塼 (wget.rb)
  XML::DOM::Builder 饹ǻȤäƤ http, ftp ǥե
  뤿Υ⥸塼ǤΤȤwget, lynx 
  ƤӽФƤǤ

DOMHASH ⥸塼 (xmldigest.rb)
  XML::DOM ⥸塼 DOMHASH (draft-hiroshi-dom-hash-01.txt)
  ݡȤɲäޤMD5 르ꥺбƤޤ
  Ȥ samples/digetstest.rb 򻲾ȤƤ

SAX ⥸塼 (sax.rb, saxdriver.rb)
  SAX for Ruby μ¸ŪʼǤ


- ץץ

ܸ XML ե̤ˤ uconv ⥸塼뤬
ɬפǤ

  xmlchack.rb - ʸˡåԤץ
  xmlevent.rb - ٥ȥϥɥΥץ
  xmliter.rb  - ƥ졼Υץ
  xmlgrep.rb  - ñ XML ץꥱΥץ
  treetest.rb - XML::SimpleTree ץ
  buildertest.rb - XML::SimpleTreeBuilder ץ
  videolist.rb - ӥǥơ״Τδñ XML ץꥱ󥵥ץ
  gtktree.rb  - GTK Ȥäץ
  xmlcomment.rb - Perl  XML::Parser °ץΰܿ
  visitortest.rb - Perl  XML::Grove ° visitor ץΰܿ
  my-html.rb  - Perl  XML::Grove ° visitor ץΰܿ
  writer.rb  - Visotor λ
  visitor.rb  - Visotor Υץ
  namespaces/ - ֥̾ݡȤΥƥ
  xpointer.rb - GTK Ȥä XPointer Υǥ
  digesttest.rb - DOMHASH Υץ
  digesttest2.rb - DOM Ȥʤ® DOMHASH Υץ롣
  saxtest.rb - SAX Ȥäץ


- 

ܳĥ⥸塼ϵͤݻޤ

ܳĥ⥸塼ϡruby ΤΥ饤󥹤expat Υ饤
󥹤Τɤ餫ˤäѤ뤳ȤǤޤ

encoding.h ӡencoding map Ϣδؿ Perl Ѥ
XML::Parser ⥸塼ΰǤ

  Copyright (c) 1998 Larry Wall and Clark Cooper.
  All rights reserved.
  This program is free software; you can redistribute it and/or modify it
  under the same terms as Perl itself. 


- 

  <yoshidam@yoshidam.net>

 XPointer support is contributed by Masaki Fukushima 
     <fukusima@goto.info.waseda.ac.jp>


- 

 Oct 15  2000 version 0.6.1  expat-1.95.0expat-1.2 б
 Aug  5, 2000 version 0.5.19 ⶶ xmltree.rb  
                             RD Ƥޤ
 May 30, 2000 version 0.5.18 ruby 1.5 ưʤʤäƤΤǽ
 Jan  4, 2000 version 0.5.17 NodeList#+ 꽤 (Masatoshi SEKI
                             󤢤꤬Ȥޤ)
 Oct 14, 1999 version 0.5.16 ĤΥץץѹ
 Aug 18, 1999 version 0.5.15 expat-19990728  start/endDoctypeDecl 
                             б
                             SAX ɥ饤ФΥХ
 Jun 29, 1999 version 0.5.14 expat-19990626 γѥ᡼
                             (ӳ DTD ֥å)ɤ߹ߤб
                             Ruby-1.2 ݡȤߡ
 Jun 10, 1999 version 0.5.13 ¸Ū SAX ɥ饤Фɲ
                             expat-1.1 б
 May 13, 1999 version 0.5.12 extconf.rb ΥХ (ƣܾˮ󤢤
                             Ȥޤ)
 Apr 28, 1999 version 0.5.11 expat-19990425 б NotStandalone
                             ٥ȡgetSpecifiedAttributes,
                             byteCount ᥽åɲ 
 Apr 20, 1999 version 0.5.10 xss4j 򻲹ͤˤ xmldigest.rb ѹ
 Mar 29, 1999 version 0.5.9  Ruby 1.3 Ѥ˥֥Ȥι¤ѹ
 Mar 23, 1999 version 0.5.8  XPointer Υɤξάǽˤ
                             XML::DOM::Builder dzѡΤνɲ
 Mar  8, 1999 version 0.5.7  expat-19990307  start/endNamespaceDecl
                             ٥Ȥб
 Jan 25, 1999 version 0.5.6  饹̾̾ C ⥸塼˰ư
                             Cygwin ư뤿ѹ
 Jan 14, 1999 version 0.5.5  expat-19981231  start/endCdataSection
                             ٥Ȥб
                             xmltreebuilder ƥ expat
                             б (comment, CDATA)
                             Node#trim  CDATA  trim
                             褦˲¤
 Jan 13, 1999 version 0.5.4  xmltree, xmltreebuilder ¤ (Хä)
 Jan 10, 1999 version 0.5.3  Perl  encoding map б
 Jan  1, 1999 version 0.5.2  expat-19981231 б
 Dec  1, 1998 version 0.5.1  (ʡ󤢤꤬Ȥޤ)
 Nov 24, 1998 version 0.5.0  ƥ expat б
 Nov  5, 1998 version 0.4.18 Х(ʡ󤢤꤬Ȥޤ)
                             饹̾̾
                               XMLParserErorr        -> XML::Parser::Error
                             ᥽å ID νѹ
                             xmltreebuilder  Ruby ΥХ?
 Oct 28, 1998 version 0.4.17 ᥽å ID Ūѿ˰ܤ
 Oct 28, 1998 version 0.4.16 XPointer ѻ ID °ǽˤ
                             Node#trim  xml:space бˤ
 Oct 23, 1998 version 0.4.15 Х饹̾̾
                               XMLParser              -> XML::Parser
                               XML::SimpleTree        -> XML::DOM
                               XML::SimpleTreeBuilder -> XML::DOM::Builder
 Oct 20, 1998 version 0.4.14 ʡˤ XPointer ݡȤɲ
 Oct 18, 1998 version 0.4.13 SimpleTree ΥХVistor ɲ
 Oct 13, 1998 version 0.4.12 Х󥳡ǥѴι®
 Oct  7, 1998 version 0.4.11 ѡΥ֥ȴѹ
 Oct  4, 1998 version 0.4.9 ٤ХDOM бʤ
 Sep 22, 1998 version 0.4.8 ȥ꡼λͤ򾯤ѹ
 Sep 21, 1998 version 0.4.7 SimpleTree, SimpleTreeBuilder  Comment ʤɲ
 Sep 18, 1998 version 0.4.6 UnknownEncording ٥Ȥб
 Sep 17, 1998 version 0.4.5 SimpleTree ˥᥽åɲ
 Sep  8, 1998 version 0.4.4 ѡ֥Ȥ T_DATA 
                            T_OBJECT ѹ
 Sep  3, 1998 version 0.4.3 isFinal ե饰ɲáȥ꡼б
 Sep  2, 1998 version 0.4.2 Υ٥ȡΥѡɲ
 Aug 14, 1998 version 0.3.3 expat 1.0 б
 Aug 12, 1998 version 0.3.2 SimpleTree  XPointer ɤɲ
                            (root, child ,id Τߥݡ)
 Aug  4, 1998 version 0.3.1 饤֥ɲáexpat_ja ưǧ
 Jul 17, 1998 version 0.3 ƥ졼֥å
                          defaultCurrent б
 Jul  3, 1998 version 0.2 ƥ졼б
 Jul  1, 1998 version 0.1 ꡼