Click here to Skip to main content
15,881,248 members
Articles / Programming Languages / C#

Spart, a parser generator framework 100% C#

Rate me:
Please Sign up or sign in to vote.
4.76/5 (71 votes)
22 Dec 20038 min read 347.2K   5.2K   129  
Spart is the C# sister of Spirit. It lets you quickly create code parsers directly in your application.
/// Spart License (zlib/png)
/// 
/// 
/// Copyright (c) 2003 Jonathan de Halleux
/// 
/// This software is provided 'as-is', without any express or implied warranty. 
/// In no event will the authors be held liable for any damages arising from 
/// the use of this software.
/// 
/// Permission is granted to anyone to use this software for any purpose, 
/// including commercial applications, and to alter it and redistribute it 
/// freely, subject to the following restrictions:
/// 
/// 1. The origin of this software must not be misrepresented; you must not 
/// claim that you wrote the original software. If you use this software in a 
/// product, an acknowledgment in the product documentation would be 
/// appreciated but is not required.
/// 
/// 2. Altered source versions must be plainly marked as such, and must not be 
/// misrepresented as being the original software.
/// 
/// 3. This notice may not be removed or altered from any source distribution.
/// 
/// Author: Jonathan de Halleuxusing System;

namespace Spart.Parsers
{
	using System;
	using Spart.Parsers.Primitives;
	using Spart.Parsers.Primitives.Testers;

	/// <summary>
	/// Static helper class to create primitive parsers
	/// </summary>
	public class Prims
	{
		/// <summary>
		/// Creates a parser that matches a single character
		/// </summary>
		/// <param name="c">character to match</param>
		/// <returns></returns>
		public static CharParser Ch(Char c)
		{
			return new CharParser(new LitteralCharTester(c));
		}

		/// <summary>
		/// Creates a parser that matches a string
		/// </summary>
		/// <param name="s">string to match</param>
		/// <returns></returns>
		public static StringParser Str(String s)
		{
			return new StringParser(s);
		}

		/// <summary>
		/// Creates a parser that matches a range of character
		/// </summary>
		/// <param name="first"></param>
		/// <param name="last"></param>
		/// <returns></returns>
		public static CharParser Range(Char first, Char last)
		{
			return new CharParser(new RangeCharTester(first, last));
		}

		/// <summary>
		/// Creates a parser that matches any character
		/// </summary>
		public static CharParser AnyChar
		{
			get
			{
				return new CharParser(new AnyCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches control characters
		/// </summary>
		public static CharParser Control
		{
			get
			{
				return new CharParser(new ControlCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches digit characters
		/// </summary>
		public static CharParser Digit
		{
			get
			{
				return new CharParser(new DigitCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches letter characters
		/// </summary>
		public static CharParser Letter
		{
			get
			{
				return new CharParser(new LetterCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches letter or digit characters
		/// </summary>
		public static CharParser LetterOrDigit
		{
			get
			{
				return new CharParser(new LetterOrDigitCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches lower case characters
		/// </summary>
		public static CharParser Lower
		{
			get
			{
				return new CharParser(new LowerCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches punctuation characters
		/// </summary>
		public static CharParser Punctuation
		{
			get
			{
				return new CharParser(new PunctuationCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches separator characters
		/// </summary>
		public static CharParser Separator
		{
			get
			{
				return new CharParser(new SeparatorCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches symbol characters
		/// </summary>
		public static CharParser Symbol
		{
			get
			{
				return new CharParser(new SymbolCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches upper case characters
		/// </summary>
		public static CharParser Upper
		{
			get
			{
				return new CharParser(new UpperCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches whitespace characters
		/// </summary>
		public static CharParser WhiteSpace
		{
			get
			{
				return new CharParser(new WhiteSpaceCharTester());
			}
		}

		/// <summary>
		/// Creates a parser that matches and end of line
		/// </summary>
		public static EolParser Eol
		{
			get
			{
				return new EolParser();
			}
		}

		/// <summary>
		/// Creates a parser that matches the end of the input
		/// </summary>
		public static EndParser End
		{
			get
			{
				return new EndParser();
			}
		}
	}
}

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Engineer
United States United States
Jonathan de Halleux is Civil Engineer in Applied Mathematics. He finished his PhD in 2004 in the rainy country of Belgium. After 2 years in the Common Language Runtime (i.e. .net), he is now working at Microsoft Research on Pex (http://research.microsoft.com/pex).

Comments and Discussions