Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
<?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 task
PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-3AFA592E-ED32-5AC6-B331-E7191CF2D5E2" xml:lang="en"><title>Checking
the Availability of Memory</title><abstract><p>This section explains the System Utility functionality of checking
the disk space. </p><p> Perform one or more of the following steps based
on the requirements: </p></abstract><prolog><metadata><keywords/></metadata></prolog><taskbody>
<steps-unordered>
<step id="GUID-83BADD5E-2C9A-5618-8AAF-85B2622014EA"><cmd/>
<info>To check whether the disk space is below the critical level in FFS (also
called the system drive), call <codeph>FFSSpaceBelowCriticalLevelL()</codeph> function. </info>
</step>
<step id="GUID-07E3E228-06D4-55C2-A096-3B5A843B9117"><cmd/>
<info>To check whether the disk space is below the critical level in MMC storage,
call <codeph>MMCSpaceBelowCriticalLevelL()</codeph> function. </info>
</step>
<step id="GUID-6F08817D-06C2-51DA-BB10-9285AE37BC60"><cmd/>
<info>To check whether the disk space is below the critical level on a disk
drive, call <codeph>DiskSpaceBelowCriticalLevelL()</codeph> function. </info>
</step>
</steps-unordered>
<result><p>The functions return <codeph>ETrue</codeph> if the number of bytes
to be written takes the memory below the critical level, else returns <codeph>EFalse</codeph>. </p> </result>
<example><title>Example</title> <p>The following is an code fragment illustrating
how to check whether the disk space is below critical level: </p> <codeblock id="GUID-4B885F54-1112-5538-872C-15C3DA8A3B3A" xml:space="preserve">TInt dataSize = 500;
if ( SysUtil::DiskSpaceBelowCriticalLevelL( &iFsSession, dataSize, EDriveC ) )
{
// Cannot write the data, there's not enough free space on disk.
...
}
else
{
// It's ok to actually write the data.
...
}
</codeblock> </example>
</taskbody><related-links>
<link href="GUID-ED6ED5E6-5A95-54F2-B5B2-6145A10F44BE.dita"><linktext>System Utilities
Overview</linktext></link>
<link href="GUID-79370E26-4549-5F31-99A3-8D0341F58F08.dita"><linktext>Retrieving
the Software and Language Versions</linktext></link>
</related-links></task>