|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-05785721-C090-50C6-BE5E-46EF14222FFF" xml:lang="en"><title>8 |
|
13 bit variant, 16 bit variant and build independence</title><shortdesc>This document describes 8 bit variant, 16 bit variant and build |
|
14 independence.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <p>Descriptors are supplied in two variants:</p> |
|
16 <ul> |
|
17 <li id="GUID-6CAEBC92-A518-5623-8DE4-A685091CBD5B"><p>the 16 bit variant for |
|
18 handling Unicode strings and double byte valued data</p> </li> |
|
19 <li id="GUID-9D9C6C04-FFC2-5E41-8E55-E62DCC04CB31"><p>the 8 bit variant for |
|
20 handling non-Unicode strings and single byte valued data (binary data).</p> </li> |
|
21 </ul> |
|
22 <p>Descriptors are also supplied as build independent types. These are used |
|
23 whenever descriptors are used to represent text strings. By using build independent |
|
24 types, the appropriate variant, either 16 bit or 8 bit, is selected at build |
|
25 time depending on whether the <codeph>_UNICODE</codeph> macro has been defined |
|
26 or not.</p> |
|
27 <p>Binary data always requires the 8 bit variant, regardless of the build, |
|
28 and this should be explicitly used in program code.</p> |
|
29 <p>Explicit use of the 16 bit variant is rare.</p> |
|
30 <p>With a few exceptions, the behaviour of both 8 bit and 16 bit variants |
|
31 is the same.</p> |
|
32 </conbody></concept> |