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 macOS 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


MarkDown version: FilesGetTagNames.md