I18n.java

/*
 * Copyright (C) 2010 yvolk (Yuri Volkov), http://yurivolkov.com
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License 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.
 */
package com.xorcode.andtweet.util;

import android.content.Context;
import android.util.Log;

import com.xorcode.andtweet.AndTweetService;

import java.text.MessageFormat;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * i18n - Internationalization utilities 
 */
public class I18n {
	private static final String TAG = I18n.class.getSimpleName();
    
	/**
	 * The function enables to have different localized message formats
	 *  (actually, any number of them)
	 *  for different quantities of something.
	 *  
	 * E.g. in Russian we need at least three different messages notifying User 
	 *  about the number of new tweets:
	 *  1 твит  (same for 21, 31, ...)
	 *  2 твита ( same for 3, 4, 22, ... )
	 *  5 твитов (same for 5, ... 11, 12, 20 ...)
	 *  ...
	 *  see /res/values-ru/arrays.xml (R.array.appwidget_tweet_patterns)
	 * 
	 * @author yvolk (Yuri Volkov), http://yurivolkov.com
	 */
	public static String formatQuantityMessage(Context context, int messageFormat,
			int quantityOfSomething, int array_patterns, int array_formats) {
		String submessage = "";
		String message = "";
		String toMatch = new Integer(quantityOfSomething).toString();
		String[] p = context.getResources().getStringArray(array_patterns);
		String[] f = context.getResources().getStringArray(array_formats);
		String subformat = "{0} ???";
		for (int i = 0; i < p.length; i++) {
			Pattern pattern = Pattern.compile(p[i]);
	        Matcher m = pattern.matcher(toMatch);
	        if (m.matches()) {
	        	subformat = f[i];
				break;
	        }
		}
		MessageFormat msf = new MessageFormat(subformat);
		submessage = msf.format(new Object[] { quantityOfSomething });
		
		if (messageFormat == 0) {
            message = submessage;
		} else {
	        MessageFormat mf = new MessageFormat(context.getText(messageFormat).toString());
	        message = mf.format(new Object[] { submessage });
		}

        if (Log.isLoggable(AndTweetService.APPTAG, Log.VERBOSE)) {
            Log.v(TAG, "formatMessage, num=" + toMatch + "; subformat=" + subformat 
    				+ "; submessage=" + submessage + "; message=" + message);
        }
		return message;
	}
}