lib/rexml/cdata.rb

   1 require "rexml/text"
   2
   3 module REXML
   4         class CData < Text
   5                 START = '<![CDATA['
   6                 STOP = ']]>'
   7                 ILLEGAL = /(\]\]>)/
   8
   9                 #       Constructor.  CData is data between <![CDATA[ ... ]]>
  10                 #
  11                 # _Examples_
  12                 #  CData.new( source )
  13                 #  CData.new( "Here is some CDATA" )
  14                 #  CData.new( "Some unprocessed data", respect_whitespace_TF, parent_element )
  15                 def initialize( first, whitespace=true, parent=nil )
  16                         super( first, whitespace, parent, true, true, ILLEGAL )
  17                 end
  18
  19                 # Make a copy of this object
  20                 #
  21                 # _Examples_
  22                 #  c = CData.new( "Some text" )
  23                 #  d = c.clone
  24                 #  d.to_s        # -> "Some text"
  25                 def clone
  26                         CData.new self
  27                 end
  28
  29                 # Returns the content of this CData object
  30                 #
  31                 # _Examples_
  32                 #  c = CData.new( "Some text" )
  33                 #  c.to_s        # -> "Some text"
  34                 def to_s
  35                         @string
  36                 end
  37
  38     def value
  39       @string
  40     end
  41
  42     # == DEPRECATED
  43     # See the rexml/formatters package
  44     #
  45                 # Generates XML output of this object
  46                 #
  47                 # output::
  48                 #   Where to write the string.  Defaults to $stdout
  49                 # indent::
  50     #   The amount to indent this node by
  51                 # transitive::
  52     #   Ignored
  53                 # ie_hack::
  54     #   Ignored
  55                 #
  56                 # _Examples_
  57                 #  c = CData.new( " Some text " )
  58                 #  c.write( $stdout )     #->  <![CDATA[ Some text ]]>
  59                 def write( output=$stdout, indent=-1, transitive=false, ie_hack=false )
  60       Kernel.warn( "#{self.class.name}.write is deprecated" )
  61                         indent( output, indent )
  62                         output << START
  63                         output << @string
  64                         output << STOP
  65                 end
  66         end
  67 end