/*
*******************************************************************************
-* Copyright (C) 1997-2003, International Business Machines Corporation and *
-* others. All Rights Reserved. *
+* Copyright (C) 1997-2013, International Business Machines Corporation and
+* others. All Rights Reserved.
*******************************************************************************
*
* File DCFMTSYM.CPP
* 03/18/97 clhuang Implemented with C++ APIs.
* 03/27/97 helena Updated to pass the simple test after code review.
* 08/26/97 aliu Added currency/intl currency symbol support.
-* 07/20/98 stephen Slightly modified initialization of monetarySeparator
+* 07/20/98 stephen Slightly modified initialization of monetarySeparator
********************************************************************************
*/
-
+
#include "unicode/utypes.h"
#if !UCONFIG_NO_FORMATTING
#include "unicode/dcfmtsym.h"
-#include "unicode/resbund.h"
+#include "unicode/ures.h"
#include "unicode/decimfmt.h"
#include "unicode/ucurr.h"
#include "unicode/choicfmt.h"
+#include "unicode/unistr.h"
+#include "unicode/numsys.h"
+#include "unicode/unum.h"
+#include "unicode/utf16.h"
+#include "ucurrimp.h"
+#include "cstring.h"
+#include "locbased.h"
+#include "uresimp.h"
+#include "ureslocs.h"
// *****************************************************************************
// class DecimalFormatSymbols
// *****************************************************************************
-
+
U_NAMESPACE_BEGIN
-const char DecimalFormatSymbols::fgClassID=0;
+UOBJECT_DEFINE_RTTI_IMPLEMENTATION(DecimalFormatSymbols)
+
+static const char gNumberElements[] = "NumberElements";
+static const char gCurrencySpacingTag[] = "currencySpacing";
+static const char gBeforeCurrencyTag[] = "beforeCurrency";
+static const char gAfterCurrencyTag[] = "afterCurrency";
+static const char gCurrencyMatchTag[] = "currencyMatch";
+static const char gCurrencySudMatchTag[] = "surroundingMatch";
+static const char gCurrencyInsertBtnTag[] = "insertBetween";
-const char DecimalFormatSymbols::fgNumberElements[] = "NumberElements";
static const UChar INTL_CURRENCY_SYMBOL_STR[] = {0xa4, 0xa4, 0};
// -------------------------------------
// Initializes this with the decimal format symbols in the default locale.
-
+
DecimalFormatSymbols::DecimalFormatSymbols(UErrorCode& status)
- : UObject()
+ : UObject(),
+ locale()
{
- initialize(Locale::getDefault(), status, TRUE);
+ initialize(locale, status, TRUE);
}
-
+
// -------------------------------------
// Initializes this with the decimal format symbols in the desired locale.
-
+
DecimalFormatSymbols::DecimalFormatSymbols(const Locale& loc, UErrorCode& status)
- : UObject()
+ : UObject(),
+ locale(loc)
{
- initialize(loc, status);
+ initialize(locale, status);
+}
+
+DecimalFormatSymbols::DecimalFormatSymbols()
+ : UObject(),
+ locale(Locale::getRoot()),
+ currPattern(NULL) {
+ *validLocale = *actualLocale = 0;
+ initialize();
}
-
+
+DecimalFormatSymbols*
+DecimalFormatSymbols::createWithLastResortData(UErrorCode& status) {
+ if (U_FAILURE(status)) { return NULL; }
+ DecimalFormatSymbols* sym = new DecimalFormatSymbols();
+ if (sym == NULL) {
+ status = U_MEMORY_ALLOCATION_ERROR;
+ }
+ return sym;
+}
+
// -------------------------------------
DecimalFormatSymbols::~DecimalFormatSymbols()
DecimalFormatSymbols::DecimalFormatSymbols(const DecimalFormatSymbols &source)
: UObject(source)
{
- int i;
- for(i = 0; i < (int)kFormatSymbolCount; ++i) {
- // fastCopyFrom is safe, see docs on fSymbols
- fSymbols[(ENumberFormatSymbol)i].fastCopyFrom(source.fSymbols[(ENumberFormatSymbol)i]);
- }
+ *this = source;
}
// -------------------------------------
DecimalFormatSymbols&
DecimalFormatSymbols::operator=(const DecimalFormatSymbols& rhs)
{
- if (this != &rhs)
- {
- int i;
- for(i = 0; i < (int)kFormatSymbolCount; ++i) {
+ if (this != &rhs) {
+ for(int32_t i = 0; i < (int32_t)kFormatSymbolCount; ++i) {
// fastCopyFrom is safe, see docs on fSymbols
fSymbols[(ENumberFormatSymbol)i].fastCopyFrom(rhs.fSymbols[(ENumberFormatSymbol)i]);
}
+ for(int32_t i = 0; i < (int32_t)UNUM_CURRENCY_SPACING_COUNT; ++i) {
+ currencySpcBeforeSym[i].fastCopyFrom(rhs.currencySpcBeforeSym[i]);
+ currencySpcAfterSym[i].fastCopyFrom(rhs.currencySpcAfterSym[i]);
+ }
+ locale = rhs.locale;
+ uprv_strcpy(validLocale, rhs.validLocale);
+ uprv_strcpy(actualLocale, rhs.actualLocale);
}
return *this;
}
if (this == &that) {
return TRUE;
}
-
- int i;
- for(i = 0; i < (int)kFormatSymbolCount; ++i) {
+ for(int32_t i = 0; i < (int32_t)kFormatSymbolCount; ++i) {
if(fSymbols[(ENumberFormatSymbol)i] != that.fSymbols[(ENumberFormatSymbol)i]) {
return FALSE;
}
}
- return TRUE;
+ for(int32_t i = 0; i < (int32_t)UNUM_CURRENCY_SPACING_COUNT; ++i) {
+ if(currencySpcBeforeSym[i] != that.currencySpcBeforeSym[i]) {
+ return FALSE;
+ }
+ if(currencySpcAfterSym[i] != that.currencySpcAfterSym[i]) {
+ return FALSE;
+ }
+ }
+ return locale == that.locale &&
+ uprv_strcmp(validLocale, that.validLocale) == 0 &&
+ uprv_strcmp(actualLocale, that.actualLocale) == 0;
}
-
+
// -------------------------------------
-
+
void
-DecimalFormatSymbols::initialize(const Locale& loc, UErrorCode& status,
- UBool useLastResortData)
+DecimalFormatSymbols::initialize(const Locale& loc, UErrorCode& status, UBool useLastResortData)
{
- if (U_FAILURE(status)) return;
+ static const char *gNumberElementKeys[kFormatSymbolCount] = {
+ "decimal",
+ "group",
+ "list",
+ "percentSign",
+ NULL, /* Native zero digit is deprecated from CLDR - get it from the numbering system */
+ NULL, /* Pattern digit character is deprecated from CLDR - use # by default always */
+ "minusSign",
+ "plusSign",
+ NULL, /* currency symbol - We don't really try to load this directly from CLDR until we know the currency */
+ NULL, /* intl currency symbol - We don't really try to load this directly from CLDR until we know the currency */
+ "currencyDecimal",
+ "exponential",
+ "perMille",
+ NULL, /* Escape padding character - not in CLDR */
+ "infinity",
+ "nan",
+ NULL, /* Significant digit symbol - not in CLDR */
+ "currencyGroup",
+ NULL, /* one digit - get it from the numbering system */
+ NULL, /* two digit - get it from the numbering system */
+ NULL, /* three digit - get it from the numbering system */
+ NULL, /* four digit - get it from the numbering system */
+ NULL, /* five digit - get it from the numbering system */
+ NULL, /* six digit - get it from the numbering system */
+ NULL, /* seven digit - get it from the numbering system */
+ NULL, /* eight digit - get it from the numbering system */
+ NULL, /* nine digit - get it from the numbering system */
+ };
+
+ static const char *gLatn = "latn";
+ static const char *gSymbols = "symbols";
+ const char *nsName;
+ const UChar *sym = NULL;
+ int32_t len = 0;
+
+ *validLocale = *actualLocale = 0;
+ currPattern = NULL;
+ if (U_FAILURE(status))
+ return;
- this->locale = loc;
+ const char* locStr = loc.getName();
+ LocalUResourceBundlePointer resource(ures_open(NULL, locStr, &status));
+ LocalUResourceBundlePointer numberElementsRes(
+ ures_getByKeyWithFallback(resource.getAlias(), gNumberElements, NULL, &status));
- ResourceBundle resource((char *)0, loc, status);
- if (U_FAILURE(status))
- {
- // Initializes with last resort data if necessary.
- if (useLastResortData)
- {
- status = U_USING_FALLBACK_WARNING;
+ if (U_FAILURE(status)) {
+ if ( useLastResortData ) {
+ status = U_USING_DEFAULT_WARNING;
initialize();
}
return;
}
- // Gets the number element array.
- int32_t i = 0;
- ResourceBundle numberElementsRes = resource.get(fgNumberElements, status);
- int32_t numberElementsLength = numberElementsRes.getSize();
-
- // If the array size is too small, something is wrong with the resource
- // bundle, returns the failure error code.
- if (numberElementsLength < 11) {
- status = U_INVALID_FORMAT_ERROR;
- return;
+ // First initialize all the symbols to the fallbacks for anything we can't find
+ initialize();
+
+ //
+ // Next get the numbering system for this locale and set zero digit
+ // and the digit string based on the numbering system for the locale
+ //
+
+ LocalPointer<NumberingSystem> ns(NumberingSystem::createInstance(loc, status));
+ if (U_SUCCESS(status) && ns->getRadix() == 10 && !ns->isAlgorithmic()) {
+ nsName = ns->getName();
+ UnicodeString digitString(ns->getDescription());
+ int32_t digitIndex = 0;
+ UChar32 digit = digitString.char32At(0);
+ fSymbols[kZeroDigitSymbol].setTo(digit);
+ for (int32_t i = kOneDigitSymbol; i <= kNineDigitSymbol; ++i) {
+ digitIndex += U16_LENGTH(digit);
+ digit = digitString.char32At(digitIndex);
+ fSymbols[i].setTo(digit);
+ }
+ } else {
+ nsName = gLatn;
}
- UnicodeString numberElements[kFormatSymbolCount];
- for(i = 0; i<numberElementsLength; i++) {
- numberElements[i].fastCopyFrom(numberElementsRes.getStringEx(i, status));
+ UBool isLatn = !uprv_strcmp(nsName,gLatn);
+
+ UErrorCode nlStatus = U_ZERO_ERROR;
+ LocalUResourceBundlePointer nonLatnSymbols;
+ if ( !isLatn ) {
+ nonLatnSymbols.adoptInstead(
+ ures_getByKeyWithFallback(numberElementsRes.getAlias(), nsName, NULL, &nlStatus));
+ ures_getByKeyWithFallback(nonLatnSymbols.getAlias(), gSymbols, nonLatnSymbols.getAlias(), &nlStatus);
}
- if (U_FAILURE(status)) {
- return;
+ LocalUResourceBundlePointer latnSymbols(
+ ures_getByKeyWithFallback(numberElementsRes.getAlias(), gLatn, NULL, &status));
+ ures_getByKeyWithFallback(latnSymbols.getAlias(), gSymbols, latnSymbols.getAlias(), &status);
+
+ UBool kMonetaryDecimalSet = FALSE;
+ UBool kMonetaryGroupingSet = FALSE;
+ for(int32_t i = 0; i<kFormatSymbolCount; i++) {
+ if ( gNumberElementKeys[i] != NULL ) {
+ UErrorCode localStatus = U_ZERO_ERROR;
+ if ( !isLatn ) {
+ sym = ures_getStringByKeyWithFallback(nonLatnSymbols.getAlias(),
+ gNumberElementKeys[i], &len, &localStatus);
+ // If we can't find the symbol in the numbering system specific resources,
+ // use the "latn" numbering system as the fallback.
+ if ( U_FAILURE(localStatus) ) {
+ localStatus = U_ZERO_ERROR;
+ sym = ures_getStringByKeyWithFallback(latnSymbols.getAlias(),
+ gNumberElementKeys[i], &len, &localStatus);
+ }
+ } else {
+ sym = ures_getStringByKeyWithFallback(latnSymbols.getAlias(),
+ gNumberElementKeys[i], &len, &localStatus);
+ }
+
+ if ( U_SUCCESS(localStatus) ) {
+ setSymbol((ENumberFormatSymbol)i, UnicodeString(TRUE, sym, len));
+ if ( i == kMonetarySeparatorSymbol ) {
+ kMonetaryDecimalSet = TRUE;
+ } else if ( i == kMonetaryGroupingSeparatorSymbol ) {
+ kMonetaryGroupingSet = TRUE;
+ }
+ }
+ }
}
- initialize(numberElements, numberElementsLength);
+ // If monetary decimal or grouping were not explicitly set, then set them to be the
+ // same as their non-monetary counterparts.
+ if ( !kMonetaryDecimalSet ) {
+ setSymbol(kMonetarySeparatorSymbol,fSymbols[kDecimalSeparatorSymbol]);
+ }
+ if ( !kMonetaryGroupingSet ) {
+ setSymbol(kMonetaryGroupingSeparatorSymbol,fSymbols[kGroupingSeparatorSymbol]);
+ }
// Obtain currency data from the currency API. This is strictly
// for backward compatibility; we don't use DecimalFormatSymbols
// for currency data anymore.
- UErrorCode ec = U_ZERO_ERROR; // don't propagate failures out
- const char* l = loc.getName();
- const UChar* curriso = ucurr_forLocale(l, &ec);
- UBool isChoiceFormat;
- int32_t len;
- const UChar* currname = ucurr_getName(curriso, l, UCURR_SYMBOL_NAME,
- &isChoiceFormat, &len, &ec);
- if (U_SUCCESS(ec)) {
- fSymbols[kIntlCurrencySymbol] = curriso;
-
- // If this is a ChoiceFormat currency, then format an
- // arbitrary value; pick something != 1; more common.
- fSymbols[kCurrencySymbol].truncate(0);
- if (isChoiceFormat) {
- ChoiceFormat f(currname, ec);
- if (U_SUCCESS(ec)) {
- f.format(2.0, fSymbols[kCurrencySymbol]);
- } else {
- fSymbols[kCurrencySymbol] = fSymbols[kIntlCurrencySymbol];
- }
- } else {
- fSymbols[kCurrencySymbol] = UnicodeString(currname);
- }
+ UErrorCode internalStatus = U_ZERO_ERROR; // don't propagate failures out
+ UChar curriso[4];
+ UnicodeString tempStr;
+ ucurr_forLocale(locStr, curriso, 4, &internalStatus);
+
+ uprv_getStaticCurrencyName(curriso, locStr, tempStr, internalStatus);
+ if (U_SUCCESS(internalStatus)) {
+ fSymbols[kIntlCurrencySymbol].setTo(curriso, -1);
+ fSymbols[kCurrencySymbol] = tempStr;
}
/* else use the default values. */
-}
-
-// Initializes the DecimalFormatSymbol instance with the data obtained
-// from ResourceBundle in the desired locale.
-void
-DecimalFormatSymbols::initialize(const UnicodeString* numberElements, int32_t numberElementsLength)
-{
- fSymbols[kDecimalSeparatorSymbol].fastCopyFrom(numberElements[0]);
- fSymbols[kGroupingSeparatorSymbol].fastCopyFrom(numberElements[1]);
- fSymbols[kPatternSeparatorSymbol].fastCopyFrom(numberElements[2]);
- fSymbols[kPercentSymbol].fastCopyFrom(numberElements[3]);
- fSymbols[kZeroDigitSymbol].fastCopyFrom(numberElements[4]);
- fSymbols[kDigitSymbol].fastCopyFrom(numberElements[5]);
- fSymbols[kMinusSignSymbol].fastCopyFrom(numberElements[6]);
- fSymbols[kPlusSignSymbol] = (UChar)0x002b; // '+' Hard coded for now; get from resource later
- fSymbols[kExponentialSymbol].fastCopyFrom(numberElements[7]);
- fSymbols[kPerMillSymbol].fastCopyFrom(numberElements[8]);
- fSymbols[kPadEscapeSymbol] = (UChar)0x002a; // '*' Hard coded for now; get from resource later
- fSymbols[kInfinitySymbol].fastCopyFrom(numberElements[9]);
- fSymbols[kNaNSymbol].fastCopyFrom(numberElements[10]);
-
- // If there is a currency decimal, use it.
- fSymbols[kMonetarySeparatorSymbol].fastCopyFrom(numberElements[numberElementsLength >= 12 ? 11 : 0]);
-
- // Default values until it's set later on.
- fSymbols[kCurrencySymbol] = (UChar)0xa4; // 'OX' currency symbol
- fSymbols[kIntlCurrencySymbol] = INTL_CURRENCY_SYMBOL_STR;
+ U_LOCALE_BASED(locBased, *this);
+ locBased.setLocaleIDs(ures_getLocaleByType(numberElementsRes.getAlias(),
+ ULOC_VALID_LOCALE, &status),
+ ures_getLocaleByType(numberElementsRes.getAlias(),
+ ULOC_ACTUAL_LOCALE, &status));
+
+ //load the currency data
+ UChar ucc[4]={0}; //Currency Codes are always 3 chars long
+ int32_t uccLen = 4;
+ const char* locName = loc.getName();
+ UErrorCode localStatus = U_ZERO_ERROR;
+ uccLen = ucurr_forLocale(locName, ucc, uccLen, &localStatus);
+
+ if(U_SUCCESS(localStatus) && uccLen > 0) {
+ char cc[4]={0};
+ u_UCharsToChars(ucc, cc, uccLen);
+ /* An explicit currency was requested */
+ LocalUResourceBundlePointer currencyResource(ures_open(U_ICUDATA_CURR, locStr, &localStatus));
+ LocalUResourceBundlePointer currency(
+ ures_getByKeyWithFallback(currencyResource.getAlias(), "Currencies", NULL, &localStatus));
+ ures_getByKeyWithFallback(currency.getAlias(), cc, currency.getAlias(), &localStatus);
+ if(U_SUCCESS(localStatus) && ures_getSize(currency.getAlias())>2) { // the length is 3 if more data is present
+ ures_getByIndex(currency.getAlias(), 2, currency.getAlias(), &localStatus);
+ int32_t currPatternLen = 0;
+ currPattern =
+ ures_getStringByIndex(currency.getAlias(), (int32_t)0, &currPatternLen, &localStatus);
+ UnicodeString decimalSep =
+ ures_getUnicodeStringByIndex(currency.getAlias(), (int32_t)1, &localStatus);
+ UnicodeString groupingSep =
+ ures_getUnicodeStringByIndex(currency.getAlias(), (int32_t)2, &localStatus);
+ if(U_SUCCESS(localStatus)){
+ fSymbols[kMonetaryGroupingSeparatorSymbol] = groupingSep;
+ fSymbols[kMonetarySeparatorSymbol] = decimalSep;
+ //pattern.setTo(TRUE, currPattern, currPatternLen);
+ status = localStatus;
+ }
+ }
+ /* else An explicit currency was requested and is unknown or locale data is malformed. */
+ /* ucurr_* API will get the correct value later on. */
+ }
+ // else ignore the error if no currency
+
+ // Currency Spacing.
+ localStatus = U_ZERO_ERROR;
+ LocalUResourceBundlePointer currencyResource(ures_open(U_ICUDATA_CURR, locStr, &localStatus));
+ LocalUResourceBundlePointer currencySpcRes(
+ ures_getByKeyWithFallback(currencyResource.getAlias(),
+ gCurrencySpacingTag, NULL, &localStatus));
+
+ if (localStatus == U_USING_FALLBACK_WARNING || U_SUCCESS(localStatus)) {
+ const char* keywords[UNUM_CURRENCY_SPACING_COUNT] = {
+ gCurrencyMatchTag, gCurrencySudMatchTag, gCurrencyInsertBtnTag
+ };
+ localStatus = U_ZERO_ERROR;
+ LocalUResourceBundlePointer dataRes(
+ ures_getByKeyWithFallback(currencySpcRes.getAlias(),
+ gBeforeCurrencyTag, NULL, &localStatus));
+ if (localStatus == U_USING_FALLBACK_WARNING || U_SUCCESS(localStatus)) {
+ localStatus = U_ZERO_ERROR;
+ for (int32_t i = 0; i < UNUM_CURRENCY_SPACING_COUNT; i++) {
+ currencySpcBeforeSym[i] =
+ ures_getUnicodeStringByKey(dataRes.getAlias(), keywords[i], &localStatus);
+ }
+ }
+ dataRes.adoptInstead(
+ ures_getByKeyWithFallback(currencySpcRes.getAlias(),
+ gAfterCurrencyTag, NULL, &localStatus));
+ if (localStatus == U_USING_FALLBACK_WARNING || U_SUCCESS(localStatus)) {
+ localStatus = U_ZERO_ERROR;
+ for (int32_t i = 0; i < UNUM_CURRENCY_SPACING_COUNT; i++) {
+ currencySpcAfterSym[i] =
+ ures_getUnicodeStringByKey(dataRes.getAlias(), keywords[i], &localStatus);
+ }
+ }
+ }
}
-// initialize with default values
void
DecimalFormatSymbols::initialize() {
/*
fSymbols[kPatternSeparatorSymbol] = (UChar)0x3b; // ';' pattern separator
fSymbols[kPercentSymbol] = (UChar)0x25; // '%' percent sign
fSymbols[kZeroDigitSymbol] = (UChar)0x30; // '0' native 0 digit
+ fSymbols[kOneDigitSymbol] = (UChar)0x31; // '1' native 1 digit
+ fSymbols[kTwoDigitSymbol] = (UChar)0x32; // '2' native 2 digit
+ fSymbols[kThreeDigitSymbol] = (UChar)0x33; // '3' native 3 digit
+ fSymbols[kFourDigitSymbol] = (UChar)0x34; // '4' native 4 digit
+ fSymbols[kFiveDigitSymbol] = (UChar)0x35; // '5' native 5 digit
+ fSymbols[kSixDigitSymbol] = (UChar)0x36; // '6' native 6 digit
+ fSymbols[kSevenDigitSymbol] = (UChar)0x37; // '7' native 7 digit
+ fSymbols[kEightDigitSymbol] = (UChar)0x38; // '8' native 8 digit
+ fSymbols[kNineDigitSymbol] = (UChar)0x39; // '9' native 9 digit
fSymbols[kDigitSymbol] = (UChar)0x23; // '#' pattern digit
- fSymbols[kMinusSignSymbol] = (UChar)0x2d; // '-' minus sign
fSymbols[kPlusSignSymbol] = (UChar)0x002b; // '+' plus sign
+ fSymbols[kMinusSignSymbol] = (UChar)0x2d; // '-' minus sign
fSymbols[kCurrencySymbol] = (UChar)0xa4; // 'OX' currency symbol
- fSymbols[kIntlCurrencySymbol] = INTL_CURRENCY_SYMBOL_STR;
+ fSymbols[kIntlCurrencySymbol].setTo(TRUE, INTL_CURRENCY_SYMBOL_STR, 2);
fSymbols[kMonetarySeparatorSymbol] = (UChar)0x2e; // '.' monetary decimal separator
fSymbols[kExponentialSymbol] = (UChar)0x45; // 'E' exponential
fSymbols[kPerMillSymbol] = (UChar)0x2030; // '%o' per mill
fSymbols[kPadEscapeSymbol] = (UChar)0x2a; // '*' pad escape symbol
fSymbols[kInfinitySymbol] = (UChar)0x221e; // 'oo' infinite
fSymbols[kNaNSymbol] = (UChar)0xfffd; // SUB NaN
+ fSymbols[kSignificantDigitSymbol] = (UChar)0x0040; // '@' significant digit
+ fSymbols[kMonetaryGroupingSeparatorSymbol].remove(); //
+}
+
+Locale
+DecimalFormatSymbols::getLocale(ULocDataLocaleType type, UErrorCode& status) const {
+ U_LOCALE_BASED(locBased, *this);
+ return locBased.getLocale(type, status);
+}
+
+const UnicodeString&
+DecimalFormatSymbols::getPatternForCurrencySpacing(UCurrencySpacing type,
+ UBool beforeCurrency,
+ UErrorCode& status) const {
+ if (U_FAILURE(status)) {
+ return fNoSymbol; // always empty.
+ }
+ if (beforeCurrency) {
+ return currencySpcBeforeSym[(int32_t)type];
+ } else {
+ return currencySpcAfterSym[(int32_t)type];
+ }
}
+void
+DecimalFormatSymbols::setPatternForCurrencySpacing(UCurrencySpacing type,
+ UBool beforeCurrency,
+ const UnicodeString& pattern) {
+ if (beforeCurrency) {
+ currencySpcBeforeSym[(int32_t)type] = pattern;
+ } else {
+ currencySpcAfterSym[(int32_t)type] = pattern;
+ }
+}
U_NAMESPACE_END
#endif /* #if !UCONFIG_NO_FORMATTING */
projects / apple / icu.git / blobdiff