Symbian3/SDK/Source/GUID-843B3C4E-153D-5673-95EA-88322D689297.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-843B3C4E-153D-5673-95EA-88322D689297.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,51 @@
+<?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 id="GUID-843B3C4E-153D-5673-95EA-88322D689297" xml:lang="en"><title>File
+names</title><shortdesc>This topic describes the file name and the limitations of
+using them.</shortdesc><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 recognized 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>
\ No newline at end of file