GoFiler Legato Script Reference   Legato v 1.5d Application v 5.25a

Table of Contents	< < Previous	Next >>

 

Chapter Six — File Functions (continued)

GetLongFilename Function

Overview

The GetLongFilename function retrieves the corrected long filename for a file.

Syntax/Parameters

Syntax

string = GetLongFilename ( string name );

Parameters

name

A string containing a qualified 8.3 filename and path.

Return Value

Returns a string containing the long filename (without path) or an empty string on failure. Use the GetLastError function to retrieve error information.

The return values will be UTF encoded for filenames with Unicode characters.

Remarks

Because Windows filenames are case-insensitive, the GetLongFilename function allows for retrieving the actual filename. It adjusts for proper case and formatting. This function runs on Windows and on the VFC only. To retrieve the corrected filename with the path attached, use the GetCorrectedFilename function.

Not all platforms support short filenames. If the platform does not support short names, or the supplied name is 8.2 compliant, the same name is returned as supplied. Use the “fsutil 8dot3name” in the command line to enable short file and path names.

The file must exist for the function to process the request.

Related Functions

GetCorrectedFilename — Gets a corrected long filename (i.e., converts an 8.3 style name to a Windows long name).

GetLongPathName — Returns a corrected long path name for a specified string (filename and path).

GetShortFilename — Returns an 8.3 short filename (no path) for specified string (filename and path).

GetShortPathName — Returns an 8.3 short path name for specified string (filename and path).

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic

 

Table of Contents	< < Previous	Next >>

GoFiler Legato Script Reference — Generated on 12/16/2024

© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.