Home	Xport Overview	Xport Download	XportPro Overview	Buy XportPro Now!

Xport Interface: `document::html`

Returns a pointer to the html element, if present.

markup* document::html();1st Variety

const markup* document::html() const;2nd Variety

Parameters

none

Returns

A pointer to the html element, if present. If the html element isn't present, returns NULL.

Remarks

This operation is one of the more common operations in document. This operation allows a very convienient way to access markup objects in the html element in the document, and to add markup to the html as well. This function can also be called to check or verify that the html element exists. Normally, if the document is a root document, the html, head, and body element will be present, so there would be no reason to use the html() operation to access the head or body elements, since they both have their own access functions, document::head() and document::body().

Complexity

Constant

Example

#include "xhtml_doc.h"
#include "xport_brochure.h"
#include <cassert>
#include <iostream>

int main(int argc, char* argv[])
{
  using namespace Xport;

  // create an xhtml strict root document
  document doc(root_doc);

  // verify document contains html element
  assert(doc.html());

  // list all child elements of html element
  std::cout << "Listing all elements in <html>.\n";
  markup::iterator it = doc.html()->begin();
  for (; it != doc.html()->end(); ++it) {
    if (it->markup_type() == mt_element) {
      std::cout << it->tag_name() << "\n";
    }
  }

  return 0;
}

View Xport Brochure externally

View Xport Brochure inline

View Xport Brochure source

Datasoft Solutions is proud to present their landmark product, Work Time Studio. Utilizing the tree container library, Work Time Studio provides unparalleled features in personal time, project and task management software. If you're looking for a way to increase your productivity, visit Work Time Studio's product website, and start being more productive today.

XHTML Parsing &Objective Reporting Toolkit

Xport Interface: document::html