lazarus/docs/xml/lazutils/lazfileutils.xml
mattias 3595a693a9 LazUtils: added GetUnixPhysicalFilename
git-svn-id: trunk@44578 -
2014-04-01 11:10:35 +00:00

1106 lines
20 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<fpdoc-descriptions>
<package name="lazutils">
<!--
====================================================================
LazFileUtils
====================================================================
-->
<module name="LazFileUtils">
<short/>
<descr>
</descr>
<!-- function Visibility: default -->
<element name="CompareFilenames">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CompareFilenames.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenames.Filename1">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenames.Filename2">
<short/>
</element>
<!-- function Visibility: default -->
<element name="CompareFilenamesIgnoreCase">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CompareFilenamesIgnoreCase.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenamesIgnoreCase.Filename1">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenamesIgnoreCase.Filename2">
<short/>
</element>
<!-- function Visibility: default -->
<element name="CompareFileExt">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CompareFileExt.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFileExt.Filename">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFileExt.Ext">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFileExt.CaseSensitive">
<short/>
</element>
<!-- function Visibility: default -->
<element name="CompareFilenameStarts">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CompareFilenameStarts.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenameStarts.Filename1">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenameStarts.Filename2">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenames.Len1">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CompareFilenames.Len2">
<short/>
</element>
<!-- function Visibility: default -->
<element name="DirPathExists">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="DirPathExists.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="DirPathExists.DirectoryName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="DirectoryIsWritable">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="DirectoryIsWritable.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="DirectoryIsWritable.DirectoryName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="ExtractFileNameOnly">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="ExtractFileNameOnly.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="ExtractFileNameOnly.AFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FilenameIsAbsolute">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FilenameIsAbsolute.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FilenameIsAbsolute.TheFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FilenameIsWinAbsolute">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FilenameIsWinAbsolute.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FilenameIsWinAbsolute.TheFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FilenameIsUnixAbsolute">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FilenameIsUnixAbsolute.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FilenameIsUnixAbsolute.TheFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="ForceDirectory">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="ForceDirectory.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="ForceDirectory.DirectoryName">
<short/>
</element>
<!-- procedure Visibility: default -->
<element name="CheckIfFileIsExecutable">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- argument Visibility: default -->
<element name="CheckIfFileIsExecutable.AFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileIsExecutable">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileIsExecutable.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsExecutable.AFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileIsReadable">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileIsReadable.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsReadable.AFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileIsWritable">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileIsWritable.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsWritable.AFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileIsText">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileIsText.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsText.AFilename">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsText.FileReadable">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FilenameIsTrimmed">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FilenameIsTrimmed.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FilenameIsTrimmed.TheFilename">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FilenameIsTrimmed.StartPos">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FilenameIsTrimmed.NameLen">
<short/>
</element>
<!-- function Visibility: default -->
<element name="TrimFilename">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="TrimFilename.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="TrimFilename.AFilename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="CleanAndExpandFilename">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CleanAndExpandFilename.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CleanAndExpandFilename.Filename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="CleanAndExpandDirectory">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CleanAndExpandDirectory.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CleanAndExpandDirectory.Filename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="TrimAndExpandFilename">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="TrimAndExpandFilename.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="TrimAndExpandFilename.Filename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="TrimAndExpandDirectory">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="TrimAndExpandDirectory.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="TrimAndExpandDirectory.Filename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="CreateRelativePath">
<short>Creates a relative path from BaseDirectory to Filename</short>
<descr>Creates a relative path from BaseDirectory to Filename.
A trailing path delimiter of BaseDirectory is ignored.
If there is no relative path it returns Filename.
If BaseDirectory and Filename are the same and UsePointDirectory is false it returns the empty string. If UsePointDirectory is true it returns '.'.
Duplicate path delimiters are treated as one.
In other words if it returns a relative file name then the following is true:
TrimFilename(Filename) = TrimFilename(BaseDirectory+PathDelim+Result).
This function is thread safe and therefore does not support current directories
as needed by Windows file names like D:test.
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CreateRelativePath.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CreateRelativePath.Filename">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CreateRelativePath.BaseDirectory">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CreateRelativePath.UsePointDirectory">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileIsInPath">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileIsInPath.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsInPath.Filename">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsInPath.Path">
<short/>
</element>
<!-- function Visibility: default -->
<element name="AppendPathDelim">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="AppendPathDelim.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="AppendPathDelim.Path">
<short/>
</element>
<!-- function Visibility: default -->
<element name="ChompPathDelim">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="ChompPathDelim.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="ChompPathDelim.Path">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileExistsUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileExistsUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileExistsUTF8.Filename">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileAgeUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileAgeUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileAgeUTF8.FileName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="DirectoryExistsUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="DirectoryExistsUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="DirectoryExistsUTF8.Directory">
<short/>
</element>
<!-- function Visibility: default -->
<element name="ExpandFileNameUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="ExpandFileNameUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="ExpandFileNameUTF8.FileName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FindFirstUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FindFirstUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FindFirstUTF8.Path">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FindFirstUTF8.Attr">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FindFirstUTF8.Rslt">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FindNextUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FindNextUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FindNextUTF8.Rslt">
<short/>
</element>
<!-- procedure Visibility: default -->
<element name="FindCloseUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- argument Visibility: default -->
<element name="FindCloseUTF8.F">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileSetDateUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileSetDateUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileSetDateUTF8.FileName">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileSetDateUTF8.Age">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileGetAttrUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileGetAttrUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileGetAttrUTF8.FileName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileSetAttrUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileSetAttrUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileSetAttrUTF8.Filename">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileSetAttrUTF8.Attr">
<short/>
</element>
<!-- function Visibility: default -->
<element name="DeleteFileUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="DeleteFileUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="DeleteFileUTF8.FileName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="RenameFileUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="RenameFileUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="RenameFileUTF8.OldName">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="RenameFileUTF8.NewName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileSearchUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileSearchUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileSearchUTF8.Name">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileSearchUTF8.DirList">
<short/>
</element>
<!-- function Visibility: default -->
<element name="FileIsReadOnlyUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="FileIsReadOnlyUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="FileIsReadOnlyUTF8.FileName">
<short/>
</element>
<!-- function Visibility: default -->
<element name="GetCurrentDirUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="GetCurrentDirUTF8.Result">
<short/>
</element>
<!-- function Visibility: default -->
<element name="SetCurrentDirUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="SetCurrentDirUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="SetCurrentDirUTF8.NewDir">
<short/>
</element>
<!-- function Visibility: default -->
<element name="CreateDirUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="CreateDirUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="CreateDirUTF8.NewDir">
<short/>
</element>
<!-- function Visibility: default -->
<element name="RemoveDirUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="RemoveDirUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="RemoveDirUTF8.Dir">
<short/>
</element>
<!-- function Visibility: default -->
<element name="ForceDirectoriesUTF8">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- function result Visibility: default -->
<element name="ForceDirectoriesUTF8.Result">
<short/>
</element>
<!-- argument Visibility: default -->
<element name="ForceDirectoriesUTF8.Dir">
<short/>
</element>
<!-- procedure type Visibility: default -->
<element name="TInvalidateFileStateCacheEvent">
<short/>
<descr>
</descr>
<seealso>
</seealso>
</element>
<!-- argument Visibility: default -->
<element name="TInvalidateFileStateCacheEvent.Filename">
<short/>
</element>
<!-- variable Visibility: default -->
<element name="OnInvalidateFileStateCache">
<short/>
<descr>
</descr>
<seealso>
</seealso>
</element>
<!-- procedure Visibility: default -->
<element name="InvalidateFileStateCache">
<short/>
<descr>
</descr>
<errors>
</errors>
<seealso>
</seealso>
</element>
<!-- argument Visibility: default -->
<element name="InvalidateFileStateCache.Filename">
<short/>
</element>
<element name="SplitCmdLineParams"><short>Splits parameters separated by one or more spaces.</short><descr>Parameters are separated by one or more spaces (#9,#10,#13,#32).
Quotes are parsed as single parameter.
if ReadBackslash=true then \" is replaced to " and not treated as quote.
#0 is always end.
</descr>
</element>
<element name="ReadAllLinks"><short>Resolves a symlink to the real file. It does not resolve symlinks in parent directories.</short><descr>If a symlink can not be resolved the function returns the empty string if ExceptionOnError is false. If ExceptionOnError is true it raises an EFOpenError with a message, containing more details.
On Windows it simply returns Filename.</descr>
</element><element name="GetUnixPhysicalFilename"><short>Resolves all symlinks in Filename, including all directories.</short><descr>If a symlink can not be resolved the function returns the empty string if ExceptionOnError is false. If ExceptionOnError is true it raises an EFOpenError with a message, containing more details.
</descr>
</element><element name="TryReadAllLinks"><short>Resolves a symlink to the real file. It does not resolve symlinks in parent directories.</short><descr>If a symlink can not be resolved it returns Filename.
It uses ReadAllLinks.</descr>
</element>
</module> <!-- LazFileUtils -->
</package>
</fpdoc-descriptions>