Macro

CFCopyLocalizedStringWithDefaultValue

Returns a localized version of a localization string.

Declaration

#define CFCopyLocalizedStringWithDefaultValue(key, tbl, bundle, value, comment)

Parameters

key

The development language version of the string. This string is used as the search key to locate the localized version of the string.

tableName

The name of the strings file to search. The name should not include the strings filename extension.

bundle

The bundle to examine.

value

The default value for the requested localization string.

comment

A comment to provide the translators with contextual information necessary for proper translation.

Return Value

The localized version of the requested string. If no value corresponding to key is found, returns value, unless value is NULL or an empty string, in which case key is returned instead. Ownership follows the The Create Rule.

Discussion

This is a macro variant of CFBundleCopyLocalizedString for use with the genstrings tool.

See Also

Managing Localizations

CFBundleCopyBundleLocalizations

Returns an array containing a bundle’s localizations.

CFBundleCopyLocalizedString

Returns a localized string from a bundle’s strings file.

CFBundleCopyLocalizationsForPreferences

Given an array of possible localizations and preferred locations, returns the one or more of them that CFBundle would use, without reference to the current application context.

CFBundleCopyLocalizationsForURL

Returns an array containing the localizations for a bundle or executable at a particular location.

CFBundleCopyPreferredLocalizationsFromArray

Given an array of possible localizations, returns the one or more of them that CFBundle would use in the current application context.

CFCopyLocalizedString

Searches the default strings file Localizable.strings for the string associated with the specified key.

CFCopyLocalizedStringFromTable

Searches the specified strings file for the string associated with the specified key.

CFCopyLocalizedStringFromTableInBundle

Returns a localized version of the specified string.