<?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-32F00078-6084-5288-9D3F-9F8D70514799" xml:lang="en"><title>RESOURCE
statement</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<codeblock xml:space="preserve">&lt;resource-statement&gt;
resource-statement ::= 
RESOURCE &lt;struct-name&gt; [ &lt;resource-name&gt; ] { &lt;resource-initialiser-list&gt; } </codeblock>
<p>The <codeph>RESOURCE</codeph> statement is used to generate a resource
in the resource file. The statement specifies three things:</p>
<ul>
<li id="GUID-F51FD208-5879-57EF-9E16-914A1F4F1FE7"><p>a <varname>struct-name</varname> which
denotes the structure that will be used for the resource</p> <p>It must have
been defined in a previous <codeph>STRUCT</codeph> statement and must be in
upper case.</p> </li>
<li id="GUID-1EE96D74-26D0-5BC3-8EDC-19CD924515D0"><p>an optional <varname>resource-name</varname> which
identifies the resource</p> <p>The <codeph>resource-name</codeph> must be
in lower case.</p> <p>The <codeph>resource-name</codeph> causes a symbolic
constant to be generated in the resource compiler’s output header file, so
that a resource</p> <codeblock id="GUID-505C63EA-20A4-5019-BA34-FEAED516E037" xml:space="preserve">RESOURCE TEST my_test { /* etc */ }</codeblock> <p>will
result in a definition of the form</p> <codeblock id="GUID-4FBB0DF1-09D6-54CA-AAD4-F29BFCC27A42" xml:space="preserve">#define MY_TEST 1</codeblock> <p>in
the generated header file.</p> <p>The default ID for the first resource defined
in the file is one with subsequent resources’ IDs generated in ascending sequence.
See <xref href="GUID-F9605837-2209-500D-AB62-48A433489C5E.dita">Resource file definition</xref> for
more information on how resource IDs are generated.</p> <p>If no resource
name is specified then the resource is generated in the object file and assigned
a resource ID as usual, but will not be published in the header file. Anonymous
resources are used mainly for playback scripts where the resources are read
in sequentially by default, so that assigning names to them would be superfluous.</p> <p>The <codeph>resource-name</codeph> may
also be used by the resource compiler for <codeph>LINK</codeph> and <codeph>LLINK</codeph> members
— see <xref href="GUID-FFD56DA3-9301-5679-9209-A70CE63A34A2.dita">Resource identifiers
for LINKs and LLINKs</xref>.</p> </li>
<li id="GUID-4F0ED7DA-1A16-53FE-A1E0-98298A9B2BB0"><p>initialisation for members
of the resource struct, where their default values are not appropriate</p> </li>
</ul>
<example><p>As an example, given the struct definition</p><codeblock id="GUID-D2FBD433-0A85-5C0C-9CD2-CFC08F20E14E" xml:space="preserve">STRUCT NCEDIT
 {
 WORD current;
 WORD low;
 WORD high=65535;
 }</codeblock><p>you could define a resource:</p><codeblock id="GUID-4B005C45-B0EF-542D-BD63-0D2E02186FFA" xml:space="preserve">RESOURCE NCEDIT memory_size
 {
 low=640;
 high=1024;
 }</codeblock><p>Thus, in the resource file, <codeph>current</codeph> has
the value compiler default value of 0, <codeph>low</codeph> has the value
640 (specified in the resource definition) and <codeph>high</codeph> has the
value 1024 (specified in the resource definition, overriding the default for
the struct type).</p></example>
</conbody></concept>