<?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-0D619063-F2DB-53FC-A5E6-BC09AD915FA4" xml:lang="en"><title>Resource

member initialisation overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>The resource initialiser has different forms depending on whether a single,

simple, member is being initialised, or whether a struct or an array is being

initialised:</p>

<codeblock xml:space="preserve">&lt;resource-initialiser&gt;

<b>resource-initialiser ::</b>=

	<member-name> [ (<length-limit>) ] = <initialiser><initialiser>

<b>initialiser :</b>:=

	&lt;simple-initialiser&gt; | &lt;struct-initialiser&gt; | &lt;array-initialiser&gt;</codeblock>

<p>Resource members may be initialised by default (in the struct definition)

or explicitly initialised (in the resource definition).</p>

<p>In general,</p>

<ul>

<li id="GUID-E712BF25-9F6A-5E9E-8F85-7ACBF010F7C1"><p>If a member is initialised

in a <codeph>RESOURCE</codeph> statement, then that is its value.</p> </li>

<li id="GUID-FF416E99-A21F-5525-B01C-BEA51B216E25"><p>If a member is initialised

in a <codeph>STRUCT</codeph> statement, then that is its value for all resources

which do not explicitly initialise it.</p> </li>

<li id="GUID-CA918017-F0C1-5E1F-8D8A-893653C2D94E"><p>If a member is <i>neither</i> initialised

in a <codeph>RESOURCE</codeph> statement <i>nor</i> a <codeph>STRUCT</codeph> statement,

then: <codeph>BYTE</codeph>, <codeph>WORD</codeph> and <codeph>DOUBLE</codeph> members

contain zero; <codeph>TEXT</codeph>, <codeph>LTEXT</codeph> and <codeph>BUF</codeph> members

contain an empty string.</p> </li>

<li id="GUID-590BD79C-AB1B-537C-9A23-3F0902539B3A"><p>It is an error for <codeph>LINK</codeph> and <codeph>LLINK</codeph> members

to have no explicit value, so they must be initialised, either by default

(in the <codeph>STRUCT</codeph> statement) or explicitly (in the <codeph>RESOURCE</codeph> statement).</p> </li>

<li id="GUID-F0C0C9CB-625B-5307-81EF-F78AC284CB0B"><p><codeph>SRLINK</codeph> members

may not be initialised (either in the <codeph>STRUCT</codeph> statement or

a <codeph>RESOURCE</codeph> statement) since they are automatically assigned

the resource id of the resource in which they appear.</p> </li>

<li id="GUID-23FBAA84-2826-5972-9D75-AEB2082A01D7"><p>Members which are themselves <codeph>STRUCT</codeph> s

may not be default initialised. They can only be initialised in the <codeph>RESOURCE</codeph> definition.

If they are not explicitly initialised, they will take up zero bytes in the

resource file. For example, given the following <codeph>STRUCT</codeph> definition:</p> <codeblock id="GUID-82D529DD-EF78-56B6-96CC-D245C0C5C046" xml:space="preserve">STRUCT TEST2 

 {

 WORD    value;

 STRUCT  tester;

 }</codeblock> <p>The following <codeph>RESOURCE</codeph> statement only generates

the two bytes <codeph>0xFF 0x00</codeph>.</p> <codeblock id="GUID-B97A619C-8299-5FC9-AD49-658F21568E2F" xml:space="preserve">RESOURCE TEST2 item

 {

 value=255;

 }</codeblock> </li>

</ul>