Sign in Join
FPDoc Onlineexperiment

TFileStateCache.GetPhysicalFilenameCached function

Member of TFileStateCachepublicIn unit LazFileCache

Resolves the specified file name to a physical file on the local file system.

Declaration

pascal
function GetPhysicalFilenameCached(const AFileName: string; 
 EmptyOnError: Boolean): string

Description

The implementation is platform-specific. On the Windows platform, the value in AFileName is used as the return value. On UNIX-like platforms, which can have symbol links, the file name must be resolved to the physical file on the local file system. The cache is recursively searched to resolve a file name which resides on a symbolic link.

The return value contains the resolve path and file name, or an empty string if the file name cannot be resolved. When EmptyOnError is enabled, the value in the AFileName is returned - even when not resolved.

An experiment, built from Lazarus main 2dfa93c66e of 10-22-2026. Not the official Lazarus documentation.