// Created on: 2008-01-21
// Created by: Vladislav ROMASHKO
// Copyright (c) 2008-2014 OPEN CASCADE SAS
//
// This file is part of Open CASCADE Technology software library.
//
// This library is free software; you can redistribute it and/or modify it under
// the terms of the GNU Lesser General Public License version 2.1 as published
// by the Free Software Foundation, with special exception defined in the file
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
// distribution for complete text of the license and disclaimer of any warranty.
//
// Alternatively, this file may be used under the terms of Open CASCADE
// commercial license or contractual agreement.

#ifndef _TFunction_IFunction_HeaderFile
#define _TFunction_IFunction_HeaderFile

#include "Standard.hxx"
#include "Standard_DefineAlloc.hxx"
#include "Standard_Handle.hxx"

#include "TDF_Label.hxx"
#include "NCollection_List.hxx"
#include "TFunction_ExecutionStatus.hxx"
#include "Standard_Integer.hxx"
#include "NCollection_DoubleMap.hxx"
class Standard_GUID;
class TFunction_Logbook;
class TFunction_Driver;
class TFunction_GraphNode;

//! Interface class for usage of Function Mechanism
class TFunction_IFunction
{
public:
  DEFINE_STANDARD_ALLOC

  //! Sets a new function attached to a label <L> with <ID>.
  //! It creates a new TFunction_Function attribute initialized by the <ID>,
  //! a new TFunction_GraphNode with an empty list of dependencies and
  //! the status equal to TFunction_ES_WrongDefinition.
  //! It registers the function in the scope of functions for this document.
  Standard_EXPORT static bool NewFunction(const TDF_Label& L, const Standard_GUID& ID);

  //! Deletes a function attached to a label <L>.
  //! It deletes a TFunction_Function attribute and a TFunction_GraphNode.
  //! It deletes the functions from the scope of function of this document.
  Standard_EXPORT static bool DeleteFunction(const TDF_Label& L);

  //! Updates dependencies for all functions of the scope.
  //! It returns false in case of an error.
  //! An empty constructor.
  Standard_EXPORT static bool UpdateDependencies(const TDF_Label& Access);

  Standard_EXPORT TFunction_IFunction();

  //! A constructor.
  //! Initializes the interface by the label of function.
  Standard_EXPORT TFunction_IFunction(const TDF_Label& L);

  //! Initializes the interface by the label of function.
  Standard_EXPORT void Init(const TDF_Label& L);

  //! Returns a label of the function.
  Standard_EXPORT const TDF_Label& Label() const;

  //! Updates the dependencies of this function only.
  Standard_EXPORT bool UpdateDependencies() const;

  //! The method fills-in the list by labels,
  //! where the arguments of the function are located.
  Standard_EXPORT void Arguments(NCollection_List<TDF_Label>& args) const;

  //! The method fills-in the list by labels,
  //! where the results of the function are located.
  Standard_EXPORT void Results(NCollection_List<TDF_Label>& res) const;

  //! Returns a list of previous functions.
  Standard_EXPORT void GetPrevious(NCollection_List<TDF_Label>& prev) const;

  //! Returns a list of next functions.
  Standard_EXPORT void GetNext(NCollection_List<TDF_Label>& prev) const;

  //! Returns the execution status of the function.
  Standard_EXPORT TFunction_ExecutionStatus GetStatus() const;

  //! Defines an execution status for a function.
  Standard_EXPORT void SetStatus(const TFunction_ExecutionStatus status) const;

  //! Returns the scope of all functions.
  Standard_EXPORT const NCollection_DoubleMap<int, TDF_Label>& GetAllFunctions() const;

  //! Returns the Logbook - keeper of modifications.
  Standard_EXPORT occ::handle<TFunction_Logbook> GetLogbook() const;

  //! Returns a driver of the function.
  Standard_EXPORT occ::handle<TFunction_Driver> GetDriver(const int thread = 0) const;

  //! Returns a graph node of the function.
  Standard_EXPORT occ::handle<TFunction_GraphNode> GetGraphNode() const;

private:
  TDF_Label myLabel;
};

#endif // _TFunction_IFunction_HeaderFile