2.1.0 - small API improvements, extended documentation

Author: mariuszgromada

CURRENT/README.txt

@@ -1,6 +1,21 @@
                  mXparser - Math Parser Java C# .NET (CLS) Library beta
          A flexible mathematical expressions parser for JAVA and C# .NET (CLS)
 
+v.2.1.0 (2016-01-02): 
+    * New static methods in class mxparser
+        - mXparser.numberToHexString(number) + overloads: int, long, double
+        - mXparser.hexString2AsciiString(String hexString)
+        - mXparser.numberToAsciiString(number) + overloads: int, long, double
+		- additional regression tests for the above methods
+		
+	* Hello World examples of how to use mXparser binary library (manual includes:
+	  projects, code, screenshots) for:
+	    - JAVA (project done in Eclipse Mars 1)
+		- C# (project done in Visual Studio 2015)
+		- Visual Basic (project done in Visual Studio 2015)
+		- C++/CLI (project done in Visual Studio 2015)
+		- F# (project done in Visual Studio 2015)
+
 v.2.0.0 (2015-12-31): Major update of the library providing more intuitive and
 much simpler to use API, no changes to the MathCollection.
 

CURRENT/c-sharp/.vs/mXparser/v14/.suo

@@ -1,5 +1,5 @@
 /*
- * @(#)RegTestExpression.cs        2.0.0    2015-12-29
+ * @(#)RegTestExpression.cs        2.1.0    2016-01-01
  * 
  * You may use this software under the condition of "Simplified BSD License"
  * 
@@ -64,7 +64,7 @@ namespace org.mariuszgromada.math.mxparser.regressiontesting
      *                 <a href="http://mariuszgromada.github.io/MathParser.org-mXparser/" target="_blank">mXparser on GitHub pages</a><br>
      *                 <a href="http://mxparser.sourceforge.net/" target="_blank">mXparser on SourceForge/</a><br>
      *                         
-     * @version        2.0.0
+     * @version        2.1.0
      * 
      * @see Expression
      */
@@ -4762,6 +4762,36 @@ private static bool runTest(int testId) {
 		mXparser.consolePrint(value + " reg ... " + reg + " --> ");		
 
 		break;
+	case 287:
+		
+		expStr = "5^2 * 7^3 * 11^1 * 67^1 * 49201^1";
+
+		mXparser.consolePrint(expStr + " ...... ");
+		exp[testId] = new Expression(expStr);
+		String hello = mXparser.numberToAsciiString(exp[testId].calculate());
+		String regHello = "Hello";
+		
+		if ( regHello.Equals(hello) )
+			testResult = true;
+		
+		mXparser.consolePrint(hello + " reg ... " + regHello + " --> ");		
+
+		break;
+	case 288:
+		
+		expStr = "71^1 * 218549^1 * 6195547^1";
+
+		mXparser.consolePrint(expStr + " ...... ");
+		exp[testId] = new Expression(expStr);
+		String world = mXparser.numberToAsciiString(exp[testId].calculate());
+		String regWorld = "World!";
+		
+		if ( regWorld.Equals(world) )
+			testResult = true;
+		
+		mXparser.consolePrint(world + " reg ... " + regWorld + " --> ");		
+
+		break;
 
 
 	}
@@ -4783,7 +4813,7 @@ private static bool runTest(int testId) {
          */
         public static void Start() {
 		// TODO Auto-generated method stub
-		int numberOfTests = 286;
+		int numberOfTests = 288;
 		int nOk = 0;
 		int nError = 0;
 		exp = new Expression[numberOfTests+1];

CURRENT/c-sharp/RegTestExpressionV2.cs

@@ -1,5 +1,5 @@
 /*
- * @(#)mXparser.cs        2.0.0    2015-12-29
+ * @(#)mXparser.cs        2.1.0    2016-01-01
  * 
  * You may use this software under the condition of "Simplified BSD License"
  * 
@@ -43,6 +43,7 @@
 using System;
 using System.Collections.Generic;
 using System.Text.RegularExpressions;
+using System.Globalization;
 
 [assembly: CLSCompliant(true)]
 
@@ -62,7 +63,7 @@ namespace org.mariuszgromada.math.mxparser {
      *                 <a href="http://mariuszgromada.github.io/MathParser.org-mXparser/" target="_blank">mXparser on GitHub pages</a><br>
      *                 <a href="http://mxparser.sourceforge.net/" target="_blank">mXparser on SourceForge/</a><br>
      *                         
-     * @version        2.0.0
+     * @version        2.1.0
      * 
      * @see RecursiveArgument
      * @see Expression
@@ -136,6 +137,101 @@ public static double[] arraList2double(List<Double> numbers) {
 
 	    }
 
+        /**
+         * Converts integer number to hex string (plain text)
+         * 
+         * @param number   Integer number
+         * @return         Hex string (i.e. FF23)
+         */
+        public static String numberToHexString(int number)
+        {
+            return number.ToString("X");
+        }
+
+        /**
+         * Converts long number to hex string (plain text)
+         * 
+         * @param number   Long number
+         * @return         Hex string (i.e. FF23)
+         */
+        public static String numberToHexString(long number)
+        {
+            return number.ToString("X");
+        }
+
+        /**
+         * Converts (long)double number to hex string (plain text)
+         * 
+         * @param number   Double number
+         * @return         Hex string (i.e. FF23)
+         */
+        public static String numberToHexString(double number)
+        {
+            return numberToHexString((long)number);
+        }
+
+
+        /**
+         * Converts hex string into ASCII string, where each letter is
+         * represented by two hex digits (byte) from the hex string.
+         * 
+         * @param hexString   Hex string (i.e. 48656C6C6F)
+         * @return         ASCII string (i.e. '48656C6C6F' = 'Hello')
+         */
+        public static String hexString2AsciiString(String hexString)
+        {
+            String hexByteStr;
+            int hexByteInt;
+            String asciiString = "";
+            for (int i = 0; i < hexString.Length; i += 2)
+            {
+                hexByteStr = hexString.Substring(i, 2);
+                hexByteInt = int.Parse(hexByteStr, NumberStyles.HexNumber);
+                asciiString = asciiString + (char)hexByteInt;
+            }
+            return asciiString;
+        }
+
+        /**
+         * Converts number into ASCII string, where each letter is
+         * represented by two hex digits (byte) from the hex representation
+         * of the original number
+         * 
+         * @param number   Integer number (i.e. 310939249775 = '48656C6C6F')
+         * @return         ASCII string (i.e. '48656C6C6F' = 'Hello')
+         */
+        public static String numberToAsciiString(int number)
+        {
+            return hexString2AsciiString(numberToHexString(number));
+        }
+
+        /**
+         * Converts number into ASCII string, where each letter is
+         * represented by two hex digits (byte) from the hex representation
+         * of the original number
+         * 
+         * @param number   Long number (i.e. 310939249775 = '48656C6C6F')
+         * @return         ASCII string (i.e. '48656C6C6F' = 'Hello')
+         */
+        public static String numberToAsciiString(long number)
+        {
+            return hexString2AsciiString(numberToHexString(number));
+        }
+
+        /**
+         * Converts (long)double number into ASCII string, where each letter is
+         * represented by two hex digits (byte) from the hex representation
+         * of the original number casted to long type.
+         * 
+         * @param number   Double number (i.e. 310939249775 = '48656C6C6F')
+         * @return         ASCII string (i.e. '48656C6C6F' = 'Hello')
+         */
+        public static String numberToAsciiString(double number)
+        {
+            return hexString2AsciiString(numberToHexString(number));
+        }
+
+
         /**
          * Prints object.toString to the Console + new line
          * 
@@ -150,7 +246,7 @@ public static void consolePrintln() {
         }
 
         /**
-         * Prints object.toString to the Console
+         * Prints object.toString to the Console, no new line
          * 
          * @param o    Object to print
          */

CURRENT/c-sharp/bin/Release/mxparser.dll

@@ -14,14 +14,14 @@ public static void Main(String[] args)
         {
             //Thread T1 = new Thread(RegTestExpression.Start, 536870912);
             //T1.Start();
-            //Thread T2 = new Thread(RegTestExpressionV2.Start, 536870912);
-            //T2.Start();
+            /// Thread T2 = new Thread(RegTestExpressionV2.Start, 536870912);
+            ///T2.Start();
             //Thread T3 = new Thread(RegTestExpressionAPI.Start);
             //T3.Start();
             //Thread T5 = new Thread(RegTestSyntax.Start);
             //T5.Start();
 
-            PerformanceTests.Start();
+           PerformanceTests.Start();
         }
     }
 }