okteta-dev 4:4.8.4+dfsg-1 / usr / include / okteta1 / wordbytearrayservice.h

/*
    This file is part of the Okteta Core library, made within the KDE community.

    Copyright 2005,2008-2009 Friedrich W. H. Kossebau <kossebau@kde.org>

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) version 3, or any
    later version accepted by the membership of KDE e.V. (or its
    successor approved by the membership of KDE e.V.), which shall
    act as a proxy defined in Section 6 of version 3 of the license.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef OKTETA_WORDBYTEARRAYSERVICE_H
#define OKTETA_WORDBYTEARRAYSERVICE_H

// lib
#include "oktetacore_export.h"
#include "addressrange.h"

class QString;


namespace Okteta
{

class AbstractByteArrayModel;
class CharCodec;

/**
  *
  *@author Friedrich W. H. Kossebau
  */

class OKTETACORE_EXPORT WordByteArrayService
{
  public:
    WordByteArrayService( const AbstractByteArrayModel* byteArrayModel, const CharCodec* charCodec );
    ~WordByteArrayService();


  public:
    /** searches for the start of the word including the given index.
      * if no other nonwordchar preceds this is 0;
      * If the byte at the given index is already a nonword char the given index is returned.
      * @param index index to start with
      * @return index of the first char of the current word or the given index if there is none
      */
    Address indexOfWordStart( Address index ) const;
    Address indexOfLeftWordSelect( Address index ) const;
    /** searches for the end of the word including the given index.
      * If the byte at the given index is already a nonword char the given index is returned.
      * if no other nonwordchar follows, that of the last byte;
      * @param index index to start with
      * @return index of the last char of the current word or the given index if there is none
      */
    Address indexOfWordEnd( Address index ) const;
    /** searches for the first char after the end of the word including the given index.
      * If the byte at the given index is already a nonword char the given index is returned.
      * if no other nonwordchar follows that of behind the last byte;
      * @param index index to start with
      * @return index of the first char after the current word or the given index if there is none
      */
    Address indexOfRightWordSelect( Address index ) const;
    /** searches for the first char after the end of the word including the given index.
      * If the byte at the given index is already a nonword char the given index is returned.
      * if no other nonwordchar follows that of behind the last byte;
      * @param index index to start with
      * @return index of the first char after the current word or the given index if there is none
      */
//    Address indexOfBehindLeftWordEnd( Address index ) const;
    /** searches for the first char after the end of the word including the given index.
      * If the byte at the given index is already a nonword char the given index is returned.
      * if no other nonwordchar follows that of behind the last byte;
      * @param index index to start with
      * @return index of the first char after the current word or the given index if there is none
      */
//    Address indexOfBehindRightWordEnd( Address index ) const;
    /** searches the start of the next previous word that does not include the given index,
      * if no further word is found 0 is returned.
      * if the index is out of range the behaviour is undefined.
      * @param index
      * @return index of the next previous word start or 0
      */
    Address indexOfPreviousWordStart( Address index ) const;
    /** searches for the start of the next word not including the given index.
      * if there isn't a next word the index behind end is returned
      * @param index
      * @return index of the start of the next word or behind end
      */
    Address indexOfNextWordStart( Address index ) const;
    /** searches for the start of the next word not including the given index.
      * if there isn't a next word the index of the end is returned
      * @param index index to start with
      * @return index of the last nonword char before the next word or the last index
      */
    Address indexOfBeforeNextWordStart( Address index ) const;

    /** if index is out of range the behaviour is undefined
      * @param index
      * @return @c true if the byte at position i is a char of type CharType 
      */
    bool isWordChar( Address index ) const;

    /** returns the section with a word around index.
      * if there is no word the section is empty
      * @param index
      * @return the section with a word around index.
      */
    AddressRange wordSection( Address index ) const;

    /** returns the text starting at the given index until the first non-text byte
      * if there is no text byte at the index the result is empty.
      * @param index
      * @param lastIndex if -1 lastIndex is set to the end of th byte array.
      * @return the text starting at the index
      */
    QString text( Address index, Address lastIndex = -1 ) const;

  protected:
    const AbstractByteArrayModel* const mByteArrayModel;
    const CharCodec* const mCharCodec;
};

}

#endif