dtptngen.h

Go to the documentation of this file.

/*
*******************************************************************************
* Copyright (C) 2007-2016, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*
* File DTPTNGEN.H
*
*******************************************************************************
*/
 
#ifndef __DTPTNGEN_H__
#define __DTPTNGEN_H__
 
#include "unicode/datefmt.h"
#include "unicode/locid.h"
#include "unicode/udat.h"
#include "unicode/udatpg.h"
 
U_NAMESPACE_BEGIN
 
class Hashtable;
class FormatParser;
class DateTimeMatcher;
class DistanceInfo;
class PatternMap;
class PtnSkeleton;
class SharedDateTimePatternGenerator;
 
class U_I18N_API DateTimePatternGenerator : public UObject {
public:
    static DateTimePatternGenerator* U_EXPORT2 createInstance(UErrorCode& status);
 
    static DateTimePatternGenerator* U_EXPORT2 createInstance(const Locale& uLocale, UErrorCode& status);
 
#ifndef U_HIDE_INTERNAL_API
 
    static DateTimePatternGenerator* U_EXPORT2 internalMakeInstance(const Locale& uLocale, UErrorCode& status);
 
#endif /* U_HIDE_INTERNAL_API */
 
     static DateTimePatternGenerator* U_EXPORT2 createEmptyInstance(UErrorCode& status);
 
    virtual ~DateTimePatternGenerator();
 
    DateTimePatternGenerator* clone() const;
 
    UBool operator==(const DateTimePatternGenerator& other) const;
 
    UBool operator!=(const DateTimePatternGenerator& other) const;
 
#ifndef U_HIDE_DRAFT_API
    static UnicodeString staticGetSkeleton(const UnicodeString& pattern, UErrorCode& status);
#endif  /* U_HIDE_DRAFT_API */
 
    UnicodeString getSkeleton(const UnicodeString& pattern, UErrorCode& status); /* {
        The function is commented out because it is a stable API calling a draft API.
        After staticGetSkeleton becomes stable, staticGetSkeleton can be used and
        these comments and the definition of getSkeleton in dtptngen.cpp should be removed.
        return staticGetSkeleton(pattern, status);
    }*/
 
#ifndef U_HIDE_DRAFT_API
    static UnicodeString staticGetBaseSkeleton(const UnicodeString& pattern, UErrorCode& status);
#endif  /* U_HIDE_DRAFT_API */
 
    UnicodeString getBaseSkeleton(const UnicodeString& pattern, UErrorCode& status); /* {
        The function is commented out because it is a stable API calling a draft API.
        After staticGetBaseSkeleton becomes stable, staticGetBaseSkeleton can be used and
        these comments and the definition of getBaseSkeleton in dtptngen.cpp should be removed.
        return staticGetBaseSkeleton(pattern, status);
    }*/
 
    UDateTimePatternConflict addPattern(const UnicodeString& pattern,
                                        UBool override,
                                        UnicodeString& conflictingPattern,
                                        UErrorCode& status);
 
    void setAppendItemFormat(UDateTimePatternField field, const UnicodeString& value);
 
    const UnicodeString& getAppendItemFormat(UDateTimePatternField field) const;
 
    void setAppendItemName(UDateTimePatternField field, const UnicodeString& value);
 
    const UnicodeString& getAppendItemName(UDateTimePatternField field) const;
 
    void setDateTimeFormat(const UnicodeString& dateTimeFormat);
 
    const UnicodeString& getDateTimeFormat() const;
 
     UnicodeString getBestPattern(const UnicodeString& skeleton, UErrorCode& status);
 
 
     UnicodeString getBestPattern(const UnicodeString& skeleton,
                                  UDateTimePatternMatchOptions options,
                                  UErrorCode& status);
 
 
     UnicodeString replaceFieldTypes(const UnicodeString& pattern,
                                     const UnicodeString& skeleton,
                                     UErrorCode& status);
 
     UnicodeString replaceFieldTypes(const UnicodeString& pattern,
                                     const UnicodeString& skeleton,
                                     UDateTimePatternMatchOptions options,
                                     UErrorCode& status);
 
     StringEnumeration* getSkeletons(UErrorCode& status) const;
 
     const UnicodeString& getPatternForSkeleton(const UnicodeString& skeleton) const;
 
     StringEnumeration* getBaseSkeletons(UErrorCode& status) const;
 
#ifndef U_HIDE_INTERNAL_API
     StringEnumeration* getRedundants(UErrorCode& status);
#endif  /* U_HIDE_INTERNAL_API */
 
    void setDecimal(const UnicodeString& decimal);
 
    const UnicodeString& getDecimal() const;
 
    virtual UClassID getDynamicClassID() const;
 
    static UClassID U_EXPORT2 getStaticClassID(void);
 
private:
    DateTimePatternGenerator(UErrorCode & status);
 
    DateTimePatternGenerator(const Locale& locale, UErrorCode & status);
 
    DateTimePatternGenerator(const DateTimePatternGenerator& other);
 
    DateTimePatternGenerator& operator=(const DateTimePatternGenerator& other);
 
    Locale pLocale;  // pattern locale
    FormatParser *fp;
    DateTimeMatcher* dtMatcher;
    DistanceInfo *distanceInfo;
    PatternMap *patternMap;
    UnicodeString appendItemFormats[UDATPG_FIELD_COUNT];
    UnicodeString appendItemNames[UDATPG_FIELD_COUNT];
    UnicodeString dateTimeFormat;
    UnicodeString decimal;
    DateTimeMatcher *skipMatcher;
    Hashtable *fAvailableFormatKeyHash;
    UnicodeString hackPattern;
    UnicodeString emptyString;
    UChar fDefaultHourFormatChar;
 
    int32_t fAllowedHourFormats[7];  // Actually an array of AllowedHourFormat enum type, ending with UNKNOWN.
 
    /* internal flags masks for adjustFieldTypes etc. */
    enum {
        kDTPGNoFlags = 0,
        kDTPGFixFractionalSeconds = 1,
        kDTPGSkeletonUsesCapJ = 2,
        kDTPGSkeletonUsesLowB = 3,
        kDTPGSkeletonUsesCapB = 4
    };
 
    void initData(const Locale &locale, UErrorCode &status);
    void addCanonicalItems();
    void addICUPatterns(const Locale& locale, UErrorCode& status);
    void hackTimes(const UnicodeString& hackPattern, UErrorCode& status);
    void addCLDRData(const Locale& locale, UErrorCode& status);
    UDateTimePatternConflict addPatternWithSkeleton(const UnicodeString& pattern, const UnicodeString * skeletonToUse, UBool override, UnicodeString& conflictingPattern, UErrorCode& status);
    void initHashtable(UErrorCode& status);
    void setDateTimeFromCalendar(const Locale& locale, UErrorCode& status);
    void setDecimalSymbols(const Locale& locale, UErrorCode& status);
    UDateTimePatternField getAppendFormatNumber(const char* field) const;
    UDateTimePatternField getAppendNameNumber(const char* field) const;
    void getAppendName(UDateTimePatternField field, UnicodeString& value);
    int32_t getCanonicalIndex(const UnicodeString& field);
    const UnicodeString* getBestRaw(DateTimeMatcher& source, int32_t includeMask, DistanceInfo* missingFields, const PtnSkeleton** specifiedSkeletonPtr = 0);
    UnicodeString adjustFieldTypes(const UnicodeString& pattern, const PtnSkeleton* specifiedSkeleton, int32_t flags, UDateTimePatternMatchOptions options = UDATPG_MATCH_NO_OPTIONS);
    UnicodeString getBestAppending(int32_t missingFields, int32_t flags, UDateTimePatternMatchOptions options = UDATPG_MATCH_NO_OPTIONS);
    int32_t getTopBitNumber(int32_t foundMask);
    void setAvailableFormat(const UnicodeString &key, UErrorCode& status);
    UBool isAvailableFormatSet(const UnicodeString &key) const;
    void copyHashtable(Hashtable *other, UErrorCode &status);
    UBool isCanonicalItem(const UnicodeString& item) const;
    static void loadAllowedHourFormatsData(UErrorCode &status);
    void getAllowedHourFormats(const Locale &locale, UErrorCode &status);
} ;// end class DateTimePatternGenerator
 
U_NAMESPACE_END
 
#endif