<?xml version="1.0" encoding="UTF-8"?>

<!--

Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).

All rights reserved.		

		-->

<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

<reference xml:lang="en-us" outputclass="element" id="cxxUnion">

    <title>cxxUnion</title>

    <shortdesc>The &lt;cxxUnion&gt; element provides the name of the C++ API

union, all the elements necessary to describe the members that are introduced

by the union declaration.</shortdesc>

    <refbody>

        <section>

            <title>Description</title>

            <p>The &lt;cxxUnion&gt; element requires

an ID attribute as an anchor point; this ID must always be specified. The

ID attribute is referenced by the <i>conref</i> attribute and internal applications

that refer to the  <cxxUnion> element content. The elements <apiName> 

and &lt;cxxUnionDetail&gt; are required for this top-level container. </p>

        </section>

        <example><title>Example</title>

        <codeblock>&lt;cxxUnion id=&quot;union_comms_packer_1_1_t_union&quot;&gt;

	<apiName>CommsFW::TCFLegacyMessagePacker::TUnion</apiName>

	<cxxUnionDetail>

		<cxxUnionDefinition>

			<cxxUnionAccessSpecifier value="private"/>

			<cxxUnionAPIItemLocation>

				<cxxUnionDeclarationFile name="filePath" value="C:/src/include/elements/cftransportmsg.h"/>

				<cxxUnionDeclarationFileLine name="lineNumber" value="59"/>

				<cxxUnionDefinitionFile name="filePath" value="C:/src/include/elements/cftransportmsg.h"/>

				<cxxUnionDefinitionFileLineStart name="lineNumber" value="58"/>

				<cxxUnionDefinitionFileLineEnd name="lineNumber" value="70"/>

			</cxxUnionAPIItemLocation>

		</cxxUnionDefinition>

		<apiDesc/>

	</cxxUnionDetail>

	<cxxUnionNested>

		<cxxUnionNestedDetail>

			<cxxUnionNestedStruct href="struct_comms_package.xml#struct_package">CommsFW::TCFLegacyMessagePacker::TUnion::TLegacyPackage</cxxUnionNestedStruct>

			<cxxUnionNestedStruct href="struct_comms_package.xml#struct_package">CommsFW::TCFLegacyMessagePacker::TUnion::TPackage</cxxUnionNestedStruct>

		</cxxUnionNestedDetail>

	</cxxUnionNested>

&lt;/cxxUnion&gt;</codeblock>

        </example>        

        <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-containedBy-section"/>

        <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-contains-section"/>

        <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-contentModel-section"/>

        <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-attList-section"/>

        <section conref="../packagedef.dita#cxxUnion-reference/cxxUnion-classValue-section"/>

    </refbody>

</reference>