/usr/include/sbml/conversion/SBMLFunctionDefinitionConverter.h is in libsbml5-dev 5.10.0+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 | /**
* @file SBMLFunctionDefinitionConverter.h
* @brief Definition of SBMLFunctionDefinitionConverter, a converter replacing function definitions
* @author Frank Bergmann
*
* <!--------------------------------------------------------------------------
* This file is part of libSBML. Please visit http://sbml.org for more
* information about SBML, and the latest version of libSBML.
*
* Copyright (C) 2013-2014 jointly by the following organizations:
* 1. California Institute of Technology, Pasadena, CA, USA
* 2. EMBL European Bioinformatics Institute (EMBL-EBI), Hinxton, UK
* 3. University of Heidelberg, Heidelberg, Germany
*
* Copyright (C) 2009-2013 jointly by the following organizations:
* 1. California Institute of Technology, Pasadena, CA, USA
* 2. EMBL European Bioinformatics Institute (EMBL-EBI), Hinxton, UK
*
* Copyright (C) 2006-2008 by the California Institute of Technology,
* Pasadena, CA, USA
*
* Copyright (C) 2002-2005 jointly by the following organizations:
* 1. California Institute of Technology, Pasadena, CA, USA
* 2. Japan Science and Technology Agency, Japan
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation. A copy of the license agreement is provided
* in the file named "LICENSE.txt" included with this software distribution
* and also available online as http://sbml.org/software/libsbml/license.html
* ------------------------------------------------------------------------ -->
*
* @class SBMLFunctionDefinitionConverter
* @sbmlbrief{core} SBML converter for replacing function definitions.
*
* @htmlinclude libsbml-facility-only-warning.html
*
* This is an SBML converter for manipulating user-defined functions in an
* SBML file. When invoked on the current model, it performs the following
* operation:
* <ol>
* <li>Read the list of user-defined functions in the model (i.e., the
* list of FunctionDefinition objects);
* <li>Look for invocations of the function in mathematical expressions
* throughout the model; and
* <li>For each invocation found, replaces the invocation with a
* in-line copy of the function's body, similar to how macro expansions
* might be performed in scripting and programming languages.
* </ol>
*
* For example, suppose the model contains a function definition
* representing the function <i>f(x, y) = x * y</i>. Further
* suppose this functions invoked somewhere else in the model, in
* a mathematical formula, as <i>f(s, p)</i>. The outcome of running
* SBMLFunctionDefinitionConverter on the model will be to replace
* the call to <i>f</i> with the expression <i>s * p</i>.
*
* @see SBMLInitialAssignmentConverter
* @see SBMLLevelVersionConverter
* @see SBMLRuleConverter
* @see SBMLStripPackageConverter
* @see SBMLUnitsConverter
*/
#ifndef SBMLFunctionDefinitionConverter_h
#define SBMLFunctionDefinitionConverter_h
#include <sbml/SBMLNamespaces.h>
#include <sbml/conversion/SBMLConverter.h>
#include <sbml/conversion/SBMLConverterRegister.h>
#ifdef __cplusplus
LIBSBML_CPP_NAMESPACE_BEGIN
class LIBSBML_EXTERN SBMLFunctionDefinitionConverter : public SBMLConverter
{
public:
/** @cond doxygenLibsbmlInternal */
/* register with the ConversionRegistry */
static void init();
/** @endcond */
/**
* Creates a new SBMLFunctionDefinitionConverter object.
*/
SBMLFunctionDefinitionConverter();
/**
* Copy constructor; creates a copy of an SBMLFunctionDefinitionConverter
* object.
*
* @param obj the SBMLFunctionDefinitionConverter object to copy.
*/
SBMLFunctionDefinitionConverter(const SBMLFunctionDefinitionConverter& obj);
/**
* Creates and returns a deep copy of this SBMLFunctionDefinitionConverter
* object.
*
* @return a (deep) copy of this converter.
*/
virtual SBMLConverter* clone() const;
/**
* Destroy this SBMLFunctionDefinitionConverter object.
*/
virtual ~SBMLFunctionDefinitionConverter ();
/**
* Returns @c true if this converter object's properties match the given
* properties.
*
* A typical use of this method involves creating a ConversionProperties
* object, setting the options desired, and then calling this method on
* an SBMLFunctionDefinitionConverter object to find out if the object's
* property values match the given ones. This method is also used by
* SBMLConverterRegistry::getConverterFor(@if java const ConversionProperties& props@endif)
* to search across all registered converters for one matching particular
* properties.
*
* @param props the properties to match.
*
* @return @c true if this converter's properties match, @c false
* otherwise.
*/
virtual bool matchesProperties(const ConversionProperties &props) const;
/**
* Replaces invocations of each user-defined function with an in-line
* copy, similar to macro expansion.
*
* @return integer value indicating the success/failure of the operation.
* @if clike The value is drawn from the enumeration
* #OperationReturnValues_t. @endif@~ The possible values are:
* @li @link OperationReturnValues_t#LIBSBML_OPERATION_SUCCESS LIBSBML_OPERATION_SUCCESS @endlink
* @li @link OperationReturnValues_t#LIBSBML_OPERATION_FAILED LIBSBML_OPERATION_FAILED @endlink
* @li @link OperationReturnValues_t#LIBSBML_INVALID_OBJECT LIBSBML_INVALID_OBJECT @endlink
* @li @link OperationReturnValues_t#LIBSBML_CONV_INVALID_SRC_DOCUMENT LIBSBML_CONV_INVALID_SRC_DOCUMENT @endlink
*/
virtual int convert();
/**
* Returns the default properties of this converter.
*
* A given converter exposes one or more properties that can be adjusted
* in order to influence the behavior of the converter. This method
* returns the @em default property settings for this converter. It is
* meant to be called in order to discover all the settings for the
* converter object.
*
* @return the ConversionProperties object describing the default properties
* for this converter.
*/
virtual ConversionProperties getDefaultProperties() const;
private:
/** @cond doxygenLibsbmlInternal */
bool expandFD_errors(unsigned int errors);
/** @endcond */
};
LIBSBML_CPP_NAMESPACE_END
#endif /* __cplusplus */
#ifndef SWIG
LIBSBML_CPP_NAMESPACE_BEGIN
BEGIN_C_DECLS
END_C_DECLS
LIBSBML_CPP_NAMESPACE_END
#endif /* !SWIG */
#endif /* SBMLFunctionDefinitionConverter_h */
|