brkiter.h

Go to the documentation of this file.

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
********************************************************************************
*   Copyright (C) 1997-2016, International Business Machines
*   Corporation and others.  All Rights Reserved.
********************************************************************************
*
* File brkiter.h
*
* Modification History:
*
*   Date        Name        Description
*   02/18/97    aliu        Added typedef for TextCount.  Made DONE const.
*   05/07/97    aliu        Fixed DLL declaration.
*   07/09/97    jfitz       Renamed BreakIterator and interface synced with JDK
*   08/11/98    helena      Sync-up JDK1.2.
*   01/13/2000  helena      Added UErrorCode parameter to createXXXInstance methods.
********************************************************************************
*/
 
#ifndef BRKITER_H
#define BRKITER_H
 
#include "unicode/utypes.h"
 
#if UCONFIG_NO_BREAK_ITERATION
 
U_NAMESPACE_BEGIN
 
/*
 * Allow the declaration of APIs with pointers to BreakIterator
 * even when break iteration is removed from the build.
 */
class BreakIterator;
 
U_NAMESPACE_END
 
#else
 
#include "unicode/uobject.h"
#include "unicode/unistr.h"
#include "unicode/chariter.h"
#include "unicode/locid.h"
#include "unicode/ubrk.h"
#include "unicode/strenum.h"
#include "unicode/utext.h"
#include "unicode/umisc.h"
 
U_NAMESPACE_BEGIN
 
class U_COMMON_API BreakIterator : public UObject {
public:
    virtual ~BreakIterator();
 
    virtual UBool operator==(const BreakIterator&) const = 0;
 
    UBool operator!=(const BreakIterator& rhs) const { return !operator==(rhs); }
 
    virtual BreakIterator* clone(void) const = 0;
 
    virtual UClassID getDynamicClassID(void) const = 0;
 
    virtual CharacterIterator& getText(void) const = 0;
 
 
     virtual UText *getUText(UText *fillIn, UErrorCode &status) const = 0;
 
    virtual void  setText(const UnicodeString &text) = 0;
 
    virtual void  setText(UText *text, UErrorCode &status) = 0;
 
    virtual void  adoptText(CharacterIterator* it) = 0;
 
    enum {
        DONE = (int32_t)-1
    };
 
    virtual int32_t first(void) = 0;
 
    virtual int32_t last(void) = 0;
 
    virtual int32_t previous(void) = 0;
 
    virtual int32_t next(void) = 0;
 
    virtual int32_t current(void) const = 0;
 
    virtual int32_t following(int32_t offset) = 0;
 
    virtual int32_t preceding(int32_t offset) = 0;
 
    virtual UBool isBoundary(int32_t offset) = 0;
 
    virtual int32_t next(int32_t n) = 0;
 
    virtual int32_t getRuleStatus() const;
 
    virtual int32_t getRuleStatusVec(int32_t *fillInVec, int32_t capacity, UErrorCode &status);
 
    static BreakIterator* U_EXPORT2
    createWordInstance(const Locale& where, UErrorCode& status);
 
    static BreakIterator* U_EXPORT2
    createLineInstance(const Locale& where, UErrorCode& status);
 
    static BreakIterator* U_EXPORT2
    createCharacterInstance(const Locale& where, UErrorCode& status);
 
    static BreakIterator* U_EXPORT2
    createSentenceInstance(const Locale& where, UErrorCode& status);
 
    static BreakIterator* U_EXPORT2
    createTitleInstance(const Locale& where, UErrorCode& status);
 
    static const Locale* U_EXPORT2 getAvailableLocales(int32_t& count);
 
    static UnicodeString& U_EXPORT2 getDisplayName(const Locale& objectLocale,
                                         const Locale& displayLocale,
                                         UnicodeString& name);
 
    static UnicodeString& U_EXPORT2 getDisplayName(const Locale& objectLocale,
                                         UnicodeString& name);
 
    virtual BreakIterator *  createBufferClone(void *stackBuffer,
                                               int32_t &BufferSize,
                                               UErrorCode &status) = 0;
 
#ifndef U_HIDE_DEPRECATED_API
 
    inline UBool isBufferClone(void);
 
#endif /* U_HIDE_DEPRECATED_API */
 
#if !UCONFIG_NO_SERVICE
 
    static URegistryKey U_EXPORT2 registerInstance(BreakIterator* toAdopt,
                                        const Locale& locale,
                                        UBreakIteratorType kind,
                                        UErrorCode& status);
 
    static UBool U_EXPORT2 unregister(URegistryKey key, UErrorCode& status);
 
    static StringEnumeration* U_EXPORT2 getAvailableLocales(void);
#endif
 
    Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;
 
#ifndef U_HIDE_INTERNAL_API
 
    const char *getLocaleID(ULocDataLocaleType type, UErrorCode& status) const;
#endif  /* U_HIDE_INTERNAL_API */
 
    virtual BreakIterator &refreshInputText(UText *input, UErrorCode &status) = 0;
 
 private:
    static BreakIterator* buildInstance(const Locale& loc, const char *type, UErrorCode& status);
    static BreakIterator* createInstance(const Locale& loc, int32_t kind, UErrorCode& status);
    static BreakIterator* makeInstance(const Locale& loc, int32_t kind, UErrorCode& status);
 
    friend class ICUBreakIteratorFactory;
    friend class ICUBreakIteratorService;
 
protected:
    // Do not enclose protected default/copy constructors with #ifndef U_HIDE_INTERNAL_API
    // or else the compiler will create a public ones.
    BreakIterator();
    BreakIterator (const BreakIterator &other);
#ifndef U_HIDE_INTERNAL_API
 
    BreakIterator (const Locale& valid, const Locale &actual);
    BreakIterator &operator = (const BreakIterator &other);
#endif  /* U_HIDE_INTERNAL_API */
 
private:
 
    char actualLocale[ULOC_FULLNAME_CAPACITY];
    char validLocale[ULOC_FULLNAME_CAPACITY];
};
 
#ifndef U_HIDE_DEPRECATED_API
 
inline UBool BreakIterator::isBufferClone()
{
    return FALSE;
}
 
#endif /* U_HIDE_DEPRECATED_API */
 
U_NAMESPACE_END
 
#endif /* #if !UCONFIG_NO_BREAK_ITERATION */
 
#endif // BRKITER_H
//eof