<?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 xml:lang="en" id="GUID-EAEE54D0-4580-5BE7-AA16-4ABC216B4EB0"><title>How to list directories and files</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>The list of a directory's contents can obtained by using two variants of the function <codeph>RFs::GetDir()</codeph>. Both variants provide a filtered list of files and directories; the second additionally provides a separate list containing directories only. Both variants use an attribute mask to filter the entry types. </p> <p>The following sections assume that some directories and a file have been created in a directory <filepath>FileserverExample</filepath>, and then lists them in alphabetical order.</p> <section><title>Listing directories and files together</title> <ol id="GUID-EF43DF74-3059-50A2-854A-59985457877B"><li id="GUID-5781228A-BDB8-5E80-AFFF-9B0CB1E574A9"><p>Declare a <codeph>CDir</codeph> pointer. This type holds an array of directory entries.</p> </li> <li id="GUID-184CBE11-E62C-542F-9F95-718960F72639"><p>Use <codeph>GetDir()</codeph> to get a single list, in the <codeph>CDir</codeph> object, which can contain both file and directory entries.</p> <p>Use <codeph>KEntryAttMaskSupported</codeph> to indicate all five file attributes, and the directory attribute.</p> <p>Use <codeph>ESortByName</codeph> to order the entries alphabetically.</p> </li> <li id="GUID-3AD0DD32-B772-5B9B-A3BF-32DAC34D00E3"><p><codeph>CDir::operator[]()</codeph> can be used to get the attributes, name, size and modification date and time of the <codeph>TEntry</codeph> at the specified index within the array. </p> </li> <li id="GUID-BCD0DB7B-8329-5C3F-B194-68D77FB1C9C5"><p>Delete the <codeph>CDir</codeph> object after use.</p> </li> </ol> <codeblock id="GUID-5C104BEF-855C-55F3-8648-3DB6285A3607" xml:space="preserve">

_LIT(KDir,"\\FileserverExample\\*");

CDir* dirList;

User::LeaveIfError(fsSession.GetDir(KDir,

        KEntryAttMaskSupported,ESortByName,dirList));

_LIT(KString,"%S");

for (TInt i=0;i<dirList->Count();i++)

    console->Printf(KString,&(*dirList)[i].iName);

delete dirList;</codeblock> <p><b>Notes</b> </p> <ul><li id="GUID-6BACC898-1046-52BF-9338-445C4685DFA6"><p><codeph>GetDir()</codeph> supports the use of the two <keyword>wildcard</keyword> characters: <filepath>*</filepath> (meaning any sequence of characters within any part of a component), and <filepath>?</filepath> (meaning any single character).</p> </li> </ul> </section> <section><title>Listing directories and files separately</title> <p>If you want files and directories to be listed separately, another variant of <codeph>GetDir()</codeph> should be used. On return, the first list contains only files, the second directories.</p> <ol id="GUID-EE1E3D1B-109C-50B4-814F-1AA37105E8DE"><li id="GUID-ACE8E30C-3784-552F-B2F1-8A5C7ACE52CA"><p>Use <codeph>GetDir()</codeph> to provide a list of directories and files and additionally a separate list of directories only.</p> </li> <li id="GUID-5B68A082-7725-5F05-BCB0-2B8513803001"><p>If the attribute mask <codeph>KEntryAttNormal</codeph> is used, no system or hidden files or directories are included in the file list.</p> </li> </ol> <codeblock id="GUID-E8D48A34-62EA-588C-9B10-36B87CCF27D6" xml:space="preserve">CDir* fileList;

User::LeaveIfError(fsSession.GetDir(KDir,

        KEntryAttNormal,ESortByName,fileList,dirList));</codeblock> </section> </conbody></concept>