week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
<?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 reference
PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="GUID-8DCBAA05-9741-48C8-A831-966D37FBC05A" xml:lang="en"><title>Array
Properties</title><shortdesc>A property that defines multiple discrete values inside one property
ID is called an array property.</shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody>
<section id="GUID-B38A0885-F52B-44F7-916D-F43530E74BC3"> <p>Array properties
can be identified with array index, which can be queried using the <xref href="GUID-FA59DA5D-A9E4-3296-AB90-E445C7949FE9.dita#GUID-FA59DA5D-A9E4-3296-AB90-E445C7949FE9/GUID-2752A152-7821-30E8-AEC7-542F9F362575"><apiname>TSensrvProperty::GetArrayIndex()</apiname></xref> function.</p>
</section>
<example><p>The following example shows how to retrieve the current data rate
of the channel, for which the data rate is declared as an array property. </p><p>Read
the <codeph>KSensrvPropIdDataRate</codeph> property using the <xref href="GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844.dita#GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844/GUID-1E9D960B-23C4-30DF-A184-7E978AC9AC1B"><apiname>CSensrvChannel::GetPropertyL()</apiname></xref> function.</p><p>If
the retrieved property is an array property the result of the <xref href="GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844.dita#GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844/GUID-1E9D960B-23C4-30DF-A184-7E978AC9AC1B"><apiname>CSensrvChannel::GetPropertyL()</apiname></xref> call
is a property with array index <codeph>ESensrvArrayPropertyInfo</codeph>,
otherwise the array information index is <codeph>ESensrvSingleProperty</codeph>. </p><p>In
case of an array property, the value of the current data rate is in the <codeph>KSensrvPropIdDataRate</codeph> property,
for which the array index is the same as the array property's value. </p><codeblock xml:space="preserve">TSensrvProperty property;
TInt err( KErrNone );
TInt datarate( 0 );
iSensorChannel->GetPropertyL( KSensrvPropIdDataRate,
KSensrvItemIndexNone,
property );
if( ESensrvArrayPropertyInfo == property.GetArrayIndex() )
{
//Current data rate in use is in the KSensrvPropIdDataRate property
//for which the array index is declared in the array property's value.
TInt arrayIndex( 0 );
property.GetValue( arrayIndex );
iSensorChannel->GetPropertyL( KSensrvPropIdDataRate,
KSensrvItemIndexNone,
arrayIndex,
property );
property.GetValue( datarate );
}
else
{
//KSensrvPropIdDataRate is a single property and current data rate can be read diretly from it.
property.GetValue( datarate );
}</codeblock></example>
</refbody></reference>