KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

ios-i18n

★ 200 Open GitHub ↗

The ios-i18n library provides seamless integration of plurals into iOS 6 apps.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Smartling.i18n.framework
iOS 6+ Plurals Localization Library

**Note: this library was designed to support plurals in iOS 6. As of iOS 7, Apple added support for plurals via string dictionaries. New projects should use Apple’s native plural support. This library has been deprecated.**

iOS (pre-iOS 7) localization did not support plural functionality out of the box. The **ios-i18n** library was designed to bridge that gap and provide a means for developers to seamlessly integrate plurals into their localized apps across any number of locales.

As of iOS 7 and Mac OS X 10.9 Mavericks, Foundation has the ability to specify localized strings according to pluralization and grammar rules. You can find more about this in the [Handling Noun Plurals and Units of Measurement](https://developer.apple.com/library/ios/documentation/MacOSX/Conceptual/BPInternational/LocalizingYourApp/LocalizingYourApp.html) section of the Internationalization and Localization Guide.

**ios-i18n** is not compatible with Apple's implementation, and does not handle new ".stringsdict" resource files.

## Installation
### Via CocoaPods
Update your `Podfile` with

pod 'Smartling.i18n', '~> 1.0'

### Framework bundle
1. Download [Smartling.i18n.framework.tar.gz] [fw]
2. Unpack and drag `Smartling.i18n.framework` to your project's `Frameworks` group.
3. In the `Build Settings` of your target add **-ObjC** to **Other Linker Flags**.
4. `#import <Smartling.i18n/SLLocalization.h>`

### Carthage
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

`Cartfile`

github "Smartling/ios-i18n"

## Usage

### Plurals

int number = 42;
    NSString *format = SLPluralizedString(@"%d apples", number, @"Comment");
    NSString *text = [NSString stringWithFormat:format, number];

#### SLPluralizedString...
There are four functions to retrieve pluralized string, similar to [NSLocalizedString]:

NSString * SLPluralizedString(NSString *key, number, NSString *comment)
    NSString * SLPluralizedStringFromTable(NSString *key,
        NSString *tableName,
        number,
        NSString *comment)
    NSString * SLPluralizedStringFromTableInBundle(NSString *key,
        NSString *tableName,
        NSBundle *bundle,
        number,
        NSString *comment)
    NSString * SLPluralizedStringWithDefaultValue(NSString *key,
        NSString *tableName,
        NSBundle *bundle,
        number,
        NSString *defaultValue,
        NSString *comment)

`number` can be any primitive type (int, long, float, double), or NSNumber.

### Notes

#### Base internationalization

When using Base internationalization, Localizable.strings files should be in language-specific folders (like en.lproj), not in Base.lproj folder.

#### Fallback

**ios-i18n** implements resource fallback for each key query. At runtime, SLPluralizedString retrieves string whose localization most closely matches the preferred language of the user.

In contrast, Apple's implementation of NSLocalizedString first selects appropriate localization table, then uses this table for all subsequent queries. For more details on this mechanism, see [Support for Internationalization] [applei18n]

### Extended .strings format

**ios-i18n** extends [standard .strings file format][stringsff] with pluralized variants.

The extended syntax for key is: `KEY##{rule}`.
Where `KEY` is the original key string, and `rule` is one of plural rules: `zero`, `one`, `two`, `few`, `many`, `other`.

The `rule` portion of the full key conforms to the [CLDR spec][CLDR] on plural forms. The **ios-i18n** library will load a particular translation following the same rules as defined under CLDR.

Sample resource files for key string `%d songs found`:

##### en.lproj/Localizable.strings

/* Number of songs from search results */
    "%d songs found##{one}" = "One song found";
    "%d songs found##{other}" = "%d songs found";

##### ru.lproj/Localizable.strings

/* Number of songs from search results */
    "%d songs found##{one}" = "Найдена %d песня";
    "%d songs found##{few}" = "Найдено %d песни";
    "%d songs found##{many}" = "Найдено %d песен";
    "%d songs found##{other}" = "Найдено %d песен";

## Copyright and license

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

[fw]: ../../raw/master/Frameworks/Smartling.i18n.framework.tar.gz
  [NSLocalizedString]: https://developer.apple.com/library/ios/#documentation/cocoa/reference/foundation/miscellaneous/foundation_functions/reference/reference.html
  [applei18n]: https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPInternational/Articles/InternatSupport.html
  [stringsff]: https://developer.apple.com/library/ios/#documentation/Cocoa/Conceptual/LoadingResources/Strings/Strings.html
  [CLDR]: http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html

ios-i18n

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README