/*
* Copyright (C) 2012 Google Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
#ifndef PlatformLocale_h
#define PlatformLocale_h
#include "platform/DateComponents.h"
#include "platform/Language.h"
#include "public/platform/WebLocalizedString.h"
#include "wtf/PassOwnPtr.h"
#include "wtf/text/WTFString.h"
namespace WebCore {
class PLATFORM_EXPORT Locale {
WTF_MAKE_NONCOPYABLE(Locale);
public:
static PassOwnPtr<Locale> create(const String& localeIdentifier);
static Locale& defaultLocale();
String queryString(blink::WebLocalizedString::Name);
String queryString(blink::WebLocalizedString::Name, const String& parameter);
String queryString(blink::WebLocalizedString::Name, const String& parameter1, const String& parameter2);
String validationMessageTooLongText(unsigned valueLength, int maxLength);
// Converts the specified number string to another number string localized
// for this Locale locale. The input string must conform to HTML
// floating-point numbers, and is not empty.
String convertToLocalizedNumber(const String&);
// Converts the specified localized number string to a number string in the
// HTML floating-point number format. The input string is provided by a end
// user, and might not be a number string. It's ok that the function returns
// a string which is not conforms to the HTML floating-point number format,
// callers of this function are responsible to check the format of the
// resultant string.
String convertFromLocalizedNumber(const String&);
#if ENABLE(INPUT_MULTIPLE_FIELDS_UI)
// Returns localized decimal separator, e.g. "." for English, "," for French.
String localizedDecimalSeparator();
#endif
// Returns date format in Unicode TR35 LDML[1] containing day of month,
// month, and year, e.g. "dd/mm/yyyy"
// [1] LDML http://unicode.org/reports/tr35/#Date_Format_Patterns
virtual String dateFormat() = 0;
// Returns a year-month format in Unicode TR35 LDML.
virtual String monthFormat() = 0;
// Returns a year-month format using short month lanel in Unicode TR35 LDML.
virtual String shortMonthFormat() = 0;
// Returns time format in Unicode TR35 LDML[1] containing hour, minute, and
// second with optional period(AM/PM), e.g. "h:mm:ss a"
// [1] LDML http://unicode.org/reports/tr35/#Date_Format_Patterns
virtual String timeFormat() = 0;
// Returns time format in Unicode TR35 LDML containing hour, and minute
// with optional period(AM/PM), e.g. "h:mm a"
// Note: Some platforms return same value as timeFormat().
virtual String shortTimeFormat() = 0;
// Returns a date-time format in Unicode TR35 LDML. It should have a seconds
// field.
virtual String dateTimeFormatWithSeconds() = 0;
// Returns a date-time format in Unicode TR35 LDML. It should have no seconds
// field.
virtual String dateTimeFormatWithoutSeconds() = 0;
// weekFormatInLDML() returns week and year format in LDML, Unicode
// technical standard 35, Locale Data Markup Language, e.g. "'Week' ww, yyyy"
String weekFormatInLDML();
// Returns a vector of string of which size is 12. The first item is a
// localized string of Jan and the last item is a localized string of
// Dec. These strings should be short.
virtual const Vector<String>& shortMonthLabels() = 0;
// Returns a vector of string of which size is 12. The first item is a
// stand-alone localized string of January and the last item is a
// stand-alone localized string of December. These strings should not be
// abbreviations.
virtual const Vector<String>& standAloneMonthLabels() = 0;
// Stand-alone month version of shortMonthLabels.
virtual const Vector<String>& shortStandAloneMonthLabels() = 0;
// Returns localized period field(AM/PM) strings.
virtual const Vector<String>& timeAMPMLabels() = 0;
// Returns a vector of string of which size is 12. The first item is a
// localized string of January, and the last item is a localized string of
// December. These strings should not be abbreviations.
virtual const Vector<String>& monthLabels() = 0;
// Returns a vector of string of which size is 7. The first item is a
// localized short string of Monday, and the last item is a localized
// short string of Saturday. These strings should be short.
virtual const Vector<String>& weekDayShortLabels() = 0;
// The first day of a week. 0 is Sunday, and 6 is Saturday.
virtual unsigned firstDayOfWeek() = 0;
// Returns true if people use right-to-left writing in the locale for this
// object.
virtual bool isRTL() = 0;
enum FormatType { FormatTypeUnspecified, FormatTypeShort, FormatTypeMedium };
// Serializes the specified date into a formatted date string to
// display to the user. If an implementation doesn't support
// localized dates the function should return an empty string.
// FormatType can be used to specify if you want the short format.
String formatDateTime(const DateComponents&, FormatType = FormatTypeUnspecified);
virtual ~Locale();
protected:
enum {
// 0-9 for digits.
DecimalSeparatorIndex = 10,
GroupSeparatorIndex = 11,
DecimalSymbolsSize
};
Locale() : m_hasLocaleData(false) { }
virtual void initializeLocaleData() = 0;
void setLocaleData(const Vector<String, DecimalSymbolsSize>&, const String& positivePrefix, const String& positiveSuffix, const String& negativePrefix, const String& negativeSuffix);
private:
bool detectSignAndGetDigitRange(const String& input, bool& isNegative, unsigned& startIndex, unsigned& endIndex);
unsigned matchedDecimalSymbolIndex(const String& input, unsigned& position);
String m_decimalSymbols[DecimalSymbolsSize];
String m_positivePrefix;
String m_positiveSuffix;
String m_negativePrefix;
String m_negativeSuffix;
bool m_hasLocaleData;
};
}
#endif