CppDiagnostic

Describes how a preprocessor class behaves under abnormal conditions.

exception cpip.core.CppDiagnostic.ExceptionCppDiagnostic

Exception class for representing CppDiagnostic.

exception cpip.core.CppDiagnostic.ExceptionCppDiagnosticPartialTokenStream

Exception class for representing partial remaining tokens.

exception cpip.core.CppDiagnostic.ExceptionCppDiagnosticUndefined

Exception class for representing undefined behaviour.

class cpip.core.CppDiagnostic.PreprocessDiagnosticKeepGoing

Sub-class that does not raise exceptions.

partialTokenStream(msg, theLoc=None)

Reports when an partial token stream exists (e.g. an unclosed comment).

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

undefined(msg, theLoc=None)

Reports when an ‘undefined’ event happens.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

class cpip.core.CppDiagnostic.PreprocessDiagnosticRaiseOnError

Sub-class that raises an exception on a #’error directive.

error(msg, theLoc=None)

Reports when an error event happens. msg - The main message. theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

class cpip.core.CppDiagnostic.PreprocessDiagnosticStd

Describes how a preprocessor class behaves under abnormal conditions.

debug(msg, theLoc=None)

Reports a debug message.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

error(msg, theLoc=None)

Reports when an error event happens.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

eventList

A list of events in the order that they appear. An event is a pair of strings: (type, message)

handleUnclosedComment(msg, theLoc=None)

Reports when an unclosed comment is seen at EOF.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

implementationDefined(msg, theLoc=None)

Reports when an ‘implementation defined’ event happens.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

isDebug

Whether a call to debug() will result in any log output.

partialTokenStream(msg, theLoc=None)

Reports when an partial token stream exists (e.g. an unclosed comment).

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

undefined(msg, theLoc=None)

Reports when an ‘undefined’ event happens.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

unspecified(msg, theLoc=None)

Reports when unspecified behaviour is happening. For example order of evaluation of ‘#’ and ‘##’.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.

warning(msg, theLoc=None)

Reports when an warning event happens.

msg - The main message, a string.

theLoc - the file locator e.g. FileLocation.FileLineCol. If present it must have: (fileId, lineNum colNum) attributes.