ObjFW
|
A class for querying the locale and retrieving localized strings. More...
#import <ObjFW/OFLocale.h>
Instance Methods | |
(instancetype) | - init |
Initializes the current OFLocale. More... | |
(void) | - addLanguageDirectory: |
Adds a directory to scan for language files. More... | |
(OFString *) | - localizedStringForID:fallback: |
Returns the localized string for the specified ID, using the fallback string if it cannot be looked up or is missing. More... | |
(OFString *) | - localizedStringForID:fallback:arguments: |
Returns the localized string for the specified ID, using the fallback string if it cannot be looked up or is missing. More... | |
![]() | |
(nullable OFMethodSignature *) | - methodSignatureForSelector: |
Returns the method signature for the specified selector. More... | |
(void) | - dealloc |
Deallocates the object. More... | |
(void) | - performSelector:afterDelay: |
Performs the specified selector after the specified delay. More... | |
(void) | - performSelector:withObject:afterDelay: |
Performs the specified selector with the specified object after the specified delay. More... | |
(void) | - performSelector:withObject:withObject:afterDelay: |
Performs the specified selector with the specified objects after the specified delay. More... | |
(void) | - performSelector:withObject:withObject:withObject:afterDelay: |
Performs the specified selector with the specified objects after the specified delay. More... | |
(void) | - performSelector:withObject:withObject:withObject:withObject:afterDelay: |
Performs the specified selector with the specified objects after the specified delay. More... | |
(void) | - performSelector:onThread:waitUntilDone: |
Performs the specified selector on the specified thread. More... | |
(void) | - performSelector:onThread:withObject:waitUntilDone: |
Performs the specified selector on the specified thread with the specified object. More... | |
(void) | - performSelector:onThread:withObject:withObject:waitUntilDone: |
Performs the specified selector on the specified thread with the specified objects. More... | |
(void) | - performSelector:onThread:withObject:withObject:withObject:waitUntilDone: |
Performs the specified selector on the specified thread with the specified objects. More... | |
(void) | - performSelector:onThread:withObject:withObject:withObject:withObject:waitUntilDone: |
Performs the specified selector on the specified thread with the specified objects. More... | |
(void) | - performSelectorOnMainThread:waitUntilDone: |
Performs the specified selector on the main thread. More... | |
(void) | - performSelectorOnMainThread:withObject:waitUntilDone: |
Performs the specified selector on the main thread with the specified object. More... | |
(void) | - performSelectorOnMainThread:withObject:withObject:waitUntilDone: |
Performs the specified selector on the main thread with the specified objects. More... | |
(void) | - performSelectorOnMainThread:withObject:withObject:withObject:waitUntilDone: |
Performs the specified selector on the main thread with the specified objects. More... | |
(void) | - performSelectorOnMainThread:withObject:withObject:withObject:withObject:waitUntilDone: |
Performs the specified selector on the main thread with the specified objects. More... | |
(void) | - performSelector:onThread:afterDelay: |
Performs the specified selector on the specified thread after the specified delay. More... | |
(void) | - performSelector:onThread:withObject:afterDelay: |
Performs the specified selector on the specified thread with the specified object after the specified delay. More... | |
(void) | - performSelector:onThread:withObject:withObject:afterDelay: |
Performs the specified selector on the specified thread with the specified objects after the specified delay. More... | |
(void) | - performSelector:onThread:withObject:withObject:withObject:afterDelay: |
Performs the specified selector on the specified thread with the specified objects after the specified delay. More... | |
(void) | - performSelector:onThread:withObject:withObject:withObject:withObject:afterDelay: |
Performs the specified selector on the specified thread with the specified objects after the specified delay. More... | |
(nullable id) | - forwardingTargetForSelector: |
This method is called when resolveClassMethod: or resolveInstanceMethod: returned false. It should return a target to which the message should be forwarded. More... | |
(void) | - doesNotRecognizeSelector: |
Handles messages which are not understood by the receiver. More... | |
![]() | |
(unsigned long) | - hash |
Returns a 32 bit hash for the object. More... | |
(unsigned int) | - retainCount |
Returns the retain count. More... | |
(bool) | - isProxy |
Returns whether the object is a proxy object. More... | |
(bool) | - allowsWeakReference |
Returns whether the object allows weak references. More... | |
(bool) | - isKindOfClass: |
Returns a boolean whether the object of the specified kind. More... | |
(bool) | - isMemberOfClass: |
Returns a boolean whether the object is a member of the specified class. More... | |
(bool) | - respondsToSelector: |
Returns a boolean whether the object responds to the specified selector. More... | |
(nullable IMP) | - methodForSelector: |
Returns the implementation for the specified selector. More... | |
(nullable id) | - performSelector: |
Performs the specified selector. More... | |
(nullable id) | - performSelector:withObject: |
Performs the specified selector with the specified object. More... | |
(nullable id) | - performSelector:withObject:withObject: |
Performs the specified selector with the specified objects. More... | |
(nullable id) | - performSelector:withObject:withObject:withObject: |
Performs the specified selector with the specified objects. More... | |
(nullable id) | - performSelector:withObject:withObject:withObject:withObject: |
Performs the specified selector with the specified objects. More... | |
(bool) | - isEqual: |
Checks two objects for equality. More... | |
(instancetype) | - retain |
Increases the retain count. More... | |
(void) | - release |
Decreases the retain count. More... | |
(instancetype) | - autorelease |
Adds the object to the topmost autorelease pool of the thread's autorelease pool stack. More... | |
(instancetype) | - self |
Returns the receiver. More... | |
(bool) | - retainWeakReference |
Retain a weak reference to this object. More... | |
Class Methods | |
(nullable OFLocale *) | + currentLocale |
Returns the current OFLocale. More... | |
(nullable OFString *) | + language |
Returns the language of the locale. More... | |
(nullable OFString *) | + territory |
Returns the territory of the locale. More... | |
(of_string_encoding_t) | + encoding |
Returns the native 8-bit string encoding for the locale. More... | |
(nullable OFString *) | + decimalPoint |
Returns the decimal point of the system's locale. More... | |
(void) | + addLanguageDirectory: |
Adds a directory to scan for language files. More... | |
![]() | |
(void) | + load |
A method which is called once when the class is loaded into the runtime. More... | |
(void) | + unload |
A method which is called when the class is unloaded from the runtime. More... | |
(void) | + initialize |
A method which is called the moment before the first call to the class is being made. More... | |
(instancetype) | + alloc |
Allocates memory for an instance of the class and sets up the memory pool for the object. More... | |
(instancetype) | + new |
Calls alloc on self and then init on the returned object. More... | |
(Class) | + class |
Returns the class. More... | |
(OFString *) | + className |
Returns the name of the class as a string. More... | |
(bool) | + isSubclassOfClass: |
Returns a boolean whether the class is a subclass of the specified class. More... | |
(nullable Class) | + superclass |
Returns the superclass of the class. More... | |
(bool) | + instancesRespondToSelector: |
Checks whether instances of the class respond to a given selector. More... | |
(bool) | + conformsToProtocol: |
Checks whether the class conforms to a given protocol. More... | |
(nullable IMP) | + instanceMethodForSelector: |
Returns the implementation of the instance method for the specified selector. More... | |
(nullable OFMethodSignature *) | + instanceMethodSignatureForSelector: |
Returns the method signature of the instance method for the specified selector. More... | |
(OFString *) | + description |
Returns a description for the class, which is usually the class name. More... | |
(nullable IMP) | + replaceClassMethod:withMethodFromClass: |
Replaces a class method with a class method from another class. More... | |
(nullable IMP) | + replaceInstanceMethod:withMethodFromClass: |
Replaces an instance method with an instance method from another class. More... | |
(void) | + inheritMethodsFromClass: |
Adds all methods from the specified class to the class that is the receiver. More... | |
(bool) | + resolveClassMethod: |
Try to resolve the specified class method. More... | |
(bool) | + resolveInstanceMethod: |
Try to resolve the specified instance method. More... | |
(id) | + copy |
Returns the class. More... | |
Properties | |
OFString * | language |
The language of the locale for messages. More... | |
OFString * | territory |
The territory of the locale for messages. More... | |
of_string_encoding_t | encoding |
The native 8-bit string encoding of the locale for messages. More... | |
OFString * | decimalPoint |
The decimal point of the system's locale. | |
![]() | |
OFString * | className |
The name of the object's class. | |
OFString * | description |
A description for the object. More... | |
OFString * | stringBySerializing |
The object serialized as a string. | |
A class for querying the locale and retrieving localized strings.
+ (void) addLanguageDirectory: | (OFString *) | path |
Adds a directory to scan for language files.
path | The path to the directory to scan for language files |
- (void) addLanguageDirectory: | (OFString *) | path |
Adds a directory to scan for language files.
path | The path to the directory to scan for language files |
+ (OFLocale *) currentLocale |
Returns the current OFLocale.
nil
! In this case, you need to manually allocate an instance and call init once.+ (nullable OFString *) decimalPoint |
Returns the decimal point of the system's locale.
+ (of_string_encoding_t) encoding |
Returns the native 8-bit string encoding for the locale.
This is useful to encode strings correctly for passing them to operating system calls.
If the native 8-bit encoding is unknown, UTF-8 is assumed.
- (instancetype) init |
Initializes the current OFLocale.
setlocale()
!Reimplemented from OFObject.
+ (nullable OFString *) language |
Returns the language of the locale.
If the language is unknown, nil
is returned.
- (OFString *) localizedStringForID: | (OFConstantString *) | ID | |
fallback: | (id) | fallback | |
, | ... | ||
Returns the localized string for the specified ID, using the fallback string if it cannot be looked up or is missing.
nil
, that consists of pairs of variable names and variable values, which will be replaced inside the localized string. For example, you can pass @"name", @"foo", nil
, causing %[name]
to be replaced with foo
in the localized string.nil
sentinel automatically.ID | The ID for the localized string |
fallback | The fallback to use in case the localized string cannot be looked up or is missing. This can also be an array and use plural scripting, just like with the JSON language files. |
- (OFString *) localizedStringForID: | (OFConstantString *) | ID | |
fallback: | (id) | fallback | |
arguments: | (va_list) | arguments | |
Returns the localized string for the specified ID, using the fallback string if it cannot be looked up or is missing.
nil
and passed as va_list, that consists of pairs of variable names and variable values, which will be replaced inside the localized string. For example, you can pass @"name", @"foo", nil
, causing %[name]
to be replaced with foo
in the localized string.nil
sentinel automatically.ID | The ID for the localized string |
fallback | The fallback to use in case the localized string cannot be looked up or is missing. This can also be an array and use plural scripting, just like with the JSON language files. |
arguments | A va_list of arguments, consisting of pairs of variable names and values to replace in the localized string, terminated with nil |
+ (nullable OFString *) territory |
Returns the territory of the locale.
If the territory is unknown, nil
is returned.
|
readnonatomicassign |
The native 8-bit string encoding of the locale for messages.
This is useful to encode strings correctly for passing them to operating system calls.
If the native 8-bit encoding is unknown, UTF-8 is assumed.
|
readwriteatomic |
The language of the locale for messages.
If the language is unknown, it is nil
.
|
readwriteatomic |
The territory of the locale for messages.
If the territory is unknown, it is nil
.