public.hh 3.42 KB
Newer Older
1
// -*- coding: utf-8 -*-
2 3
// Copyright (C) 2009, 2012, 2013, 2014 Laboratoire de Recherche et
// Développement de l'Epita.
4 5 6
// Copyright (C) 2003, 2004, 2005, 2006 Laboratoire
// d'Informatique de Paris 6 (LIP6), département Systèmes Répartis
// Coopératifs (SRC), Université Pierre et Marie Curie.
Alexandre Duret-Lutz's avatar
Alexandre Duret-Lutz committed
7 8 9 10 11
//
// This file is part of Spot, a model checking library.
//
// Spot is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by
12
// the Free Software Foundation; either version 3 of the License, or
Alexandre Duret-Lutz's avatar
Alexandre Duret-Lutz committed
13 14 15 16 17 18 19 20
// (at your option) any later version.
//
// Spot 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
21
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
Alexandre Duret-Lutz's avatar
Alexandre Duret-Lutz committed
22

23 24 25
#ifndef SPOT_TGBAPARSE_PUBLIC_HH
# define SPOT_TGBAPARSE_PUBLIC_HH

26
# include "tgba/tgbagraph.hh"
27
# include "misc/location.hh"
28 29 30 31
# include "ltlenv/defaultenv.hh"
# include <string>
# include <list>
# include <utility>
32
# include <iosfwd>
33 34 35

namespace spot
{
36 37 38
  /// \addtogroup tgba_io
  /// @{

39
#ifndef SWIG
40
  /// \brief A parse diagnostic with its location.
41
  typedef std::pair<spot::location, std::string> tgba_parse_error;
42 43
  /// \brief A list of parser diagnostics, as filled by parse.
  typedef std::list<tgba_parse_error> tgba_parse_error_list;
44 45 46 47
#else
    // Turn parse_error_list into an opaque type for Swig.
    struct tgba_parse_error_list {};
#endif
48

49
  /// \brief Build a spot::tgba_digraph from a text file.
50 51 52
  /// \param filename The name of the file to parse.
  /// \param error_list A list that will be filled with
  ///        parse errors that occured during parsing.
53
  /// \param dict The BDD dictionary where to use.
54 55 56 57
  /// \param env The environment of atomic proposition into which parsing
  ///        should take place.
  /// \param envacc The environment of acceptance conditions into which parsing
  ///        should take place.
58 59 60 61 62 63 64 65 66 67
  /// \param debug When true, causes the parser to trace its execution.
  /// \return A pointer to the tgba built from \a filename, or
  ///        0 if the file could not be opened.
  ///
  /// Note that the parser usually tries to recover from errors.  It can
  /// return an non zero value even if it encountered error during the
  /// parsing of \a filename.  If you want to make sure \a filename
  /// was parsed succesfully, check \a error_list for emptiness.
  ///
  /// \warning This function is not reentrant.
68
  SPOT_API
69 70 71 72 73 74 75 76
  tgba_digraph* tgba_parse(const std::string& filename,
			   tgba_parse_error_list& error_list,
			   bdd_dict* dict,
			   ltl::environment& env
			   = ltl::default_environment::instance(),
			   ltl::environment& envacc
			   = ltl::default_environment::instance(),
			   bool debug = false);
77 78 79

  /// \brief Format diagnostics produced by spot::tgba_parse.
  /// \param os Where diagnostics should be output.
80
  /// \param filename The filename that should appear in the diagnostics.
81 82 83
  /// \param error_list The error list filled by spot::ltl::parse while
  ///        parsing \a ltl_string.
  /// \return \c true iff any diagnostic was output.
84
  SPOT_API
85
  bool format_tgba_parse_errors(std::ostream& os,
86
				const std::string& filename,
87
				tgba_parse_error_list& error_list);
88 89

  /// @}
90 91 92
}

#endif // SPOT_TGBAPARSE_PUBLIC_HH