File: Poco.XML.DOMObject.html

package info (click to toggle)
poco-doc 1.3.6-1
  • links: PTS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, squeeze, stretch, wheezy
  • size: 10,076 kB
  • ctags: 9,611
  • sloc: makefile: 31
file content (69 lines) | stat: -rw-r--r-- 7,813 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Class Poco::XML::DOMObject</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<meta name="author" content="Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="publisher" content="Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="copyright" content="Copyright (c) 2009, Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="language" content="en"/>
<meta name="date" content="2009-11-24"/>
<meta name="generator" content="PocoDoc"/>
<link rel="stylesheet" href="css/styles.css" type="text/css"/>
</head>
<body bgcolor="#ffffff" leftmargin="0" topmargin="0">
<div class="header">
<h1 class="namespace"><a href="Poco.XML.html" class="namespace">Poco::XML</a></h1>
<h1 class="symbol">class DOMObject</h1>
</div>
<div class="body">
<p>
<b>Library:</b> XML<br />
<b>Package:</b> DOM<br />
<b>Header:</b> Poco/DOM/DOMObject.h</p>
<h2>Description</h2>
<div class="description">
<p>The base class for all objects in the <a href="Poco.XML.Document.html" title="class Poco::XML::Document">Document</a> Object Model. </p>
<p><a href="Poco.XML.DOMObject.html" title="class Poco::XML::DOMObject">DOMObject</a> defines the rules for memory management in this implementation of the DOM. Violation of these rules, which are outlined in the following, results in memory leaks or dangling pointers. </p>
<p>Every object created by new or by a factory method (for example, Document::create*) must be released with a call to <a href="Poco.XML.DOMObject.html#17882" title="Poco::XML::DOMObject::release()">release</a>() or <a href="Poco.XML.DOMObject.html#17883" title="Poco::XML::DOMObject::autoRelease()">autoRelease</a>() when it is no longer needed. </p>
<p>Every object created by cloning or importing another object must be released. For every call to <a href="Poco.XML.DOMObject.html#17881" title="Poco::XML::DOMObject::duplicate()">duplicate</a>() there must be a matching call to <a href="Poco.XML.DOMObject.html#17882" title="Poco::XML::DOMObject::release()">release</a>(). An object obtained via any other way must not be released, except ownership of it has been explicitely taken with a call to <a href="Poco.XML.DOMObject.html#17881" title="Poco::XML::DOMObject::duplicate()">duplicate</a>(). </p>
<p>While DOMObjects are safe for use in multithreaded programs, a <a href="Poco.XML.DOMObject.html" title="class Poco::XML::DOMObject">DOMObject</a> or one of its subclasses must not be accessed from multiple threads simultaneously. </p>
</div>
<h2>Inheritance</h2>
<p><b>Known Derived Classes: </b><a href="Poco.XML.AbstractContainerNode.html" title="class Poco::XML::AbstractContainerNode">AbstractContainerNode</a>, <a href="Poco.XML.Attr.html" title="class Poco::XML::Attr">Attr</a>, <a href="Poco.XML.AbstractNode.html" title="class Poco::XML::AbstractNode">AbstractNode</a>, <a href="Poco.XML.AttrMap.html" title="class Poco::XML::AttrMap">AttrMap</a>, <a href="Poco.XML.CDATASection.html" title="class Poco::XML::CDATASection">CDATASection</a>, <a href="Poco.XML.Comment.html" title="class Poco::XML::Comment">Comment</a>, <a href="Poco.XML.CharacterData.html" title="class Poco::XML::CharacterData">CharacterData</a>, <a href="Poco.XML.ChildNodesList.html" title="class Poco::XML::ChildNodesList">ChildNodesList</a>, <a href="Poco.XML.DTDMap.html" title="class Poco::XML::DTDMap">DTDMap</a>, <a href="Poco.XML.Document.html" title="class Poco::XML::Document">Document</a>, <a href="Poco.XML.DocumentType.html" title="class Poco::XML::DocumentType">DocumentType</a>, <a href="Poco.XML.DocumentFragment.html" title="class Poco::XML::DocumentFragment">DocumentFragment</a>, <a href="Poco.XML.ElementsByTagNameList.html" title="class Poco::XML::ElementsByTagNameList">ElementsByTagNameList</a>, <a href="Poco.XML.Element.html" title="class Poco::XML::Element">Element</a>, <a href="Poco.XML.Entity.html" title="class Poco::XML::Entity">Entity</a>, <a href="Poco.XML.ElementsByTagNameListNS.html" title="class Poco::XML::ElementsByTagNameListNS">ElementsByTagNameListNS</a>, <a href="Poco.XML.Event.html" title="class Poco::XML::Event">Event</a>, <a href="Poco.XML.EntityReference.html" title="class Poco::XML::EntityReference">EntityReference</a>, <a href="Poco.XML.EventTarget.html" title="class Poco::XML::EventTarget">EventTarget</a>, <a href="Poco.XML.MutationEvent.html" title="class Poco::XML::MutationEvent">MutationEvent</a>, <a href="Poco.XML.NamedNodeMap.html" title="class Poco::XML::NamedNodeMap">NamedNodeMap</a>, <a href="Poco.XML.Node.html" title="class Poco::XML::Node">Node</a>, <a href="Poco.XML.ProcessingInstruction.html" title="class Poco::XML::ProcessingInstruction">ProcessingInstruction</a>, <a href="Poco.XML.NodeList.html" title="class Poco::XML::NodeList">NodeList</a>, <a href="Poco.XML.Notation.html" title="class Poco::XML::Notation">Notation</a>, <a href="Poco.XML.Text.html" title="class Poco::XML::Text">Text</a></p>
<h2>Member Summary</h2>
<p><b>Member Functions: </b><a href="Poco.XML.DOMObject.html#17883" title="Poco::XML::DOMObject::autoRelease()">autoRelease</a>, <a href="Poco.XML.DOMObject.html#17881" title="Poco::XML::DOMObject::duplicate()">duplicate</a>, <a href="Poco.XML.DOMObject.html#17882" title="Poco::XML::DOMObject::release()">release</a></p>
<h2>Constructors</h2>
<h3><a name="17880">DOMObject</a></h3>
<p class="decl"><a href="Poco.XML.DOMObject.html" title="class Poco::XML::DOMObject">DOMObject</a>();</p>
<div class="description">
<p>Creates the <a href="Poco.XML.DOMObject.html" title="class Poco::XML::DOMObject">DOMObject</a>. The object's reference count is initialized to one. </p>
</div>
<h2>Destructor</h2>
<h3><a name="17884">~DOMObject</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" />  <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">virtual ~<a href="Poco.XML.DOMObject.html" title="class Poco::XML::DOMObject">DOMObject</a>();</p>
<div class="description">
<p>Destroys the <a href="Poco.XML.DOMObject.html" title="class Poco::XML::DOMObject">DOMObject</a>. </p>
</div>
<h2>Member Functions</h2>
<h3><a name="17883">autoRelease</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">virtual void autoRelease() = 0;</p>
<div class="description">
<p>Adds the object to an appropriate <a href="Poco.AutoReleasePool.html" title="class Poco::AutoReleasePool">AutoReleasePool</a>, which is usually the <a href="Poco.AutoReleasePool.html" title="class Poco::AutoReleasePool">AutoReleasePool</a> managed by the <a href="Poco.XML.Document.html" title="class Poco::XML::Document">Document</a> to which this object belongs. </p>
</div>
<h3><a name="17881">duplicate</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void duplicate() const;</p>
<div class="description">
<p>Increases the object's reference count. </p>
</div>
<h3><a name="17882">release</a> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">void release() const;</p>
<div class="description">
<p>Decreases the object's reference count. If the reference count reaches zero, the object is deleted. </p>
</div>
<p class="footer">POCO C++ Libraries 1.3.6-all<br />
Copyright &copy; 2009, <a href="http://pocoproject.org/" target="_blank">Applied Informatics Software Engineering GmbH and Contributors</a></p>

</div>
</body>
</html>