Macro

NSLocalizedStringFromTable

Returns a localized version of a string from the specified table.

Declaration

#define NSLocalizedStringFromTable(key, tbl, comment)

Parameters

key

The key for a string in the specified table.

tableName

The name of the table containing the key-value pairs. Also, the suffix for the strings file (a file with the .strings extension) to store the localized string.

comment

The comment to place above the key-value pair in the strings file.

Return Value

The result of invoking localizedStringForKey:value:table: on the main bundle, passing it the specified key and tableName.

Discussion

Use this macro to generate a specific strings files named [tableName].strings from your code using the genstrings utility. You can specify Unicode characters in key using \\Uxxxx—see the -u option for for the genstrings utility. The initial value for key in the strings file will be key. Use the NSLocalizedStringWithDefaultValue macro to specify another value for key.

As of OS X 10.11 and iOS 9, NSBundle is thread-safe. As such, NSLocalizedStringFromTable can safely be called from any execution context.

See Also

Localization

NSLocale

Information about linguistic, cultural, and technological conventions for use in formatting data for presentation.

NSOrthography

A description of the linguistic content of natural language text, typically used for spelling and grammar checking.

NSLocalizedString

Returns a localized version of a string.

NSLocalizedStringFromTableInBundle

Returns a localized version of a string from the specified table in the given bundle.

NSLocalizedStringWithDefaultValue

Returns a localized version of a string from the specified table in the given bundle while falling back on the given default value.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software