X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Fcarfire;a=blobdiff_plain;f=CarFire%2FCarFire%2FCarFire%2FParse.cs;h=ca98353067cf4f55e0ad499aa235082d1e4e32a7;hp=b9320778babcbcdfb62d685aec9306ce2639d6c7;hb=236bc590ff21370c1139a8c01ff35f7b30af743d;hpb=1393586d1e5639ac8f1e9fc8183644050dd54165

diff --git a/CarFire/CarFire/CarFire/Parse.cs b/CarFire/CarFire/CarFire/Parse.cs
index b932077..ca98353 100644
--- a/CarFire/CarFire/CarFire/Parse.cs
+++ b/CarFire/CarFire/CarFire/Parse.cs
@@ -9,7 +9,8 @@ namespace CarFire
 {
     /// <summary>
     /// Class with handy static methods taking strings and returning objects
-    /// parsed from those strings.
+    /// parsed from those strings.  For all of these functions, white space is
+    /// generally ignored, but superfluous characters are not allowed.
     /// </summary>
     public class Parse
     {
@@ -29,7 +30,7 @@ namespace CarFire
         /// Parses a comment of an INI file.
         /// </summary>
         /// <param name="line">Text.</param>
-        /// <returns>The comment.</returns>
+        /// <returns>The comment, or null if parsing failed.</returns>
         public static string IniComment(string line)
         {
             Match match = Regex.Match(line, @"^;\s*(.*)\s*$");
@@ -108,23 +109,35 @@ namespace CarFire
             return null;
         }
 
+        /// <summary>
+        /// Parses a single character.
+        /// </summary>
+        /// <param name="atom">Text.</param>
+        /// <returns>The character, or null if parsing failed.</returns>
+        public static char? Char(string atom)
+        {
+            string str = String(atom);
+            if (str != null && str.Length == 1) return str[0];
+            return null;
+        }
+
         /// <summary>
         /// Parses a constant from an enum.
         /// </summary>
         /// <typeparam name="T">An enumeration.</typeparam>
         /// <param name="atom">Text.</param>
-        /// <returns>The constant, or default(T) if parsing failed.</returns>
-        public static T Constant<T>(string atom)
+        /// <returns>The constant, or null if parsing failed.</returns>
+        public static T? Constant<T>(string atom) where T : struct
         {
             try
             {
-                return (T)System.Enum.Parse(typeof(T), String(atom), true);
+                return (T)System.Enum.Parse(typeof(T), String(atom));
             }
 #pragma warning disable 0168
             catch (System.Exception ex)
 #pragma warning restore 0168
             {
-                return default(T);
+                return null;
             }
         }
 
@@ -168,7 +181,7 @@ namespace CarFire
         /// Parses a function.
         /// </summary>
         /// <param name="atom">Text.</param>
-        /// <returns>An array two strings containing the function name and
+        /// <returns>An array with two strings containing the function name and
         /// parameter-list, in that order, or null if parsing failed.</returns>
         public static string[] Function(string atom)
         {