Skip to main content

TrFile_GetFileName (function reference)

By August 1, 2022August 18th, 2022Online Help, Troi File Plug-in
Troi File Plug-in > Functions reference > TrFile_GetFileName
Troi File Plug-in for FileMaker Pro

TrFile_GetFileName

Returns the name of a file (or folder) in the filePath, including the extension

SyntaxFunction badge

TrFile_GetFileName ( switches ; filePath )

Parameters

switches not used, reserved for future use. Leave blank or put "-Unused"
filePath the path to the file of which you want the name

Returned Result

Data type returned

Text

Result

the name of the file (or folder) in the filePath

Originated in

Troi File Plug-in 14.0

Compatibility

FileMaker Pro 16 to 19

Considerations

You can use this function to easily get the (file)name part in a filePath string. The result will include the extension, if present.

You can use FileMaker styled paths (which uses forward slash as separator). On Windows you can also use Windows style paths (which use backslash as separator) and on macOS you can use paths which use colon as separator.

NOTE The plug-in does not test if the path is correct or if the file (or folder) exists.

Example

TrFile_GetFileName ( "" ;  "C:\Test.txt" ) ]

This will return the extension “Test.txt”.

TrFile_GetFileName ( "" ; "MacHD:data.kip:my filename" ) ]

This will return “my filename”.

TrFile_GetFileName ( "" ; "filemac:/MacHD/trident/submar/filename.log" ) ]

This will return “filename.log”.

TrFile_GetFileName ( "" ; "/C:/trident/subdir/directory1/" ) ]

This will return the name of a directory, “directory1”.

Example 2

Set Variable [ $FileName ; 
                         TrFile_GetFileName ( "" ; "filemac:/Mac HD/Users/Smith/Report.fmp12" ) ]

This will set the variable $FileName to “Report.fmp12”.

Used in example file

Attribute.fmp12

Related functionsFunction badge

TrFile_Exists
TrFile_GetExtension
TrFile_GetTypeOfItem

Related topics

Troi File Plug-in online help (overview)


Online Help Page for Troi File Plug-in for 16 to 19 –> TrFile_GetFileName (filep4329) 2022-0818 16:48:46