DITA-OT_CXX_Plugin/cxxapiref/doc/cxxUnion/cxxUnion.dita
changeset 4 468f4c8d3d5b
equal deleted inserted replaced
3:d8fccb2cd802 4:468f4c8d3d5b
       
     1 <?xml version="1.0" encoding="UTF-8"?>
       
     2 <!--
       
     3 Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
       
     4 All rights reserved.		
       
     5 		-->
       
     6 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
       
     7 <reference xml:lang="en-us" outputclass="element" id="cxxUnion">
       
     8     <title>cxxUnion</title>
       
     9     <shortdesc>The &lt;cxxUnion&gt; element provides the name of the C++ API
       
    10 union, all the elements necessary to describe the members that are introduced
       
    11 by the union declaration.</shortdesc>
       
    12     <refbody>
       
    13         <section>
       
    14             <title>Description</title>
       
    15             <p>The &lt;cxxUnion&gt; element requires
       
    16 an ID attribute as an anchor point; this ID must always be specified. The
       
    17 ID attribute is referenced by the <i>conref</i> attribute and internal applications
       
    18 that refer to the  &lt;cxxUnion&gt; element content. The elements &lt;apiName&gt; 
       
    19 and &lt;cxxUnionDetail&gt; are required for this top-level container. </p>
       
    20         </section>
       
    21         <example><title>Example</title>
       
    22         <codeblock>&lt;cxxUnion id=&quot;union_comms_packer_1_1_t_union&quot;&gt;
       
    23 	&lt;apiName&gt;CommsFW::TCFLegacyMessagePacker::TUnion&lt;/apiName&gt;
       
    24 	&lt;cxxUnionDetail&gt;
       
    25 		&lt;cxxUnionDefinition&gt;
       
    26 			&lt;cxxUnionAccessSpecifier value=&quot;private&quot;/&gt;
       
    27 			&lt;cxxUnionAPIItemLocation&gt;
       
    28 				&lt;cxxUnionDeclarationFile name=&quot;filePath&quot; value=&quot;C:/src/include/elements/cftransportmsg.h&quot;/&gt;
       
    29 				&lt;cxxUnionDeclarationFileLine name=&quot;lineNumber&quot; value=&quot;59&quot;/&gt;
       
    30 				&lt;cxxUnionDefinitionFile name=&quot;filePath&quot; value=&quot;C:/src/include/elements/cftransportmsg.h&quot;/&gt;
       
    31 				&lt;cxxUnionDefinitionFileLineStart name=&quot;lineNumber&quot; value=&quot;58&quot;/&gt;
       
    32 				&lt;cxxUnionDefinitionFileLineEnd name=&quot;lineNumber&quot; value=&quot;70&quot;/&gt;
       
    33 			&lt;/cxxUnionAPIItemLocation&gt;
       
    34 		&lt;/cxxUnionDefinition&gt;
       
    35 		&lt;apiDesc/&gt;
       
    36 	&lt;/cxxUnionDetail&gt;
       
    37 	&lt;cxxUnionNested&gt;
       
    38 		&lt;cxxUnionNestedDetail&gt;
       
    39 			&lt;cxxUnionNestedStruct href=&quot;struct_comms_package.xml#struct_package&quot;&gt;CommsFW::TCFLegacyMessagePacker::TUnion::TLegacyPackage&lt;/cxxUnionNestedStruct&gt;
       
    40 			&lt;cxxUnionNestedStruct href=&quot;struct_comms_package.xml#struct_package&quot;&gt;CommsFW::TCFLegacyMessagePacker::TUnion::TPackage&lt;/cxxUnionNestedStruct&gt;
       
    41 		&lt;/cxxUnionNestedDetail&gt;
       
    42 	&lt;/cxxUnionNested&gt;
       
    43 &lt;/cxxUnion&gt;</codeblock>
       
    44         </example>        
       
    45         <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-containedBy-section"/>
       
    46         <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-contains-section"/>
       
    47         <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-contentModel-section"/>
       
    48         <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-attList-section"/>
       
    49         <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-classValue-section"/>
       
    50     </refbody>
       
    51 </reference>