Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Files.GetTagNames

Queries names of the tags assigned to the file/folder.

Component Version macOS Windows Linux Server iOS SDK
Files 3.5 ✅ Yes ❌ No ❌ No ✅ Yes, on macOS ❌ No
MBS( "Files.GetTagNames"; Path )   More

Parameters

Parameter Description Example
Path The native path to the file. "/Users/cs/Desktop/test.txt"

Result

Returns list or error.

Description

Queries names of the tags assigned to the file/folder.
Requires macOS 10.9.
This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.
Please note that some tags may include chr(10) followed by a number to indicate which label color is used for compatibility to older OS X versions. Those appear escaped as \n in the result.
You can use Files.GetFinderLabel to read label number.

Examples

Queries tag names:

Set Variable [$r; Value:MBS( "Files.GetTagNames"; "/Users/cs/Desktop/todo.rtf")]

See also

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 9th November 2021


Files.GetPosixPermissions - Files.IdentifyData