<?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-AECDAEBF-777A-579B-92F8-560FD7FF86E7" xml:lang="en"><title>NAME

statement</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<codeblock xml:space="preserve">&lt;name-statement&gt;

name-statement ::= 

NAME &lt;short-name&gt;</codeblock>

<p>Use this statement to ensure that the resources in the file have a unique

ID so that an application can use multiple resource files without resource

ID conflict.</p>

<p>This statement must be the first non-comment statement in the file.</p>

<p>The <varname>short-name</varname> must be between one and four alphabetic

characters long and be unique (no other file may use the same one). For the

sake of consistency this constant should be in upper case although lower case

is allowed (and will be converted to upper case by the compiler). This <varname>short-name</varname> is

then converted into a number and shifted onto the leading 20 bits of the resource

ID, leaving the bottom 12 bits for the number of the resource in the file.

This allows a maximum of 4095 resources to be defined in a source file.</p>

<p>Since the <codeph>NAME</codeph> statement maps all resource IDs within

the file onto 32-bit numbers, only <codeph>LLINK</codeph> s may be used for

resource references in that file. Using the <codeph>NAME</codeph> statement

in a resource file means that any attempt to use a <codeph>LINK</codeph> will

generate an error.</p>

<example><p>With <codeph>NAME</codeph> set to <codeph>AAAA</codeph>,

if this resource is the first resource in the file</p><codeblock id="GUID-42436ADC-996A-5D24-BC6B-8072DF8F271F" xml:space="preserve">RESOURCE STRING one

 {

 wd=5;

 }</codeblock><p>the first entry in the generated header file will be</p><codeblock id="GUID-707F02E8-CD7D-54BB-B11D-FB3B46876DF5" xml:space="preserve">#define ONE 0x04FD8001</codeblock><p>04FD8

is the leading 20 bits for all IDs in the file and 001 is the reference of

that resource within the file.</p></example>

</conbody></concept>