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

diff --git a/CarFire/CarFire/CarFire/Parse.cs b/CarFire/CarFire/CarFire/Parse.cs
index 169cf30..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
     {
@@ -25,6 +26,18 @@ namespace CarFire
             return null;
         }
 
+        /// <summary>
+        /// Parses a comment of an INI file.
+        /// </summary>
+        /// <param name="line">Text.</param>
+        /// <returns>The comment, or null if parsing failed.</returns>
+        public static string IniComment(string line)
+        {
+            Match match = Regex.Match(line, @"^;\s*(.*)\s*$");
+            if (match.Success) return match.Groups[1].Value;
+            return null;
+        }
+
         /// <summary>
         /// Parses a key-value pair.
         /// </summary>
@@ -96,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;
             }
         }
 
@@ -156,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)
         {
@@ -182,7 +207,6 @@ namespace CarFire
             // FIXME: This may barf all over itself if there are nested parentheses, doublequotes, brackets, etc.
             foreach (Match match in matches)
             {
-                Console.WriteLine("matched: " + match.Value);
                 list.Add(match.Value);
             }