#########################################################################

__ _

_ _ _____ \ ___ __ __\ \/ /

/ | | \ /_ \_ \/ _// _ \ \ /

| Y Y \ | / | / | | \/_ \ ___/| | \/ \

||_| //|| (__ /| /___ >\ >__| /___/\ \

\/ \/ \/ \/ _/

Copyright (C) 2014 Ingo Berg

Web: http://muparserx.beltoforion.de

SVN: http://muparserx.googlecode.com/svn/trunk

e-mail: muparserx@beltoforion.de

The code contains contributions made by the following people:

Martin Rotter

This software is distributed under the terms of the

BSD - Clause 2 "Simplified" or "FreeBSD" Licence (BSD-2-Clause)

#########################################################################

#########################################################################

Version history

#########################################################################

V3.0.2 (20140531)

Syntax rule changes:

• Semicolon removed as term separator (was not meant to be in the release)
• postfix operator identifiers are searched only at locations that could contain such an operator. (This will prevent conflicts with variable names.)

Bugfixes:

• untracked issuer: Identifiers of uninitialized variables could be lost in error messages.
• Issue 33: Value::operator+= and Value::operator-= do not work properly when used with complex values.

V3.0.1 (20140527)

Bugfixes:

• untracked issue: Index operator did not work properly when applied to non variable types. The bug only occured when used together with an assignment operator.

V3.0.0 (20140525)

Warning: The library requires a C++11 compliant compiler!

Syntax rule changes:

• Curly brackets removed from unit postfix operator identifiers. (I need them for on the fly array construction)
• in place array construction like: {1,2,3} to create a row vector
• Comma can no longer be used to separate terms in an expression.
• '#' added for comments

API Changes:

• C++11 features introduced in the code
• Functions defining variables, constants, operators or functions will now throw an exception if a a token with a similar identifier already exists. Their API changed to take a managed pointer instead of a raw pointer.
• Hooks for customizing error messages added; German translations added
• Functions for undefining variables, constants, functions and operators added
• Functions for querying the presence of variables, constants, functions and operators added

Changes:

• added "zeros" function for creating matrices initialized to all zero added
• added "eye" function for creating an idendity matrices
• added "size" function for determining matrix dimensions
• factorial operator added
• floating point data type can now be selected with the "MUP_FLOAT_TYPE" macro in mpDefines.h

Bugfixes:

• Issue 14: Precedence of Unary Operators
• Issue 17: Wrong result on complex power
• Issue 20: Library crash when " " is calculated
• Issue 23: min, max and sum functions return values when called without parameters
• Issue 26: bugfixes for "<<" and ">>" operators.
• Issue 27: Querying multiple results of comma separated expressions did not work (multiple results are no longer supported)
• Issue 31: m_nPosExpr incorrect value after Eval() or GetExprVar()
• untracked issue: compiling with UNICODE did not work
• untracked issue: Column number of matrices were not reported correctly
• untracked issue: expressions ending with newline could not be evaluated

V2.1.6 (20121221; Mayan calendar doomsday edition)

Bugfixes:

• Issue 16: Wrong operator precedence. Some binary operators had incorrect precedence values.
• untracked issue: "Unexpected variable" errors could report incorrect expression positions

V2.1.5 (20121102)

Bugfixes:

• Issue 13: Unpredictable behaviour when using backslash character in strings; Fixed by adding support for more escape sequences ("\n", "\r", "\t", "\"", "\")

V2.1.4 (20121010)

Changes / Additions:

• Added casting opertors to the Value class
• Added project for qt creator

Bugfixes:

• Issue 8: Crash on invalid expression in Release
• Issue 11: Roots of negative numbers computed incorrectly
• untracked issue: Fixed a problem caused by changes in the behaviour of tellg in GCC 4.6

V2.1.3 (20120715)

Bugfixes:

• Issue 7: Memory leak in GetExprVar

V2.1.2 (20120221)

Changes:

• License changed to the BSD-2-Clause licence

Bugfixes:

• Compiler warnings for gcc (gcc 4.3.4) fixed
• Issue 4 fixed: memory exception in mpValReader.cpp

V2.1.1 (20120201)

Bugfixes:

• Complex power operations could introduce small imaginary values in the result even if both arguments were real numbers. (i.e. the result of -2^8 was something like "-8 + 9e-19i")

V2.1.0 (20111016)

Bugfixes:

• Issue 1: Assertion when using a function with multiple arguments in the same expression twice with different number of arguments. (Reference: http://code.google.com/p/muparserx/issues/detail?id=1)
• Issue 2: DblValReader::IsValue broken for numbers at the end of the string

V2.0.0 (20111009)

Changes:

• data type changed to a matrix type instead of a vector type

• Multidimensional index operator added old: "m[1][2] = 1" new: "m[1,2] = 1"

• internal change: type identifier for matrices is now 'm', formerly 'a' was used to indicate arrays. An arrays are now seen as subsets of matrices, there is no special type for arrays.

Bugfixes:

• Matrix addition and subtraction work properly now.

V1.10.2 (20110911)

Bugfixes:

• Fix for changed behaviour of tellg in GCC 4.6.1. A Space is now appended to every expression in order to avoid problems.

V1.10 (20110310)

Warning: The API of this version is not backwards compatible and requires minor changes to client code!

Changes:

• Static type checking removed entirely (All type checking must be made at runtime by the callbacks themself)
• Optimizer removed. The optimizer had only limited effect since it only implemented a very simple constant folding mechanism. It collided with the new if-then-else logic and had to go. It will probably be reintroduced in one of the next versions using a different implementation.

• Expressions can now span multiple lines. This only makes sense when used together with the assignment operator i.e.:

  a=1
  b=2
  c=3
  sin(a+b+c)

Bugfixes:

• Nested if-then-else did not work properly
• Sign operators extended to work with arrays
• Operators "==" and "!=" did not work properly for arrays
• Relational operators "<", ">", "<=", ">=" did not work for complex numbers
• GCC makefile was broken in V1.09
• complex multiplication did not work correctly; was: (a+ib)(c+id)=>re=ac-bd;im=ad-bc instead of: (a+ib)(c+id)=>re=ac-bd;im=ad+bc
• Expressions with parameterless functions like a=foo() did not evaluate properly.

V1.09 (20101120)

Changes:

• Performance increased by factor 4 due to introducing a simple memory pool for value items.
• C++ like if-then-else operator added ( "(a<b) ? c : d")

Bugfixes:

• Memory leak fixed which prevented operator and funtion items from beeing released.

V1.08 (20100902)

Changes:

• Implicit creation of unknown variables at parser runtime is now possibe (i.e. expressions like "a=0"; with a beeing a undefined variable).
• Callbacks can now be organized in packages
• Callbacks split into a complex and a non complex package
• Complex power operator added

Bugfixes:

• Assignment operators did not work properly for complex values
• Complex sign operator fixed in order not to mess up 0 by multiplying it with -1 (-0 and 0 ar not the same according to IEEE754)

V1.07 (20100818)

Changes:

• Parsing performance improved by 20 - 30 % due to removing unnecessary copy constructor calls when returning the final result.
• License changed from GPLv3 to LGPLv3
• Assignment to vector elements is now possible (i.e.: va[1]=9)

Bugfixes:

• The Value type could not properly handle matrices (vector of vector) uses the reverse polish notation of an expression for the evaluation.
• Error messages did not display the proper type id's when compiled with UNICODE support.

V1.06 (20100710)

• Parsing performance improved by factor 2-3 due to a change which uses the reverse polish notation of an expression for the evaluation.

V1.05 (20100530)

• The parser now handles the associativity of binary operators properly
• Parsing performance improved by factor 7 due to caching tokens once an expression is parsed. Successive evaluations will use the cached tokens instead of parsing from string again.

V1.04 (20100516):

• Querying of expression variables implemented
• Bugfix for incorrect evaluation of expressions using the index operator added
• nil values removed
• Support for functions without parameters added
• UNICODE support added

V1.03:

• basic functions rewritten to complex valued functions
• Unit postfix operators added to the standard setup

V1.02:

• Index operator added
• addition/subtraction of vectors added

V1.01:

• Complex numbers added with support for basic binary operators
• Vector type added with support for basic operations (v*v, v+v)
• Variable class changed to take a pointer to a value class instead of base types like int or double.