Class: Nokogiri::XML::CDATA

Inherits:
Text show all
Defined in:
lib/nokogiri/xml/cdata.rb,
ext/nokogiri/xml_cdata.c

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Text

#content=

Methods included from PP::CharacterData

#inspect, #pretty_print

Class Method Details

.new(document, content) ⇒ Object

Create a new CDATA element on the document with content

If content cannot be implicitly converted to a string, this method will raise a TypeError exception.



14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'ext/nokogiri/xml_cdata.c', line 14

static VALUE
new (int argc, VALUE *argv, VALUE klass)
{
  xmlDocPtr xml_doc;
  xmlNodePtr node;
  VALUE doc;
  VALUE content;
  VALUE rest;
  VALUE rb_node;
  xmlChar *content_str = NULL;
  int content_str_len = 0;

  rb_scan_args(argc, argv, "2*", &doc, &content, &rest);

  if (rb_obj_is_kind_of(doc, cNokogiriXmlDocument)) {
    xml_doc = noko_xml_document_unwrap(doc);
  } else {
    xmlNodePtr deprecated_node_type_arg;
    // TODO: deprecate allowing Node
    NOKO_WARN_DEPRECATION("Passing a Node as the first parameter to CDATA.new is deprecated. Please pass a Document instead. This will become an error in a future release of Nokogiri.");
    Noko_Node_Get_Struct(doc, xmlNode, deprecated_node_type_arg);
    xml_doc = deprecated_node_type_arg->doc;
  }

  if (!NIL_P(content)) {
    content_str = (xmlChar *)StringValuePtr(content);
    content_str_len = RSTRING_LENINT(content);
  }

  node = xmlNewCDataBlock(xml_doc, content_str, content_str_len);

  noko_xml_document_pin_node(node);

  rb_node = noko_xml_node_wrap(klass, node);
  rb_obj_call_init(rb_node, argc, argv);

  if (rb_block_given_p()) { rb_yield(rb_node); }

  return rb_node;
}

Instance Method Details

#name ⇒ Object

Get the name of this CDATA node



8
9
10
 
# File 'lib/nokogiri/xml/cdata.rb', line 8

def name
  "#cdata-section"
end