# REXML::Comment (Class)

In: | rexml/comment.rb
Parent: | Child

Represents an XML comment; that is, text between <!— … —>

## Methods

<=> == clone new node_type write

## Constants

START | = | ""

## External Aliases

string -> to_s

## Attributes

string | [RW] |

## Included Modules

Comparable

## Public Class methods

new( first, second = nil )

Constructor. The first argument can be one of three types: @param first If String, the contents of this comment are set to the argument. If Comment, the argument is duplicated. If Source, the argument is scanned for a comment. @param second If the first argument is a Source, this argument should be nil, not supplied, or a Parent to be set as the parent of this object

[Source]

    # File rexml/comment.rb, line 21
                    def initialize( first, second = nil )
                            #puts "IN COMMENT CONSTRUCTOR; SECOND IS #{second.type}"

                            super(second)
                            if first.kind_of? String
                                    @string = first
                            elsif first.kind_of? Comment
                                    @string = first.string
                            end
                    end

## Public Instance methods

clone()

[Source]

    # File rexml/comment.rb, line 31
                    def clone
                            Comment.new self
                    end

write( output, indent=-1, transitive=false, ie_hack=false )

output: | Where to write the string
indent: | An integer. If -1, no indenting will be used; otherwise, the indentation will be this number of spaces, and children will be indented an additional amount.
transitive: | Who knows?
ie_hack: | Internet Explorer is the worst piece of crap to have ever been written, with the possible exception of Windows itself. Since IE is unable to parse proper XML, we have to provide a hack to generate XML that IE’s limited abilities can handle. This hack inserts a space before the /> on empty tags.

[Source]

    # File rexml/comment.rb, line 50
                    def write( output, indent=-1, transitive=false, ie_hack=false )
                            indent( output, indent )
                            output << START
                            output << @string
                            output << STOP
                    end

<=>(other)

Compares this Comment to another; the contents of the comment are used in the comparison.

[Source]

    # File rexml/comment.rb, line 62
                    def <=>(other)
                            other.to_s <=> @string
                    end

==( other )

Compares this Comment to another; the contents of the comment are used in the comparison.

[Source]

    # File rexml/comment.rb, line 69
                    def ==( other )
                            other.kind_of? Comment and
                            (other <=> self) == 0
                    end

node_type()

[Source]

    # File rexml/comment.rb, line 74
        def node_type
          :comment
        end

[Validate]