PreprocessorListener.cs

/*
 * Anarres C Preprocessor
 * Copyright (c) 2007-2008, Shevek
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
 * or implied.  See the License for the specific language governing
 * permissions and limitations under the License.
 */
using System;

namespace CppNet {

    /**
     * A handler for preprocessor events, primarily errors and warnings.
     *
     * If no PreprocessorListener is installed in a Preprocessor, all
     * error and warning events will throw an exception. Installing a
     * listener allows more intelligent handling of these events.
     */
    public interface PreprocessorListener
    {
        /**
         * Handles a warning.
         *
         * The behaviour of this method is defined by the
         * implementation. It may simply record the error message, or
         * it may throw an exception.
         */
        void handleWarning(Source source, int line, int column, String msg);

        /**
         * Handles an error.
         *
         * The behaviour of this method is defined by the
         * implementation. It may simply record the error message, or
         * it may throw an exception.
         */
        void handleError(Source source, int line, int column, String msg);

        void handleSourceChange(Source source, String ev);
    }
}