iterator.h

ACE自适配通信环境（ADAPTIVE Communication Environment）是可以自由使用、开放源码的面向对象（OO）框架（Framework）

// -*- C++ -*-

// Iterator.h,v 4.6 2002/04/11 02:39:18 ossama Exp

// Copyright (C) 1989 Free Software Foundation, Inc.
// written by Douglas C. Schmidt ([e-mail])

// This file is part of GNU GPERF.

// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.

// This program 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 General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

#ifndef ITERATOR_H
#define ITERATOR_H

#include "ace/config-all.h"

#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */

#include "Options.h"

#if defined (ACE_HAS_GPERF)
class Iterator
{
  // = TITLE
  //   Provides an Iterator that expands and decodes a control string
  //   containing digits and ranges, returning an integer every time the
  //   generator function is called.
  //
  // = DESCRIPTION
  //   This class is used to decode the user's key position requests.
  //   For example: "-k 1,2,5-10,$" will return 1, 2, 5, 6, 7, 8, 9,
  //   10, and 0 ( representing the abstract ``last character of the
  //   key'' on successive calls to the member function operator ().
  //   No errors are handled in these routines, they are passed back
  //   to the calling routines via a user-supplied Error_Value */
public:
  Iterator (char *s,
            int lo,
            int hi,
            int word_end,
            int bad_val,
            int key_end);
  int operator () (void);

private:
  char *str;
  // A pointer to the string provided by the user.

  int end;
  // Value returned after last key is processed.

  int end_word;
  // A value marking the abstract ``end of word'' (usually '$').

  int error_value;
  // Error value returned when input is syntactically erroneous.

  int hi_bound;
  // Greatest possible value, inclusive.

  int lo_bound;
  // Smallest possible value, inclusive.
};

#endif /* ACE_HAS_GPERF */
#endif /* ITERATOR_H */