clang  16.0.0git
Public Member Functions | Public Attributes | List of all members
clang::PrintingPolicy Struct Reference

Describes how types, statements, expressions, and declarations should be printed. More...

#include "clang/AST/PrettyPrinter.h"

Collaboration diagram for clang::PrintingPolicy:
Collaboration graph
[legend]

Public Member Functions

 PrintingPolicy (const LangOptions &LO)
 Create a default printing policy for the specified language. More...
 
void adjustForCPlusPlus ()
 Adjust this printing policy for cases where it's known that we're printing C++ code (for instance, if AST dumping reaches a C++-only construct). More...
 

Public Attributes

unsigned Indentation: 8
 The number of spaces to use to indent each line. More...
 
unsigned SuppressSpecifiers: 1
 Whether we should suppress printing of the actual specifiers for the given type or declaration. More...
 
unsigned SuppressTagKeyword: 1
 Whether type printing should skip printing the tag keyword. More...
 
unsigned IncludeTagDefinition: 1
 When true, include the body of a tag definition. More...
 
unsigned SuppressScope: 1
 Suppresses printing of scope specifiers. More...
 
unsigned SuppressUnwrittenScope: 1
 Suppress printing parts of scope specifiers that are never written, e.g., for anonymous namespaces. More...
 
unsigned SuppressInlineNamespace: 1
 Suppress printing parts of scope specifiers that correspond to inline namespaces, where the name is unambiguous with the specifier removed. More...
 
unsigned SuppressInitializers: 1
 Suppress printing of variable initializers. More...
 
unsigned ConstantArraySizeAsWritten: 1
 Whether we should print the sizes of constant array expressions as written in the sources. More...
 
unsigned AnonymousTagLocations: 1
 When printing an anonymous tag name, also print the location of that entity (e.g., "enum <anonymous at t.h:10:5>"). More...
 
unsigned SuppressStrongLifetime: 1
 When true, suppress printing of the __strong lifetime qualifier in ARC. More...
 
unsigned SuppressLifetimeQualifiers: 1
 When true, suppress printing of lifetime qualifier in ARC. More...
 
unsigned SuppressTemplateArgsInCXXConstructors: 1
 When true, suppresses printing template arguments in names of C++ constructors. More...
 
unsigned SuppressDefaultTemplateArgs: 1
 When true, attempt to suppress template arguments that match the default argument for the parameter. More...
 
unsigned Bool: 1
 Whether we can use 'bool' rather than '_Bool' (even if the language doesn't actually have 'bool', because, e.g., it is defined as a macro). More...
 
unsigned Nullptr: 1
 Whether we should use 'nullptr' rather than '0' as a null pointer constant. More...
 
unsigned NullptrTypeInNamespace: 1
 Whether 'nullptr_t' is in namespace 'std' or not. More...
 
unsigned Restrict: 1
 Whether we can use 'restrict' rather than '__restrict'. More...
 
unsigned Alignof: 1
 Whether we can use 'alignof' rather than '__alignof'. More...
 
unsigned UnderscoreAlignof: 1
 Whether we can use '_Alignof' rather than '__alignof'. More...
 
unsigned UseVoidForZeroParams: 1
 Whether we should use '(void)' rather than '()' for a function prototype with zero parameters. More...
 
unsigned SplitTemplateClosers: 1
 Whether nested templates must be closed like 'a<b<c> >' rather than 'a<b<c>>'. More...
 
unsigned TerseOutput: 1
 Provide a 'terse' output. More...
 
unsigned PolishForDeclaration: 1
 When true, do certain refinement needed for producing proper declaration tag; such as, do not print attributes attached to the declaration. More...
 
unsigned Half: 1
 When true, print the half-precision floating-point type as 'half' instead of '__fp16'. More...
 
unsigned MSWChar: 1
 When true, print the built-in wchar_t type as __wchar_t. More...
 
unsigned IncludeNewlines: 1
 When true, include newlines after statements like "break", etc. More...
 
unsigned MSVCFormatting: 1
 Use whitespace and punctuation like MSVC does. More...
 
unsigned ConstantsAsWritten: 1
 Whether we should print the constant expressions as written in the sources. More...
 
unsigned SuppressImplicitBase: 1
 When true, don't print the implicit 'self' or 'this' expressions. More...
 
unsigned FullyQualifiedName: 1
 When true, print the fully qualified name of function declarations. More...
 
unsigned PrintCanonicalTypes: 1
 Whether to print types as written or canonically. More...
 
unsigned PrintInjectedClassNameWithArguments: 1
 Whether to print an InjectedClassNameType with template arguments or as written. More...
 
unsigned UsePreferredNames: 1
 Whether to use C++ template preferred_name attributes when printing templates. More...
 
unsigned AlwaysIncludeTypeForTemplateArgument: 1
 Whether to use type suffixes (eg: 1U) on integral non-type template parameters. More...
 
unsigned CleanUglifiedParameters: 1
 Whether to strip underscores when printing reserved parameter names. More...
 
unsigned EntireContentsOfLargeArray: 1
 Whether to print the entire array initializers, especially on non-type template parameters, no matter how many elements there are. More...
 
unsigned UseEnumerators: 1
 Whether to print enumerator non-type template parameters with a matching enumerator name or via cast of an integer. More...
 
const PrintingCallbacksCallbacks = nullptr
 Callbacks to use to allow the behavior of printing to be customized. More...
 

Detailed Description

Describes how types, statements, expressions, and declarations should be printed.

This type is intended to be small and suitable for passing by value. It is very frequently copied.

Definition at line 57 of file PrettyPrinter.h.

Constructor & Destructor Documentation

◆ PrintingPolicy()

clang::PrintingPolicy::PrintingPolicy ( const LangOptions LO)
inline

Create a default printing policy for the specified language.

Definition at line 59 of file PrettyPrinter.h.

Member Function Documentation

◆ adjustForCPlusPlus()

void clang::PrintingPolicy::adjustForCPlusPlus ( )
inline

Adjust this printing policy for cases where it's known that we're printing C++ code (for instance, if AST dumping reaches a C++-only construct).

This should not be used if a real LangOptions object is available.

Definition at line 85 of file PrettyPrinter.h.

References Bool, SuppressTagKeyword, and UseVoidForZeroParams.

Member Data Documentation

◆ Alignof

unsigned clang::PrintingPolicy::Alignof

Whether we can use 'alignof' rather than '__alignof'.

Definition at line 207 of file PrettyPrinter.h.

◆ AlwaysIncludeTypeForTemplateArgument

unsigned clang::PrintingPolicy::AlwaysIncludeTypeForTemplateArgument

Whether to use type suffixes (eg: 1U) on integral non-type template parameters.

Definition at line 287 of file PrettyPrinter.h.

◆ AnonymousTagLocations

unsigned clang::PrintingPolicy::AnonymousTagLocations

When printing an anonymous tag name, also print the location of that entity (e.g., "enum <anonymous at t.h:10:5>").

Otherwise, just prints "(anonymous)" for the name.

Definition at line 176 of file PrettyPrinter.h.

Referenced by clang::diff::SyntaxTree::Impl::Impl().

◆ Bool

unsigned clang::PrintingPolicy::Bool

Whether we can use 'bool' rather than '_Bool' (even if the language doesn't actually have 'bool', because, e.g., it is defined as a macro).

Definition at line 194 of file PrettyPrinter.h.

Referenced by adjustForCPlusPlus().

◆ Callbacks

const PrintingCallbacks* clang::PrintingPolicy::Callbacks = nullptr

Callbacks to use to allow the behavior of printing to be customized.

Definition at line 303 of file PrettyPrinter.h.

◆ CleanUglifiedParameters

unsigned clang::PrintingPolicy::CleanUglifiedParameters

Whether to strip underscores when printing reserved parameter names.

e.g. std::vector<class _Tp> becomes std::vector<class Tp>. This only affects parameter names, and so describes a compatible API.

Definition at line 292 of file PrettyPrinter.h.

◆ ConstantArraySizeAsWritten

unsigned clang::PrintingPolicy::ConstantArraySizeAsWritten

Whether we should print the sizes of constant array expressions as written in the sources.

This flag determines whether array types declared as

int a[4+10*10];
char a[] = "A string";

will be printed as written or as follows:

int a[104];
char a[9] = "A string";

Definition at line 171 of file PrettyPrinter.h.

◆ ConstantsAsWritten

unsigned clang::PrintingPolicy::ConstantsAsWritten

Whether we should print the constant expressions as written in the sources.

This flag determines whether constants expressions like

0x10
2.5e3

will be printed as written or as follows:

0x10
2.5e3

Definition at line 264 of file PrettyPrinter.h.

◆ EntireContentsOfLargeArray

unsigned clang::PrintingPolicy::EntireContentsOfLargeArray

Whether to print the entire array initializers, especially on non-type template parameters, no matter how many elements there are.

Definition at line 296 of file PrettyPrinter.h.

◆ FullyQualifiedName

unsigned clang::PrintingPolicy::FullyQualifiedName

When true, print the fully qualified name of function declarations.

This is the opposite of SuppressScope and thus overrules it.

Definition at line 271 of file PrettyPrinter.h.

◆ Half

unsigned clang::PrintingPolicy::Half

When true, print the half-precision floating-point type as 'half' instead of '__fp16'.

Definition at line 234 of file PrettyPrinter.h.

◆ IncludeNewlines

unsigned clang::PrintingPolicy::IncludeNewlines

When true, include newlines after statements like "break", etc.

Definition at line 241 of file PrettyPrinter.h.

◆ IncludeTagDefinition

unsigned clang::PrintingPolicy::IncludeTagDefinition

When true, include the body of a tag definition.

This is used to place the definition of a struct in the middle of another declaration as with:

typedef struct { int x, y; } Point;

Definition at line 128 of file PrettyPrinter.h.

◆ Indentation

unsigned clang::PrintingPolicy::Indentation

The number of spaces to use to indent each line.

Definition at line 92 of file PrettyPrinter.h.

◆ MSVCFormatting

unsigned clang::PrintingPolicy::MSVCFormatting

Use whitespace and punctuation like MSVC does.

In particular, this prints anonymous namespaces as ‘anonymous namespace’ and does not insert spaces after template arguments.

Definition at line 246 of file PrettyPrinter.h.

◆ MSWChar

unsigned clang::PrintingPolicy::MSWChar

When true, print the built-in wchar_t type as __wchar_t.

For use in Microsoft mode when wchar_t is not available.

Definition at line 238 of file PrettyPrinter.h.

◆ Nullptr

unsigned clang::PrintingPolicy::Nullptr

Whether we should use 'nullptr' rather than '0' as a null pointer constant.

Definition at line 198 of file PrettyPrinter.h.

◆ NullptrTypeInNamespace

unsigned clang::PrintingPolicy::NullptrTypeInNamespace

Whether 'nullptr_t' is in namespace 'std' or not.

Definition at line 201 of file PrettyPrinter.h.

◆ PolishForDeclaration

unsigned clang::PrintingPolicy::PolishForDeclaration

When true, do certain refinement needed for producing proper declaration tag; such as, do not print attributes attached to the declaration.

Definition at line 230 of file PrettyPrinter.h.

◆ PrintCanonicalTypes

unsigned clang::PrintingPolicy::PrintCanonicalTypes

Whether to print types as written or canonically.

Definition at line 274 of file PrettyPrinter.h.

◆ PrintInjectedClassNameWithArguments

unsigned clang::PrintingPolicy::PrintInjectedClassNameWithArguments

Whether to print an InjectedClassNameType with template arguments or as written.

When a template argument is unnamed, printing it results in invalid C++ code.

Definition at line 279 of file PrettyPrinter.h.

◆ Restrict

unsigned clang::PrintingPolicy::Restrict

Whether we can use 'restrict' rather than '__restrict'.

Definition at line 204 of file PrettyPrinter.h.

◆ SplitTemplateClosers

unsigned clang::PrintingPolicy::SplitTemplateClosers

Whether nested templates must be closed like 'a<b<c> >' rather than 'a<b<c>>'.

Definition at line 218 of file PrettyPrinter.h.

◆ SuppressDefaultTemplateArgs

unsigned clang::PrintingPolicy::SuppressDefaultTemplateArgs

When true, attempt to suppress template arguments that match the default argument for the parameter.

Definition at line 190 of file PrettyPrinter.h.

◆ SuppressImplicitBase

unsigned clang::PrintingPolicy::SuppressImplicitBase

When true, don't print the implicit 'self' or 'this' expressions.

Definition at line 267 of file PrettyPrinter.h.

◆ SuppressInitializers

unsigned clang::PrintingPolicy::SuppressInitializers

Suppress printing of variable initializers.

This flag is used when printing the loop variable in a for-range statement. For example, given:

for (auto x : coll)

SuppressInitializers will be true when printing "auto x", so that the internal initializer constructed for x will not be printed.

Definition at line 153 of file PrettyPrinter.h.

◆ SuppressInlineNamespace

unsigned clang::PrintingPolicy::SuppressInlineNamespace

Suppress printing parts of scope specifiers that correspond to inline namespaces, where the name is unambiguous with the specifier removed.

Definition at line 140 of file PrettyPrinter.h.

◆ SuppressLifetimeQualifiers

unsigned clang::PrintingPolicy::SuppressLifetimeQualifiers

When true, suppress printing of lifetime qualifier in ARC.

Definition at line 182 of file PrettyPrinter.h.

Referenced by rewriteToObjCProperty().

◆ SuppressScope

unsigned clang::PrintingPolicy::SuppressScope

Suppresses printing of scope specifiers.

Definition at line 131 of file PrettyPrinter.h.

Referenced by clang::NestedNameSpecifier::print().

◆ SuppressSpecifiers

unsigned clang::PrintingPolicy::SuppressSpecifiers

Whether we should suppress printing of the actual specifiers for the given type or declaration.

This flag is only used when we are printing declarators beyond the first declarator within a declaration group. For example, given:

const int *x, *y;

SuppressSpecifiers will be false when printing the declaration for "x", so that we will print "int *x"; it will be true when we print "y", so that we suppress printing the "const int" type specifier and instead only print the "*y".

Definition at line 108 of file PrettyPrinter.h.

◆ SuppressStrongLifetime

unsigned clang::PrintingPolicy::SuppressStrongLifetime

When true, suppress printing of the __strong lifetime qualifier in ARC.

Definition at line 179 of file PrettyPrinter.h.

Referenced by rewriteToObjCProperty().

◆ SuppressTagKeyword

unsigned clang::PrintingPolicy::SuppressTagKeyword

Whether type printing should skip printing the tag keyword.

This is used when printing the inner type of elaborated types, (as the tag keyword is part of the elaborated type):

struct Geometry::Point;

Definition at line 118 of file PrettyPrinter.h.

Referenced by adjustForCPlusPlus().

◆ SuppressTemplateArgsInCXXConstructors

unsigned clang::PrintingPolicy::SuppressTemplateArgsInCXXConstructors

When true, suppresses printing template arguments in names of C++ constructors.

Definition at line 186 of file PrettyPrinter.h.

◆ SuppressUnwrittenScope

unsigned clang::PrintingPolicy::SuppressUnwrittenScope

Suppress printing parts of scope specifiers that are never written, e.g., for anonymous namespaces.

Definition at line 135 of file PrettyPrinter.h.

◆ TerseOutput

unsigned clang::PrintingPolicy::TerseOutput

Provide a 'terse' output.

For example, in this mode we don't print function bodies, class members, declarations inside namespaces etc. Effectively, this should print only the requested declaration.

Definition at line 225 of file PrettyPrinter.h.

◆ UnderscoreAlignof

unsigned clang::PrintingPolicy::UnderscoreAlignof

Whether we can use '_Alignof' rather than '__alignof'.

Definition at line 210 of file PrettyPrinter.h.

◆ UseEnumerators

unsigned clang::PrintingPolicy::UseEnumerators

Whether to print enumerator non-type template parameters with a matching enumerator name or via cast of an integer.

Definition at line 300 of file PrettyPrinter.h.

◆ UsePreferredNames

unsigned clang::PrintingPolicy::UsePreferredNames

Whether to use C++ template preferred_name attributes when printing templates.

Definition at line 283 of file PrettyPrinter.h.

◆ UseVoidForZeroParams

unsigned clang::PrintingPolicy::UseVoidForZeroParams

Whether we should use '(void)' rather than '()' for a function prototype with zero parameters.

Definition at line 214 of file PrettyPrinter.h.

Referenced by adjustForCPlusPlus().


The documentation for this struct was generated from the following file:
x
IRgen optimization opportunities The common pattern of short x
Definition: README.txt:7