<?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-843B3C4E-153D-5673-95EA-88322D689297"><title>File names</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>The file server presents a DOS-like file system with long file names. For compatibility with traditional DOS filenames, an extension is recognised on names with appropriate formats. </p> <p>When creating a file or directory note the following restrictions which apply to the path and its components. </p> <ul><li id="GUID-59880AE6-D5E4-5D6B-91AC-22134438D44F"><p>The total length of the path including drive, path, name and extension, must not exceed 256 characters. </p> </li> <li id="GUID-F5DDBB15-3AC5-534C-8401-8C5B19D71963"><p>Wildcards cannot be used in any path component including the filename and extension, although some higher level classes allow the use of wildcard characters in the filename and extension. These classes are covered later in this guide. </p> </li> <li id="GUID-29CE26E0-ADE6-5C35-AF3C-9E9475D7D95D"><p>Two consecutive backslashes are not allowed in the path. </p> </li> <li id="GUID-64D83F1D-D2D3-555F-AA09-E88E53C85D14"><p>The following characters must not be included anywhere in the path (all other characters are acceptable) <filepath>&lt;</filepath>  <filepath>&gt;</filepath> <filepath>"</filepath>  <filepath>/</filepath>  <filepath>|</filepath> </p> </li> <li id="GUID-FB41B42D-61A0-5B63-AC0C-7419B22DDE8C"><p>A <filepath>:</filepath> (colon) may only be included immediately after the drive. </p> </li> <li id="GUID-34B762BC-BA07-5292-A974-00C4DC65271E"><p>The path components are separated by <filepath>\</filepath> backslashes, and a final backslash must be used to indicate that a name is a path. </p> </li> <li id="GUID-97825981-208E-5946-8F83-F8EB2EA4A4EE"><p>Long filenames are supported, so a path or filename may have any number of full stops in it, with the exception that following the final backslash (the filename and extension), the space characters and names "<filepath>.</filepath> " and "<filepath>..</filepath> " are not permitted as path components. </p> </li> <li id="GUID-2EB050AC-652C-55C1-AE3F-1C3FC775BF20"><p>Spaces between the drive, if specified, and the first directory in the path are illegal, although there may be spaces between other path components, for instance between directories. </p> </li> </ul> <p>The file server does not use <filepath>.</filepath> and <filepath>..</filepath> to mean current directory and parent directory respectively. If required, these must be implemented by higher-level code. The <xref href="GUID-F673F02A-AC5B-3D0F-8D14-21E6221E5015.dita"><apiname>TParseBase</apiname></xref> class provides filename parsing and manipulation functions. </p> <p>The function <xref href="GUID-E263C747-946F-35AA-9F1D-41833BD350FC.dita#GUID-E263C747-946F-35AA-9F1D-41833BD350FC/GUID-91C2BEAC-2210-3CBA-A954-A5C52FFA1947"><apiname>RFs::IsValidName()</apiname></xref> tells you whether a path name is valid or not. </p> </conbody></concept>