class Nokogiri::XML::Attr


Attr represents a Attr node in an xml document.

Public Class Methods

new(document, name) Show source

Create a new Attr element on the document with name

static VALUE new(int argc, VALUE *argv, VALUE klass)
  xmlDocPtr xml_doc;
  VALUE document;
  VALUE name;
  VALUE rest;
  xmlAttrPtr node;
  VALUE rb_node;

  rb_scan_args(argc, argv, "2*", &document, &name, &rest);

  if (! rb_obj_is_kind_of(document, cNokogiriXmlDocument)) {
    rb_raise(rb_eArgError, "parameter must be a Nokogiri::XML::Document");

  Data_Get_Struct(document, xmlDoc, xml_doc);

  node = xmlNewDocProp(
           (const xmlChar *)StringValueCStr(name),


  rb_node = Nokogiri_wrap_xml_node(klass, (xmlNodePtr)node);
  rb_obj_call_init(rb_node, argc, argv);

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

  return rb_node;

Public Instance Methods

Alias for: value=
value=(content) Show source

Set the value for this Attr to content

static VALUE set_value(VALUE self, VALUE content)
  xmlAttrPtr attr;
  Data_Get_Struct(self, xmlAttr, attr);

  if (attr->children) { xmlFreeNodeList(attr->children); }

  attr->children = attr->last = NULL;

  if (content) {
    xmlChar *buffer;
    xmlNode *tmp;

    /* Encode our content */
    buffer = xmlEncodeEntitiesReentrant(attr->doc, (unsigned char *)StringValueCStr(content));

    attr->children = xmlStringGetNodeList(attr->doc, buffer);
    attr->last = NULL;
    tmp = attr->children;

    /* Loop through the children */
    for(tmp = attr->children; tmp; tmp = tmp->next) {
      tmp->parent = (xmlNode *)attr;
      tmp->doc = attr->doc;
      if (tmp->next == NULL) { attr->last = tmp; }

    /* Free up memory */

  return content;
Also aliased as: content=

© 2008–2017 Aaron Patterson, Mike Dalessio, Charles Nutter, Sergio Arbeo
Patrick Mahoney, Yoko Harada, Akinori Musha, John Shahid
Licensed under the MIT License.