/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */

/* vim: set ts=8 sts=2 et sw=2 tw=80: */

/* This Source Code Form is subject to the terms of the Mozilla Public

 * License, v. 2.0. If a copy of the MPL was not distributed with this

 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef nsStringIterator_h___

#define nsStringIterator_h___

#include "nsCharTraits.h"

#include "nsAlgorithm.h"

#include "nsDebug.h"

/**

 * @see nsTAString

 */

template <class CharT>

class nsReadingIterator

{

public:

  typedef nsReadingIterator<CharT>    self_type;

  typedef ptrdiff_t                   difference_type;

  typedef size_t                      size_type;

  typedef CharT                       value_type;

  typedef const CharT*                pointer;

  typedef const CharT&                reference;

private:

  friend class mozilla::detail::nsTStringRepr<CharT>;

  // unfortunately, the API for nsReadingIterator requires that the

  // iterator know its start and end positions.  this was needed when

  // we supported multi-fragment strings, but now it is really just

  // extra baggage.  we should remove mStart and mEnd at some point.

  const CharT* mStart;

  const CharT* mEnd;

  const CharT* mPosition;

public:

  nsReadingIterator()

    : mStart(nullptr)

    , mEnd(nullptr)

    , mPosition(nullptr)

  {

  }

  // nsReadingIterator( const nsReadingIterator<CharT>& );                    // auto-generated copy-constructor OK

  // nsReadingIterator<CharT>& operator=( const nsReadingIterator<CharT>& );  // auto-generated copy-assignment operator OK

  pointer get() const

  {

    return mPosition;

  }

  CharT operator*() const

  {

    return *get();

  }

  self_type& operator++()

  {

    ++mPosition;

    return *this;

  }

nsReadingIterator<char>::operator++()

Line

Count

Source

62

301k

  {

63

301k

    ++mPosition;

64

301k

    return *this;

65

301k

  }

Unexecuted instantiation: nsReadingIterator<char16_t>::operator++()

  self_type operator++(int)

  {

    self_type result(*this);

    ++mPosition;

    return result;

  }

  self_type& operator--()

  {

    --mPosition;

    return *this;

  }

Unexecuted instantiation: nsReadingIterator<char16_t>::operator--()

nsReadingIterator<char>::operator--()

Line

Count

Source

75

295k

  {

76

295k

    --mPosition;

77

295k

    return *this;

78

295k

  }

  self_type operator--(int)

  {

    self_type result(*this);

    --mPosition;

    return result;

  }

  self_type& advance(difference_type aN)

  {

    if (aN > 0) {

      difference_type step = XPCOM_MIN(aN, mEnd - mPosition);

      NS_ASSERTION(step > 0,

                   "can't advance a reading iterator beyond the end of a string");

      mPosition += step;

    } else if (aN < 0) {

      difference_type step = XPCOM_MAX(aN, -(mPosition - mStart));

      NS_ASSERTION(step < 0,

                   "can't advance (backward) a reading iterator beyond the end of a string");

      mPosition += step;

    }

    return *this;

  }

Unexecuted instantiation: nsReadingIterator<char16_t>::advance(long)

nsReadingIterator<char>::advance(long)

Line

Count

Source

88

66

  {

89

66

    if (aN > 0) {

90

66

      difference_type step = XPCOM_MIN(aN, mEnd - mPosition);

91

66

92

66

      NS_ASSERTION(step > 0,

93

66

                   "can't advance a reading iterator beyond the end of a string");

94

66

95

66

      mPosition += step;

96

66

    } else if (aN < 0) {

97

0

      difference_type step = XPCOM_MAX(aN, -(mPosition - mStart));

98

0

99

0

      NS_ASSERTION(step < 0,

100

0

                   "can't advance (backward) a reading iterator beyond the end of a string");

101

0

102

0

      mPosition += step;

103

0

    }

104

66

    return *this;

105

66

  }

  // We return an unsigned type here (with corresponding assert) rather than

  // the more usual difference_type because we want to make this class go

  // away in favor of mozilla::RangedPtr.  Since RangedPtr has the same

  // requirement we are enforcing here, the transition ought to be much

  // smoother.

  size_type operator-(const self_type& aOther) const

  {

    MOZ_ASSERT(mPosition >= aOther.mPosition);

    return mPosition - aOther.mPosition;

  }

};

template <class CharT>

inline bool

operator==(const nsReadingIterator<CharT>& aLhs,

           const nsReadingIterator<CharT>& aRhs)

{

  return aLhs.get() == aRhs.get();

}

bool operator==<char>(nsReadingIterator<char> const&, nsReadingIterator<char> const&)

Line

Count

Source

123

24.2k

{

124

24.2k

  return aLhs.get() == aRhs.get();

125

24.2k

}

Unexecuted instantiation: bool operator==<char16_t>(nsReadingIterator<char16_t> const&, nsReadingIterator<char16_t> const&)

template <class CharT>

inline bool

operator!=(const nsReadingIterator<CharT>& aLhs,

           const nsReadingIterator<CharT>& aRhs)

{

  return aLhs.get() != aRhs.get();

}

bool operator!=<char>(nsReadingIterator<char> const&, nsReadingIterator<char> const&)

Line

Count

Source

131

26.2M

{

132

26.2M

  return aLhs.get() != aRhs.get();

133

26.2M

}

bool operator!=<char16_t>(nsReadingIterator<char16_t> const&, nsReadingIterator<char16_t> const&)

Line

Count

Source

131

3.66M

{

132

3.66M

  return aLhs.get() != aRhs.get();

133

3.66M

}

#endif /* !defined(nsStringIterator_h___) */