Click here to Skip to main content
15,878,809 members
Articles / Programming Languages / C#

Resolving Symbolic References in a CodeDOM (Part 7)

Rate me:
Please Sign up or sign in to vote.
4.75/5 (6 votes)
2 Dec 2012CDDL12 min read 19.4K   509   14  
Resolving symbolic references in a CodeDOM.
// The Nova Project by Ken Beckett.
// Copyright (C) 2007-2012 Inevitable Software, all rights reserved.
// Released under the Common Development and Distribution License, CDDL-1.0: http://opensource.org/licenses/cddl1.php

using Nova.Parsing;
using Nova.Rendering;

namespace Nova.CodeDOM
{
    /// <summary>
    /// The type of a <see cref="LineDirective"/>.
    /// </summary>
    public enum LineDirectiveType { Number, Default, Hidden }

    /// <summary>
    /// Used to control embedded line number information.
    /// </summary>
    public class LineDirective : CompilerDirective
    {
        #region /* FIELDS */

        protected LineDirectiveType _directiveType;
        protected int _number;
        protected string _fileName;

        #endregion

        #region /* CONSTRUCTORS */

        /// <summary>
        /// Create a <see cref="LineDirective"/> with the specified type.
        /// </summary>
        public LineDirective(LineDirectiveType directiveType)
        {
            _directiveType = directiveType;
        }

        /// <summary>
        /// Create a <see cref="LineDirective"/> with the specified line number and file name.
        /// </summary>
        public LineDirective(int number, string fileName)
            : this(LineDirectiveType.Number)
        {
            _number = number;
            _fileName = fileName;
        }

        #endregion

        #region /* PROPERTIES */

        /// <summary>
        /// The type of the <see cref="LineDirective"/>.
        /// </summary>
        public LineDirectiveType DirectiveType
        {
            get { return _directiveType; }
            set { _directiveType = value; }
        }

        /// <summary>
        /// The associated line number.
        /// </summary>
        public int Number
        {
            get { return _number; }
            set { _number = value; }
        }

        /// <summary>
        /// The associated file name.
        /// </summary>
        public string FileName
        {
            get { return _fileName; }
            set { _fileName = value; }
        }

        #endregion

        #region /* PARSING */

        /// <summary>
        /// The token used to parse the code object.
        /// </summary>
        public new const string ParseToken = "line";

        /// <summary>
        /// The token used to parse the 'default' type.
        /// </summary>
        public const string ParseTokenDefault = "default";

        /// <summary>
        /// The token used to parse the 'hidden' type.
        /// </summary>
        public const string ParseTokenHidden = "hidden";

        internal static void AddParsePoints()
        {
            Parser.AddCompilerDirectiveParsePoint(ParseToken, Parse);
        }

        /// <summary>
        /// Parse a <see cref="LineDirective"/>.
        /// </summary>
        public static LineDirective Parse(Parser parser, CodeObject parent, ParseFlags flags)
        {
            return new LineDirective(parser, parent);
        }

        /// <summary>
        /// Parse a <see cref="LineDirective"/>.
        /// </summary>
        public LineDirective(Parser parser, CodeObject parent)
            : base(parser, parent)
        {
            Token token = parser.NextTokenSameLine(false);  // Move past the keyword
            if (token != null)
            {
                // Parse the directive type
                _directiveType = ParseLineDirectiveType(parser.TokenText);
                if (_directiveType != LineDirectiveType.Number)
                    parser.NextToken();  // Move past the directive type
                else
                {
                    // Parse the line number
                    if (!int.TryParse(token.Text, out _number))
                    {
                        _number = int.MaxValue;
                        parser.AttachMessage(this, "Integer value expected", token);
                    }
                    token = parser.NextTokenSameLine(false);  // Move past the number
                    if (token != null)
                    {
                        // Get the filename
                        _fileName = token.Text;
                        parser.NextToken();  // Move past filename
                    }
                }
            }
            MoveEOLComment(parser.LastToken);
        }

        protected static LineDirectiveType ParseLineDirectiveType(string actionName)
        {
            LineDirectiveType action;
            switch (actionName)
            {
                case ParseTokenDefault: action = LineDirectiveType.Default; break;
                case ParseTokenHidden:  action = LineDirectiveType.Hidden; break;
                default:                action = LineDirectiveType.Number; break;
            }
            return action;
        }

        #endregion

        #region /* FORMATTING */

        /// <summary>
        /// Determines if the compiler directive should be indented.
        /// </summary>
        public override bool HasNoIndentationDefault
        {
            get { return false; }
        }

        #endregion

        #region /* RENDERING */

        /// <summary>
        /// The keyword associated with the compiler directive (if any).
        /// </summary>
        public override string DirectiveKeyword
        {
            get { return ParseToken; }
        }

        /// <summary>
        /// Format a <see cref="LineDirectiveType"/> as a string.
        /// </summary>
        public static string LineDirectiveTypeToString(LineDirectiveType directiveType)
        {
            switch (directiveType)
            {
                case LineDirectiveType.Default: return ParseTokenDefault;
                case LineDirectiveType.Hidden:  return ParseTokenHidden;
            }
            return "";
        }

        protected override void AsTextArgument(CodeWriter writer, RenderFlags flags)
        {
            if (_directiveType == LineDirectiveType.Number)
                writer.Write(_number + " " + _fileName);
            else
                writer.Write(LineDirectiveTypeToString(_directiveType));
        }

        #endregion
    }
}

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, along with any associated source code and files, is licensed under The Common Development and Distribution License (CDDL)


Written By
Software Developer (Senior)
United States United States
I've been writing software since the late 70's, currently focusing mainly on C#.NET. I also like to travel around the world, and I own a Chocolate Factory (sadly, none of my employees are oompa loompas).

Comments and Discussions