search.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) 2001-2011 IBM and others. All rights reserved.
**********************************************************************
*   Date        Name        Description
*  03/22/2000   helena      Creation.
**********************************************************************
*/
 
#ifndef SEARCH_H
#define SEARCH_H
 
#include "unicode/utypes.h"
 
#if !UCONFIG_NO_COLLATION && !UCONFIG_NO_BREAK_ITERATION
 
#include "unicode/uobject.h"
#include "unicode/unistr.h"
#include "unicode/chariter.h"
#include "unicode/brkiter.h"
#include "unicode/usearch.h"
 
struct USearch;
typedef struct USearch USearch;
 
U_NAMESPACE_BEGIN
 
class U_I18N_API SearchIterator : public UObject {
 
public:
 
    // public constructors and destructors -------------------------------
 
    SearchIterator(const SearchIterator &other);
 
    virtual ~SearchIterator();
 
    // public get and set methods ----------------------------------------
 
    virtual void setOffset(int32_t position, UErrorCode &status) = 0;
 
    virtual int32_t getOffset(void) const = 0;
 
    void setAttribute(USearchAttribute       attribute,
                      USearchAttributeValue  value,
                      UErrorCode            &status);
 
    USearchAttributeValue getAttribute(USearchAttribute  attribute) const;
    
    int32_t getMatchedStart(void) const;
 
    int32_t getMatchedLength(void) const;
    
    void getMatchedText(UnicodeString &result) const;
    
    void setBreakIterator(BreakIterator *breakiter, UErrorCode &status);
    
    const BreakIterator * getBreakIterator(void) const;
 
    virtual void setText(const UnicodeString &text, UErrorCode &status);    
 
    virtual void setText(CharacterIterator &text, UErrorCode &status);
    
    const UnicodeString & getText(void) const;
 
    // operator overloading ----------------------------------------------
 
    virtual UBool operator==(const SearchIterator &that) const;
 
    UBool operator!=(const SearchIterator &that) const;
 
    // public methods ----------------------------------------------------
 
    virtual SearchIterator* safeClone(void) const = 0;
 
    int32_t first(UErrorCode &status);
 
    int32_t following(int32_t position, UErrorCode &status);
    
    int32_t last(UErrorCode &status);
 
    int32_t preceding(int32_t position, UErrorCode &status);
 
     int32_t next(UErrorCode &status);
 
    int32_t previous(UErrorCode &status);
 
    virtual void reset();
 
protected:
    // protected data members ---------------------------------------------
 
    USearch *m_search_;
 
    BreakIterator *m_breakiterator_;
    
    UnicodeString  m_text_;
 
    // protected constructors and destructors -----------------------------
 
    SearchIterator();
 
    SearchIterator(const UnicodeString &text, 
                         BreakIterator *breakiter = NULL);
 
    SearchIterator(CharacterIterator &text, BreakIterator *breakiter = NULL);
 
    // protected methods --------------------------------------------------
 
    SearchIterator & operator=(const SearchIterator &that);
 
    virtual int32_t handleNext(int32_t position, UErrorCode &status) 
                                                                         = 0;
 
     virtual int32_t handlePrev(int32_t position, UErrorCode &status) 
                                                                         = 0;
 
    virtual void setMatchLength(int32_t length);
 
    virtual void setMatchStart(int32_t position);
 
    void setMatchNotFound();
};
 
inline UBool SearchIterator::operator!=(const SearchIterator &that) const
{
   return !operator==(that); 
}
U_NAMESPACE_END
 
#endif /* #if !UCONFIG_NO_COLLATION */
 
#endif