--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-9620407B-0560-5D95-A862-5AE406C48983-GENID-1-8-1-3-1-1-8-1-7-1.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,61 @@
+<?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-9620407B-0560-5D95-A862-5AE406C48983-GENID-1-8-1-3-1-1-8-1-7-1" xml:lang="en"><title>String
+resource reader overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-AF5A789B-6F00-42A9-86AE-CB972F97BE00-GENID-1-8-1-3-1-1-8-1-7-1-2-1"><title>Purpose</title> <p>String
+Resource Reader is part of the Symbian Text Utilities component. It reads
+strings from resource files without using the <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>CCoeEnv</apiname></xref> instance.
+This module is mainly for server usage, where there is a need for reading
+resources, but there is no <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>CCoeEnv</apiname></xref> instance
+present. </p> </section>
+<section id="GUID-F336660C-3F54-4B65-85AA-F6D557FE1DC2-GENID-1-8-1-3-1-1-8-1-7-1-2-2"><title>Architectural
+Relationships</title> <p>The key relationships between String Resource Reader
+and the components in its environment are shown below. It uses the <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>RResourceFile</apiname></xref> class to access
+the actual resource files. </p> <fig id="GUID-EF915116-AF30-58ED-A3AC-ED104AF22687-GENID-1-8-1-3-1-1-8-1-7-1-2-2-3">
+<title>              String Resource Reader environment            </title>
+<image href="GUID-B409C23A-F89E-5D30-B172-1F39C3F6A57F_d0e18988_href.png" placement="inline"/>
+</fig> <p>String Resource Reader consists of one class, <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>CTulStringResourceReader</apiname></xref>.
+String Resource Reader uses <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>BaflUtils</apiname></xref> and <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>RResourceFile.</apiname></xref>  </p> <fig id="GUID-497C1945-CD4F-5396-8B45-E809380A129C-GENID-1-8-1-3-1-1-8-1-7-1-2-2-5">
+<title>              Class diagram            </title>
+<image href="GUID-5DB0F7C7-6132-552B-BA42-B47D267D1143_d0e19011_href.png" placement="inline"/>
+</fig> </section>
+<section id="GUID-9595A884-0840-41D5-9448-E0297941DBA9-GENID-1-8-1-3-1-1-8-1-7-1-2-3"><title>Description</title> <p><b>Usage</b> </p> <p>String
+Resource Reader is designed to load strings from normal resource files. The
+interface can be accessed through the <codeph>tulstringresourcereader.h</codeph> file </p> <ul>
+<li id="GUID-9EEA6DC6-06BC-50B3-BB0B-9CCFCE21F852-GENID-1-8-1-3-1-1-8-1-7-1-2-3-4-1"><p>1. The user must first
+create an instance of the <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>CTulStringResourceReader</apiname></xref> class
+using one of the factory methods <codeph>NewL()</codeph> or <codeph>NewLC()</codeph>. </p> </li>
+<li id="GUID-B35D9F76-F4F8-5B43-8FEA-F044F2D63468-GENID-1-8-1-3-1-1-8-1-7-1-2-3-4-2"><p>2. The user can then
+call the exported <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>ReadResourceString()</apiname></xref> method
+to read resources </p> </li>
+<li id="GUID-51C7AB86-F420-584A-81A4-F652C7338714-GENID-1-8-1-3-1-1-8-1-7-1-2-3-4-3"><p>3. After usage the created
+instance must be deleted. </p> </li>
+</ul> <p>If the resource file that is given to a constructor is not found,
+the constructor leaves. The standard Symbian platform error codes are used. </p> <p><b>Example</b> </p> <p>An
+example of using the interface is given below: </p> <codeblock id="GUID-D484CAC5-5BA0-5666-B1DF-082E0A2A27BA-GENID-1-8-1-3-1-1-8-1-7-1-2-3-8" xml:space="preserve">#include &lt;tulstringresourcereader.h&gt;
+#include &lt;errorres.rsg&gt; // Resource to be read header 
+
+//...
+TFileName myFileName( _L("z:\\system\\data\\errorres.rsc") );
+TulTextResourceUtils* test = TulTextResourceUtils::NewL( myFileName );
+
+TPtrC buf;
+buf.Set(test-&gt; ReadResourceString(R_ERROR_RES_GENERAL)); 
+   
+// Note that buf will only be valid as long as TulTextResourceUtils 
+// instance is alive and no new string is read by the same instance.
+// If you need to read multiple strings, make copies.
+
+delete test;
+</codeblock> <p>For more information on individual methods, see the reference
+API for <xref href="GUID-0AAAEFCF-ACFC-302C-81FA-388AACEE979C.dita"><apiname>CTulStringResourceReader</apiname></xref>. </p> </section>
+</conbody></concept>
\ No newline at end of file