Package org.variantsync.diffdetective.feature.cpp

Class CPPAnnotationParser

java.lang.Object

org.variantsync.diffdetective.feature.PreprocessorAnnotationParser

org.variantsync.diffdetective.feature.cpp.CPPAnnotationParser

All Implemented Interfaces:

AnnotationParser

public class CPPAnnotationParser
extends PreprocessorAnnotationParser

Parses a C preprocessor statement. For example, given the annotation "#if defined(A) || B()", this class extracts the type AnnotationType.If with the formula new Or(new Literal("A"), new Literal("B")). The extractor detects if, ifdef, ifndef, elif, elifdef, elifndef, else and endif annotations. All other annotations are considered source code. The given CPP statement might also be a line in a diff (i.e., preceded by a - or +).

Author:

Paul Bittner, Sören Viegener, Benjamin Moosherr, Alexander Schultheiß

Field Summary

Fields

Modifier and Type	Field	Description
private static final Pattern	CPP_ANNOTATION_PATTERN
private static final String	CPP_ANNOTATION_REGEX
private org.antlr.v4.runtime.tree.ParseTreeVisitor<org.prop4j.Node>	formulaVisitor

Fields inherited from class org.variantsync.diffdetective.feature.PreprocessorAnnotationParser

annotationPattern

Constructor Summary

Constructors

Constructor	Description
CPPAnnotationParser()
CPPAnnotationParser(org.antlr.v4.runtime.tree.ParseTreeVisitor<org.prop4j.Node> formulaVisitor)

Method Summary

Modifier and Type	Method	Description
org.prop4j.Node	parseFormula(String directive, String formula)	Parses the feature formula of a preprocessor annotation line.

Methods inherited from class org.variantsync.diffdetective.feature.PreprocessorAnnotationParser

parseAnnotation, parseAnnotationType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

CPP_ANNOTATION_REGEX

private static final String CPP_ANNOTATION_REGEX

See Also:

• Constant Field Values

CPP_ANNOTATION_PATTERN

private static final Pattern CPP_ANNOTATION_PATTERN

formulaVisitor

private org.antlr.v4.runtime.tree.ParseTreeVisitor<org.prop4j.Node> formulaVisitor

Constructor Details

CPPAnnotationParser

public CPPAnnotationParser(org.antlr.v4.runtime.tree.ParseTreeVisitor<org.prop4j.Node> formulaVisitor)

CPPAnnotationParser

public CPPAnnotationParser()

Method Details

parseFormula

public org.prop4j.Node parseFormula(String directive,
 String formula)
                             throws UnparseableFormulaException

Description copied from class: PreprocessorAnnotationParser

Parses the feature formula of a preprocessor annotation line. It should abstract complex formulas (e.g., if they contain arithmetics or macro calls) as desired. For example, for the line "#if A && B == C", this method is should be called like parseFormula("if", "A && B == C") (the exact arguments are determined by PreprocessorAnnotationParser.annotationPattern and it should return something like and(var("A"), var("B==C")).

This method is only called if directive actually requires a formula as determined by PreprocessorAnnotationParser.parseAnnotationType(java.lang.String).

Specified by:

parseFormula in class PreprocessorAnnotationParser

Parameters:

directive - as matched by the named capture group directive of PreprocessorAnnotationParser.annotationPattern

formula - as matched by the named capture group formula of PreprocessorAnnotationParser.annotationPattern

Returns:

the feature mapping

Throws:

UnparseableFormulaException - if formula is ill-formed.