Returns a localized string from a bundle’s strings file.
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Core Foundation
The bundle to examine.
The key for the localized string to retrieve. This key will be used to look up the localized string in the strings file. Typically the key is identical to the value of the localized string in the development language.
A default value to return if no value exists for
The name of the strings file to search. The name should not include the
stringsfilename extension. The case of the string must match that of the file name, even on file systems (such as HFS+) that are not case sensitive with regards to file names
A CFString object that contains the localized string. If no value exists for
NULL or an empty string, in which case
key is returned instead. Ownership follows the The Create Rule.
This is the base function from which the other localized string macros are derived. In general you should not use this function because the
genstrings development tool only recognizes the macro version of this call when generating strings files. See
CFCopy for details on how to use these macros.