<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-37057FD5-7ED0-5B18-9C28-39F6816D7627" xml:lang="en"><title>Arrays
within structs</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>A declaration of a struct member may either be a simple <varname>type-name</varname>  <varname>member-name</varname>,
or it may be an array of values of identical type.</p>
<p>Arrays are always indicated by square brackets:</p>
<codeblock id="GUID-4F6A2882-FDF8-5DBA-A01D-6772D5BDF70F" xml:space="preserve">STRUCT HAS_ARRAY
 {
 STRUCT elements[];
 }</codeblock>
<p>In the example above, the <codeph>HAS_ARRAY</codeph> struct has one array
member, <codeph>elements</codeph>. Each member of <codeph>elements</codeph> is
of <codeph>STRUCT</codeph> type.</p>
<p><b>Array size</b> </p>
<p>If you specify the array size, inside the square brackets, then the generated
resource will contain no count of the number of elements. So this resource:</p>
<codeblock id="GUID-F50D2117-7554-5D80-ABF1-2393E65B54CB" xml:space="preserve">STRUCT FIXED_ARRAY
 {
 WORD elements[3];
 }

RESOURCE FIXED_ARRAY example1
 {
 elements={9,8,7};
 }</codeblock>
<p>will generate the output</p>
<codeblock id="GUID-880DF2CB-D042-59CD-AF28-89D971CC6466" xml:space="preserve">0x09 0x00 0x08 0x00 0x07 0x00</codeblock>
<p>For variable length arrays, a count of the number of elements precedes
the resource. The default for this is a word, but by prefixing the struct
definition with <codeph>LEN BYTE</codeph> it will be a byte count. So the
following resource:</p>
<codeblock id="GUID-FEAD195C-8C3F-529F-AE2A-AC42F2ACA66F" xml:space="preserve">STRUCT VAR_ARRAY
 {
 WORD elements [];
 }

RESOURCE VAR_ARRAY example2
 {
 elements={9,8,7};
 }</codeblock>
<p>will generate the output</p>
<codeblock id="GUID-D21EA8C8-876D-5DD8-9F0C-256288A2B6B1" xml:space="preserve">0x03 0x00 0x09 0x00 0x08 0x00 0x07 0x00 </codeblock>
<p>whereas this resource:</p>
<codeblock id="GUID-14A52C15-5D28-5716-AED4-22F02AF23AAE" xml:space="preserve">STRUCT VAR_ARRAY2
 {
 LEN BYTE WORD elements[];
 }

RESOURCE VAR_ARRAY2 example3
 {
 elements={9,8,7};
 }</codeblock>
<p>will generate this output</p>
<codeblock id="GUID-3909C1FE-84B3-50D1-9519-417B84DD93B0" xml:space="preserve">0x03 0x09 0x00 0x08 0x00 0x07 0x00</codeblock>
<p>The compiler allows you to prefix <codeph>LEN BYTE</codeph> or <codeph>LEN
WORD</codeph> even for fixed length arrays, but it has no effect. Fixed length
arrays do not generate an element count.</p>
</conbody><related-links>
<link href="GUID-0142B290-DA6C-5574-83D7-7555D804D9B5.dita"><linktext>How to initialise
array RESOURCE members</linktext></link>
</related-links></concept>