Changeset 7893 in josm


Ignore:
Timestamp:
2014-12-26T15:05:04+01:00 (5 years ago)
Author:
Don-vip
Message:

code cleanup, fix various warnings, improve javadoc

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/org/openstreetmap/josm/tools/I18n.java

    r7578 r7893  
    3939    }
    4040
    41     private enum PluralMode { MODE_NOTONE, MODE_NONE, MODE_GREATERONE,
     41    private enum PluralMode {
     42        MODE_NOTONE, MODE_NONE, MODE_GREATERONE,
    4243        MODE_CS/*, MODE_AR*/, MODE_PL/*, MODE_RO*/, MODE_RU, MODE_SK/*, MODE_SL*/}
    4344    private static PluralMode pluralMode = PluralMode.MODE_NOTONE; /* english default */
     
    138139     * After translation, the localizations are distributed with the main program.
    139140     * <br>
    140      * For example, {@code tr("JOSM''s default value is ''{0}''.", val)}.
     141     * For example, <code>tr("JOSM''s default value is ''{0}''.", val)</code>.
    141142     * <br>
    142143     * Use {@link #trn} for distinguishing singular from plural text, i.e.,
     
    149150     * An apostrophe ' must be quoted by another apostrophe.
    150151     * @param objects the parameters for the string.
    151      * Mark occurrences in {@code text} with {@code {0}}, {@code {1}}, ...
     152     * Mark occurrences in {@code text} with <code>{0}</code>, <code>{1}</code>, ...
    152153     * @return the translated string.
    153154     * @see #trn
     
    192193     * the translatable strings from the source files).
    193194     *
    194      * For example, {@code
     195     * For example, <code>
    195196     * String[] options = new String[] {marktr("up"), marktr("down")};
    196      * lbl.setText(tr(options[0]));}
     197     * lbl.setText(tr(options[0]));</code>
    197198     * @param text the string to be marked for translation.
    198199     * @return {@code text} unmodified.
     
    211212     * <br>
    212213     * For instance, {@code trn("There was an error!", "There were errors!", i)} or
    213      * {@code trn("Found {0} error in {1}!", "Found {0} errors in {1}!", i, Integer.toString(i), url)}.
     214     * <code>trn("Found {0} error in {1}!", "Found {0} errors in {1}!", i, Integer.toString(i), url)</code>.
    214215     *
    215216     * @param singularText the singular text to translate.
     
    223224     * @param n a number to determine whether {@code singularText} or {@code pluralText} is used.
    224225     * @param objects the parameters for the string.
    225      * Mark occurrences in {@code singularText} and {@code pluralText} with {@code {0}}, {@code {1}}, ...
     226     * Mark occurrences in {@code singularText} and {@code pluralText} with <code>{0}</code>, <code>{1}</code>, ...
    226227     * @return the translated string.
    227228     * @see #tr
     
    250251     * @param n a number to determine whether {@code singularText} or {@code pluralText} is used.
    251252     * @param objects the parameters for the string.
    252      * Mark occurrences in {@code singularText} and {@code pluralText} with {@code {0}}, {@code {1}}, ...
     253     * Mark occurrences in {@code singularText} and {@code pluralText} with <code>{0}</code>, <code>{1}</code>, ...
    253254     * @return the translated string.
    254255     * @see #tr
     
    260261    }
    261262
    262     private static final String gettext(String text, String ctx, boolean lazy)
    263     {
     263    private static final String gettext(String text, String ctx, boolean lazy) {
    264264        int i;
    265         if(ctx == null && text.startsWith("_:") && (i = text.indexOf('\n')) >= 0)
    266         {
     265        if(ctx == null && text.startsWith("_:") && (i = text.indexOf('\n')) >= 0) {
    267266            ctx = text.substring(2,i-1);
    268267            text = text.substring(i+1);
    269268        }
    270         if(strings != null)
    271         {
     269        if(strings != null) {
    272270            String trans = strings.get(ctx == null ? text : "_:"+ctx+"\n"+text);
    273271            if(trans != null)
     
    287285    }
    288286
    289 
    290287    /* try without context, when context try fails */
    291288    private static final String gettext_lazy(String text, String ctx) {
     
    293290    }
    294291
    295     private static final String gettextn(String text, String plural, String ctx, long num)
    296     {
     292    private static final String gettextn(String text, String plural, String ctx, long num) {
    297293        int i;
    298         if(ctx == null && text.startsWith("_:") && (i = text.indexOf('\n')) >= 0)
    299         {
     294        if(ctx == null && text.startsWith("_:") && (i = text.indexOf('\n')) >= 0) {
    300295            ctx = text.substring(2,i-1);
    301296            text = text.substring(i+1);
    302297        }
    303         if(pstrings != null)
    304         {
     298        if(pstrings != null) {
    305299            i = pluralEval(num);
    306300            String[] trans = pstrings.get(ctx == null ? text : "_:"+ctx+"\n"+text);
     
    327321    public static final Locale[] getAvailableTranslations() {
    328322        Collection<Locale> v = new ArrayList<>(languages.size());
    329         if(getTranslationFile("en") != null)
    330         {
     323        if(getTranslationFile("en") != null) {
    331324            for (String loc : languages.keySet()) {
    332325                if(getTranslationFile(loc) != null) {
     
    347340    }
    348341
    349     public static boolean hasCode(String code)
    350     {
     342    /**
     343     * Determines if a language exists for the given code.
     344     * @param code The language code
     345     * @return {@code true} if a language exists, {@code false} otherwise
     346     */
     347    public static boolean hasCode(String code) {
    351348        return languages.containsKey(code);
    352349    }
    353350
    354     public static void init()
    355     {
     351    /**
     352     * I18n initialization.
     353     */
     354    public static void init() {
    356355        //languages.put("ar", PluralMode.MODE_AR);
    357356        languages.put("bg", PluralMode.MODE_NOTONE);
     
    499498           }
    500499         */
    501         try
    502         {
     500        try {
    503501            InputStream ens = new BufferedInputStream(en);
    504502            InputStream trs = new BufferedInputStream(tr);
     
    507505            boolean multimode = false;
    508506            byte[] str = new byte[4096];
    509             for(;;)
    510             {
    511                 if(multimode)
    512                 {
     507            for(;;) {
     508                if(multimode) {
    513509                    int ennum = ens.read();
    514510                    int trnum = trs.read();
     
    522518                    String[] enstrings = new String[ennum];
    523519                    String[] trstrings = new String[trnum];
    524                     for(int i = 0; i < ennum; ++i)
    525                     {
     520                    for(int i = 0; i < ennum; ++i) {
    526521                        int val = ens.read(enlen);
    527522                        if(val != 2) /* file corrupt */
     
    536531                        enstrings[i] = new String(str, 0, val, StandardCharsets.UTF_8);
    537532                    }
    538                     for(int i = 0; i < trnum; ++i)
    539                     {
     533                    for(int i = 0; i < trnum; ++i) {
    540534                        int val = trs.read(trlen);
    541535                        if(val != 2) /* file corrupt */
     
    553547                        p.put(enstrings[0], trstrings);
    554548                    }
    555                 }
    556                 else
    557                 {
     549                } else {
    558550                    int enval = ens.read(enlen);
    559551                    int trval = trs.read(trlen);
     
    569561                    if(trval == 0xFFFE) /* marks identical string, handle equally to non-translated */
    570562                        trval = 0;
    571                     if(enval == 0xFFFF)
    572                     {
     563                    if(enval == 0xFFFF) {
    573564                        multimode = true;
    574565                        if(trval != 0xFFFF) /* files do not match */
     
    596587                }
    597588            }
    598         }
    599         catch (IOException e) {
     589        } catch (IOException e) {
    600590            return false;
    601591        }
     
    655645    }
    656646
    657     private static int pluralEval(long n)
    658     {
    659         switch(pluralMode)
    660         {
     647    private static int pluralEval(long n) {
     648        switch(pluralMode) {
    661649        case MODE_NOTONE: /* bg, da, de, el, en, en_GB, es, et, eu, fi, gl, is, it, iw_IL, nb, nl, sv */
    662650            return ((n != 1) ? 1 : 0);
Note: See TracChangeset for help on using the changeset viewer.