iterator.h

最新的版本ACE-5.6.8,刚从外文网上搬下,与大家分享.

// -*- C++ -*-

// $Id: Iterator.h 80826 2008-03-04 14:51:23Z wotte $

// 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 */