StringLiteral - This represents a string literal expression, e.g. More...
#include "clang/AST/Expr.h"
Public Member Functions | |
| StringRef | getString () const |
| StringRef | getBytes () const |
| Allow access to clients that need the byte representation, such as ASTWriterStmt::VisitStringLiteral(). | |
| void | outputString (raw_ostream &OS) const |
| uint32_t | getCodeUnit (size_t i) const |
| unsigned | getByteLength () const |
| unsigned | getLength () const |
| unsigned | getCharByteWidth () const |
| StringKind | getKind () const |
| bool | isOrdinary () const |
| bool | isWide () const |
| bool | isUTF8 () const |
| bool | isUTF16 () const |
| bool | isUTF32 () const |
| bool | isPascal () const |
| bool | containsNonAscii () const |
| bool | containsNonAsciiOrNull () const |
| unsigned | getNumConcatenated () const |
| getNumConcatenated - Get the number of string literal tokens that were concatenated in translation phase #6 to form this string literal. | |
| SourceLocation | getStrTokenLoc (unsigned TokNum) const |
| Get one of the string literal token. | |
| SourceLocation | getLocationOfByte (unsigned ByteNo, const SourceManager &SM, const LangOptions &Features, const TargetInfo &Target, unsigned *StartToken=nullptr, unsigned *StartTokenByteOffset=nullptr) const |
| getLocationOfByte - Return a source location that points to the specified byte of this string literal. | |
| tokloc_iterator | tokloc_begin () const |
| tokloc_iterator | tokloc_end () const |
| SourceLocation | getBeginLoc () const LLVM_READONLY |
| SourceLocation | getEndLoc () const LLVM_READONLY |
| child_range | children () |
| const_child_range | children () const |
 Public Member Functions inherited from clang::Expr | |
| Expr ()=delete | |
| Expr (const Expr &)=delete | |
| Expr (Expr &&)=delete | |
| Expr & | operator= (const Expr &)=delete |
| Expr & | operator= (Expr &&)=delete |
| QualType | getType () const |
| void | setType (QualType t) |
| ExprDependence | getDependence () const |
| bool | isValueDependent () const |
| Determines whether the value of this expression depends on. | |
| bool | isTypeDependent () const |
| Determines whether the type of this expression depends on. | |
| bool | isInstantiationDependent () const |
| Whether this expression is instantiation-dependent, meaning that it depends in some way on. | |
| bool | containsUnexpandedParameterPack () const |
| Whether this expression contains an unexpanded parameter pack (for C++11 variadic templates). | |
| bool | containsErrors () const |
| Whether this expression contains subexpressions which had errors, e.g. | |
| SourceLocation | getExprLoc () const LLVM_READONLY |
| getExprLoc - Return the preferred location for the arrow when diagnosing a problem with a generic expression. | |
| bool | isReadIfDiscardedInCPlusPlus11 () const |
| Determine whether an lvalue-to-rvalue conversion should implicitly be applied to this expression if it appears as a discarded-value expression in C++11 onwards. | |
| bool | isUnusedResultAWarning (const Expr *&WarnExpr, SourceLocation &Loc, SourceRange &R1, SourceRange &R2, ASTContext &Ctx) const |
| isUnusedResultAWarning - Return true if this immediate expression should be warned about if the result is unused. | |
| bool | isLValue () const |
| isLValue - True if this expression is an "l-value" according to the rules of the current language. | |
| bool | isPRValue () const |
| bool | isXValue () const |
| bool | isGLValue () const |
| LValueClassification | ClassifyLValue (ASTContext &Ctx) const |
| Reasons why an expression might not be an l-value. | |
| isModifiableLvalueResult | isModifiableLvalue (ASTContext &Ctx, SourceLocation *Loc=nullptr) const |
| isModifiableLvalue - C99 6.3.2.1: an lvalue that does not have array type, does not have an incomplete type, does not have a const-qualified type, and if it is a structure or union, does not have any member (including, recursively, any member or element of all contained aggregates or unions) with a const-qualified type. | |
| Classification | Classify (ASTContext &Ctx) const |
| Classify - Classify this expression according to the C++11 expression taxonomy. | |
| Classification | ClassifyModifiable (ASTContext &Ctx, SourceLocation &Loc) const |
| ClassifyModifiable - Classify this expression according to the C++11 expression taxonomy, and see if it is valid on the left side of an assignment. | |
| FPOptions | getFPFeaturesInEffect (const LangOptions &LO) const |
| Returns the set of floating point options that apply to this expression. | |
| ExprValueKind | getValueKind () const |
| getValueKind - The value kind that this expression produces. | |
| ExprObjectKind | getObjectKind () const |
| getObjectKind - The object kind that this expression produces. | |
| bool | isOrdinaryOrBitFieldObject () const |
| void | setValueKind (ExprValueKind Cat) |
| setValueKind - Set the value kind produced by this expression. | |
| void | setObjectKind (ExprObjectKind Cat) |
| setObjectKind - Set the object kind produced by this expression. | |
| bool | refersToBitField () const |
| Returns true if this expression is a gl-value that potentially refers to a bit-field. | |
| FieldDecl * | getSourceBitField () |
| If this expression refers to a bit-field, retrieve the declaration of that bit-field. | |
| const FieldDecl * | getSourceBitField () const |
| Decl * | getReferencedDeclOfCallee () |
| const Decl * | getReferencedDeclOfCallee () const |
| const ObjCPropertyRefExpr * | getObjCProperty () const |
| If this expression is an l-value for an Objective C property, find the underlying property reference expression. | |
| bool | isObjCSelfExpr () const |
| Check if this expression is the ObjC 'self' implicit parameter. | |
| bool | refersToVectorElement () const |
| Returns whether this expression refers to a vector element. | |
| bool | refersToMatrixElement () const |
| Returns whether this expression refers to a matrix element. | |
| bool | refersToGlobalRegisterVar () const |
| Returns whether this expression refers to a global register variable. | |
| bool | hasPlaceholderType () const |
| Returns whether this expression has a placeholder type. | |
| bool | hasPlaceholderType (BuiltinType::Kind K) const |
| Returns whether this expression has a specific placeholder type. | |
| bool | isKnownToHaveBooleanValue (bool Semantic=true) const |
| isKnownToHaveBooleanValue - Return true if this is an integer expression that is known to return 0 or 1. | |
| bool | isFlexibleArrayMemberLike (ASTContext &Context, LangOptions::StrictFlexArraysLevelKind StrictFlexArraysLevel, bool IgnoreTemplateOrMacroSubstitution=false) const |
| Check whether this array fits the idiom of a flexible array member, depending on the value of -fstrict-flex-array. | |
| std::optional< llvm::APSInt > | getIntegerConstantExpr (const ASTContext &Ctx, SourceLocation *Loc=nullptr, bool isEvaluated=true) const |
| isIntegerConstantExpr - Return the value if this expression is a valid integer constant expression. | |
| bool | isIntegerConstantExpr (const ASTContext &Ctx, SourceLocation *Loc=nullptr) const |
| bool | isCXX98IntegralConstantExpr (const ASTContext &Ctx) const |
| isCXX98IntegralConstantExpr - Return true if this expression is an integral constant expression in C++98. | |
| bool | isCXX11ConstantExpr (const ASTContext &Ctx, APValue *Result=nullptr, SourceLocation *Loc=nullptr) const |
| isCXX11ConstantExpr - Return true if this expression is a constant expression in C++11. | |
| bool | isConstantInitializer (ASTContext &Ctx, bool ForRef, const Expr **Culprit=nullptr) const |
| isConstantInitializer - Returns true if this expression can be emitted to IR as a constant, and thus can be used as a constant initializer in C. | |
| const ValueDecl * | getAsBuiltinConstantDeclRef (const ASTContext &Context) const |
| If this expression is an unambiguous reference to a single declaration, in the style of __builtin_function_start, return that declaration. | |
| bool | EvaluateAsRValue (EvalResult &Result, const ASTContext &Ctx, bool InConstantContext=false) const |
| EvaluateAsRValue - Return true if this is a constant which we can fold to an rvalue using any crazy technique (that has nothing to do with language standards) that we want to, even if the expression has side-effects. | |
| bool | EvaluateAsBooleanCondition (bool &Result, const ASTContext &Ctx, bool InConstantContext=false) const |
| EvaluateAsBooleanCondition - Return true if this is a constant which we can fold and convert to a boolean condition using any crazy technique that we want to, even if the expression has side-effects. | |
| bool | EvaluateAsInt (EvalResult &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects, bool InConstantContext=false) const |
| EvaluateAsInt - Return true if this is a constant which we can fold and convert to an integer, using any crazy technique that we want to. | |
| bool | EvaluateAsFloat (llvm::APFloat &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects, bool InConstantContext=false) const |
| EvaluateAsFloat - Return true if this is a constant which we can fold and convert to a floating point value, using any crazy technique that we want to. | |
| bool | EvaluateAsFixedPoint (EvalResult &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects, bool InConstantContext=false) const |
| EvaluateAsFixedPoint - Return true if this is a constant which we can fold and convert to a fixed point value. | |
| bool | isEvaluatable (const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const |
| isEvaluatable - Call EvaluateAsRValue to see if this expression can be constant folded without side-effects, but discard the result. | |
| bool | HasSideEffects (const ASTContext &Ctx, bool IncludePossibleEffects=true) const |
| HasSideEffects - This routine returns true for all those expressions which have any effect other than producing a value. | |
| bool | hasNonTrivialCall (const ASTContext &Ctx) const |
| Determine whether this expression involves a call to any function that is not trivial. | |
| llvm::APSInt | EvaluateKnownConstInt (const ASTContext &Ctx, SmallVectorImpl< PartialDiagnosticAt > *Diag=nullptr) const |
| EvaluateKnownConstInt - Call EvaluateAsRValue and return the folded integer. | |
| llvm::APSInt | EvaluateKnownConstIntCheckOverflow (const ASTContext &Ctx, SmallVectorImpl< PartialDiagnosticAt > *Diag=nullptr) const |
| void | EvaluateForOverflow (const ASTContext &Ctx) const |
| bool | EvaluateAsLValue (EvalResult &Result, const ASTContext &Ctx, bool InConstantContext=false) const |
| EvaluateAsLValue - Evaluate an expression to see if we can fold it to an lvalue with link time known address, with no side-effects. | |
| bool | EvaluateAsInitializer (APValue &Result, const ASTContext &Ctx, const VarDecl *VD, SmallVectorImpl< PartialDiagnosticAt > &Notes, bool IsConstantInitializer) const |
| EvaluateAsInitializer - Evaluate an expression as if it were the initializer of the given declaration. | |
| bool | EvaluateWithSubstitution (APValue &Value, ASTContext &Ctx, const FunctionDecl *Callee, ArrayRef< const Expr * > Args, const Expr *This=nullptr) const |
| EvaluateWithSubstitution - Evaluate an expression as if from the context of a call to the given function with the given arguments, inside an unevaluated context. | |
| bool | EvaluateAsConstantExpr (EvalResult &Result, const ASTContext &Ctx, ConstantExprKind Kind=ConstantExprKind::Normal) const |
| Evaluate an expression that is required to be a constant expression. | |
| bool | tryEvaluateObjectSize (uint64_t &Result, ASTContext &Ctx, unsigned Type) const |
| If the current Expr is a pointer, this will try to statically determine the number of bytes available where the pointer is pointing. | |
| bool | tryEvaluateStrLen (uint64_t &Result, ASTContext &Ctx) const |
| If the current Expr is a pointer, this will try to statically determine the strlen of the string pointed to. | |
| NullPointerConstantKind | isNullPointerConstant (ASTContext &Ctx, NullPointerConstantValueDependence NPC) const |
| isNullPointerConstant - C99 6.3.2.3p3 - Test if this reduces down to a Null pointer constant. | |
| bool | isOBJCGCCandidate (ASTContext &Ctx) const |
| isOBJCGCCandidate - Return true if this expression may be used in a read/ write barrier. | |
| bool | isBoundMemberFunction (ASTContext &Ctx) const |
| Returns true if this expression is a bound member function. | |
| Expr * | IgnoreUnlessSpelledInSource () |
| Skip past any invisble AST nodes which might surround this statement, such as ExprWithCleanups or ImplicitCastExpr nodes, but also injected CXXMemberExpr and CXXConstructExpr which represent implicit conversions. | |
| const Expr * | IgnoreUnlessSpelledInSource () const |
| Expr * | IgnoreImpCasts () LLVM_READONLY |
| Skip past any implicit casts which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreImpCasts () const |
| Expr * | IgnoreCasts () LLVM_READONLY |
| Skip past any casts which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreCasts () const |
| Expr * | IgnoreImplicit () LLVM_READONLY |
| Skip past any implicit AST nodes which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreImplicit () const |
| Expr * | IgnoreImplicitAsWritten () LLVM_READONLY |
| Skip past any implicit AST nodes which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreImplicitAsWritten () const |
| Expr * | IgnoreParens () LLVM_READONLY |
| Skip past any parentheses which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreParens () const |
| Expr * | IgnoreParenImpCasts () LLVM_READONLY |
| Skip past any parentheses and implicit casts which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreParenImpCasts () const |
| Expr * | IgnoreParenCasts () LLVM_READONLY |
| Skip past any parentheses and casts which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreParenCasts () const |
| Expr * | IgnoreConversionOperatorSingleStep () LLVM_READONLY |
| Skip conversion operators. | |
| const Expr * | IgnoreConversionOperatorSingleStep () const |
| Expr * | IgnoreParenLValueCasts () LLVM_READONLY |
| Skip past any parentheses and lvalue casts which might surround this expression until reaching a fixed point. | |
| const Expr * | IgnoreParenLValueCasts () const |
| Expr * | IgnoreParenNoopCasts (const ASTContext &Ctx) LLVM_READONLY |
| Skip past any parenthese and casts which do not change the value (including ptr->int casts of the same size) until reaching a fixed point. | |
| const Expr * | IgnoreParenNoopCasts (const ASTContext &Ctx) const |
| Expr * | IgnoreParenBaseCasts () LLVM_READONLY |
| Skip past any parentheses and derived-to-base casts until reaching a fixed point. | |
| const Expr * | IgnoreParenBaseCasts () const |
| bool | isDefaultArgument () const |
| Determine whether this expression is a default function argument. | |
| bool | isTemporaryObject (ASTContext &Ctx, const CXXRecordDecl *TempTy) const |
| Determine whether the result of this expression is a temporary object of the given class type. | |
| bool | isImplicitCXXThis () const |
| Whether this expression is an implicit reference to 'this' in C++. | |
| const CXXRecordDecl * | getBestDynamicClassType () const |
| For an expression of class type or pointer to class type, return the most derived class decl the expression is known to refer to. | |
| const Expr * | getBestDynamicClassTypeExpr () const |
| Get the inner expression that determines the best dynamic class. | |
| const Expr * | skipRValueSubobjectAdjustments (SmallVectorImpl< const Expr * > &CommaLHS, SmallVectorImpl< SubobjectAdjustment > &Adjustments) const |
| Walk outwards from an expression we want to bind a reference to and find the expression whose lifetime needs to be extended. | |
| const Expr * | skipRValueSubobjectAdjustments () const |
| Public Member Functions inherited from clang::ValueStmt | |
| const Expr * | getExprStmt () const |
| Expr * | getExprStmt () |
| Public Member Functions inherited from clang::Stmt | |
| void * | operator new (size_t bytes, const ASTContext &C, unsigned alignment=8) |
| void * | operator new (size_t bytes, const ASTContext *C, unsigned alignment=8) |
| void * | operator new (size_t bytes, void *mem) noexcept |
| void | operator delete (void *, const ASTContext &, unsigned) noexcept |
| void | operator delete (void *, const ASTContext *, unsigned) noexcept |
| void | operator delete (void *, size_t) noexcept |
| void | operator delete (void *, void *) noexcept |
| Stmt ()=delete | |
| Stmt (const Stmt &)=delete | |
| Stmt (Stmt &&)=delete | |
| Stmt & | operator= (const Stmt &)=delete |
| Stmt & | operator= (Stmt &&)=delete |
| Stmt (StmtClass SC) | |
| StmtClass | getStmtClass () const |
| const char * | getStmtClassName () const |
| SourceRange | getSourceRange () const LLVM_READONLY |
| SourceLocation tokens are not useful in isolation - they are low level value objects created/interpreted by SourceManager. | |
| SourceLocation | getBeginLoc () const LLVM_READONLY |
| SourceLocation | getEndLoc () const LLVM_READONLY |
| void | dump () const |
Dumps the specified AST fragment and all subtrees to llvm::errs(). | |
| void | dump (raw_ostream &OS, const ASTContext &Context) const |
| int64_t | getID (const ASTContext &Context) const |
| void | dumpColor () const |
| dumpColor - same as dump(), but forces color highlighting. | |
| void | dumpPretty (const ASTContext &Context) const |
| dumpPretty/printPretty - These two methods do a "pretty print" of the AST back to its original source language syntax. | |
| void | printPretty (raw_ostream &OS, PrinterHelper *Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\n", const ASTContext *Context=nullptr) const |
| void | printPrettyControlled (raw_ostream &OS, PrinterHelper *Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\n", const ASTContext *Context=nullptr) const |
| void | printJson (raw_ostream &Out, PrinterHelper *Helper, const PrintingPolicy &Policy, bool AddQuotes) const |
| Pretty-prints in JSON format. | |
| void | viewAST () const |
| viewAST - Visualize an AST rooted at this Stmt* using GraphViz. | |
| Stmt * | IgnoreContainers (bool IgnoreCaptured=false) |
| Skip no-op (attributed, compound) container stmts and skip captured stmt at the top, if IgnoreCaptured is true. | |
| const Stmt * | IgnoreContainers (bool IgnoreCaptured=false) const |
| const Stmt * | stripLabelLikeStatements () const |
| Strip off all label-like statements. | |
| Stmt * | stripLabelLikeStatements () |
| child_range | children () |
| const_child_range | children () const |
| child_iterator | child_begin () |
| child_iterator | child_end () |
| const_child_iterator | child_begin () const |
| const_child_iterator | child_end () const |
| void | Profile (llvm::FoldingSetNodeID &ID, const ASTContext &Context, bool Canonical) const |
| Produce a unique representation of the given statement. | |
| void | ProcessODRHash (llvm::FoldingSetNodeID &ID, ODRHash &Hash) const |
| Calculate a unique representation for a statement that is stable across compiler invocations. | |
Static Public Member Functions | |
| static StringLiteral * | Create (const ASTContext &Ctx, StringRef Str, StringKind Kind, bool Pascal, QualType Ty, const SourceLocation *Loc, unsigned NumConcatenated) |
| This is the "fully general" constructor that allows representation of strings formed from multiple concatenated tokens. | |
| static StringLiteral * | Create (const ASTContext &Ctx, StringRef Str, StringKind Kind, bool Pascal, QualType Ty, SourceLocation Loc) |
| Simple constructor for string literals made from one token. | |
| static StringLiteral * | CreateEmpty (const ASTContext &Ctx, unsigned NumConcatenated, unsigned Length, unsigned CharByteWidth) |
| Construct an empty string literal. | |
| static bool | classof (const Stmt *T) |
| Static Public Member Functions inherited from clang::Expr | |
| static ExprValueKind | getValueKindForType (QualType T) |
| getValueKindForType - Given a formal return or parameter type, give its value kind. | |
| static bool | isPotentialConstantExpr (const FunctionDecl *FD, SmallVectorImpl< PartialDiagnosticAt > &Diags) |
| isPotentialConstantExpr - Return true if this function's definition might be usable in a constant expression in C++11, if it were marked constexpr. | |
| static bool | isPotentialConstantExprUnevaluated (Expr *E, const FunctionDecl *FD, SmallVectorImpl< PartialDiagnosticAt > &Diags) |
| isPotentialConstantExprUnevaluted - Return true if this expression might be usable in a constant expression in C++11 in an unevaluated context, if it were in function FD marked constexpr. | |
| static QualType | findBoundMemberType (const Expr *expr) |
| Given an expression of bound-member type, find the type of the member. | |
| static bool | hasAnyTypeDependentArguments (ArrayRef< Expr * > Exprs) |
| hasAnyTypeDependentArguments - Determines if any of the expressions in Exprs is type-dependent. | |
| static bool | isSameComparisonOperand (const Expr *E1, const Expr *E2) |
| Checks that the two Expr's will refer to the same value as a comparison operand. | |
| static bool | classof (const Stmt *T) |
| Static Public Member Functions inherited from clang::ValueStmt | |
| static bool | classof (const Stmt *T) |
| Static Public Member Functions inherited from clang::Stmt | |
| static void | addStmtClass (const StmtClass s) |
| static void | EnableStatistics () |
| static void | PrintStats () |
| static Likelihood | getLikelihood (ArrayRef< const Attr * > Attrs) |
| static Likelihood | getLikelihood (const Stmt *S) |
| static const Attr * | getLikelihoodAttr (const Stmt *S) |
| static Likelihood | getLikelihood (const Stmt *Then, const Stmt *Else) |
| static std::tuple< bool, const Attr *, const Attr * > | determineLikelihoodConflict (const Stmt *Then, const Stmt *Else) |
Friends | |
| class | ASTStmtReader |
Detailed Description
StringLiteral - This represents a string literal expression, e.g.
"foo" or L"bar" (wide strings). The actual string data can be obtained with getBytes() and is NOT null-terminated. The length of the string data is determined by calling getByteLength().
The C type for a string is always a ConstantArrayType. In C++, the char type is const qualified, in C it is not.
Note that strings in C can be formed by concatenation of multiple string literal pptokens in translation phase #6. This keeps track of the locations of each of these pieces.
Strings in C can also be truncated and extended by assigning into arrays, e.g. with constructs like: char X[2] = "foobar"; In this case, getByteLength() will return 6, but the string literal will have type "char[2]".
Member Typedef Documentation
◆ tokloc_iterator
| typedef const SourceLocation* clang::StringLiteral::tokloc_iterator |
Member Enumeration Documentation
◆ StringKind
StringLiteral is followed by several trailing objects.
They are in order:
- A single unsigned storing the length in characters of this string. The length in bytes is this length times the width of a single character. Always present and stored as a trailing objects because storing it in StringLiteral would increase the size of StringLiteral by sizeof(void *) due to alignment requirements. If you add some data to StringLiteral, consider moving it inside StringLiteral.
- An array of getNumConcatenated() SourceLocation, one for each of the token this string is made of.
- An array of getByteLength() char used to store the string data.
| Enumerator | |
|---|---|
| Ordinary | |
| Wide | |
| UTF8 | |
| UTF16 | |
| UTF32 | |
Member Function Documentation
◆ children() [1/2]
|
inline |
◆ children() [2/2]
|
inline |
◆ classof()
Definition at line 1956 of file Expr.h.
References clang::Stmt::getStmtClass().
◆ containsNonAscii()
|
inline |
Definition at line 1904 of file Expr.h.
References c, getString(), and clang::isASCII().
◆ containsNonAsciiOrNull()
|
inline |
Definition at line 1911 of file Expr.h.
References c, getString(), and clang::isASCII().
◆ Create() [1/2]
|
static |
This is the "fully general" constructor that allows representation of strings formed from multiple concatenated tokens.
Definition at line 1185 of file Expr.cpp.
References clang::ASTContext::Allocate().
Referenced by clang::Sema::ActOnNumericConstant(), clang::Sema::ActOnStringLiteral(), clang::Sema::BuildPredefinedExpr(), Create(), clang::ASTContext::getPredefinedStringLiteralFromCache(), clang::Sema::ParseObjCStringLiteral(), and clang::ASTNodeImporter::VisitStringLiteral().
◆ Create() [2/2]
|
inlinestatic |
◆ CreateEmpty()
|
static |
Construct an empty string literal.
Definition at line 1196 of file Expr.cpp.
References clang::ASTContext::Allocate().
◆ getBeginLoc()
|
inline |
Definition at line 1953 of file Expr.h.
References tokloc_begin().
Referenced by clang::Sema::ActOnPragmaMSSeg(), clang::ODRDiagsEmitter::diagnoseMismatch(), getAsmSrcLocInfo(), and getClobberConflictLocation().
◆ getByteLength()
|
inline |
Definition at line 1889 of file Expr.h.
References getCharByteWidth(), and getLength().
Referenced by getBytes(), and getString().
◆ getBytes()
|
inline |
Allow access to clients that need the byte representation, such as ASTWriterStmt::VisitStringLiteral().
Definition at line 1869 of file Expr.h.
References getByteLength().
Referenced by isIdenticalStmt(), and clang::ASTNodeImporter::VisitStringLiteral().
◆ getCharByteWidth()
|
inline |
Definition at line 1891 of file Expr.h.
References clang::Stmt::StringLiteralBits.
Referenced by getByteLength(), getCodeUnit(), clang::CodeGen::CodeGenModule::GetConstantArrayFromStringLiteral(), and getString().
◆ getCodeUnit()
|
inline |
Definition at line 1876 of file Expr.h.
References getCharByteWidth(), and getLength().
Referenced by clang::Sema::ActOnStringLiteral(), clang::CodeGen::CodeGenModule::GetConstantArrayFromStringLiteral(), and outputString().
◆ getEndLoc()
|
inline |
Definition at line 1954 of file Expr.h.
References tokloc_end().
◆ getKind()
|
inline |
Definition at line 1893 of file Expr.h.
References clang::Stmt::StringLiteralBits.
Referenced by getLocationOfByte(), isOrdinary(), IsStringInit(), isUTF16(), isUTF32(), isUTF8(), isWide(), outputString(), and clang::ASTNodeImporter::VisitStringLiteral().
◆ getLength()
|
inline |
Definition at line 1890 of file Expr.h.
Referenced by clang::Sema::ActOnStringLiteral(), checkFormatStringExpr(), getByteLength(), getCodeUnit(), clang::CodeGen::CodeGenModule::GetConstantArrayFromStringLiteral(), and outputString().
◆ getLocationOfByte()
| SourceLocation StringLiteral::getLocationOfByte | ( | unsigned | ByteNo, |
| const SourceManager & | SM, | ||
| const LangOptions & | Features, | ||
| const TargetInfo & | Target, | ||
| unsigned * | StartToken = nullptr, |
||
| unsigned * | StartTokenByteOffset = nullptr |
||
| ) | const |
getLocationOfByte - Return a source location that points to the specified byte of this string literal.
Strings are amazingly complex. They can be formed from multiple tokens and can have escape sequences in them in addition to the usual trigraph and escaped newline business. This routine handles this complexity.
Strings are amazingly complex. They can be formed from multiple tokens and can have escape sequences in them in addition to the usual trigraph and escaped newline business. This routine handles this complexity.
The *StartToken sets the first token to be searched in this function and the *StartTokenByteOffset is the byte offset of the first token. Before returning, it updates the *StartToken to the TokNo of the token being found and sets *StartTokenByteOffset to the byte offset of the token in the string. Using these two parameters can reduce the time complexity from O(n^2) to O(n) if one wants to get the location of byte for all the tokens in a string.
Definition at line 1314 of file Expr.cpp.
References clang::Lexer::AdvanceToTokenCharacter(), getKind(), getNumConcatenated(), clang::StringLiteralParser::getOffsetOfStringByte(), clang::StringLiteralParser::GetStringLength(), getStrTokenLoc(), clang::Invalid, clang::Lexer::LexFromRawLexer(), Offset, Ordinary, SM, clang::Target, and UTF8.
Referenced by clang::GCCAsmStmt::AnalyzeAsmString(), getAsmSrcLocInfo(), and clang::Sema::getLocationOfStringLiteralByte().
◆ getNumConcatenated()
|
inline |
getNumConcatenated - Get the number of string literal tokens that were concatenated in translation phase #6 to form this string literal.
Definition at line 1920 of file Expr.h.
References clang::Stmt::StringLiteralBits.
Referenced by getLocationOfByte(), getStrTokenLoc(), tokloc_end(), and clang::ASTNodeImporter::VisitStringLiteral().
◆ getString()
|
inline |
Definition at line 1861 of file Expr.h.
References getByteLength(), and getCharByteWidth().
Referenced by clang::Sema::ActOnFunctionDeclarator(), clang::Sema::ActOnPragmaMSInitSeg(), clang::Sema::ActOnPragmaMSSection(), clang::Sema::ActOnPragmaMSSeg(), clang::Sema::ActOnStartLinkageSpecification(), clang::Sema::ActOnVariableDeclarator(), clang::GCCAsmStmt::AnalyzeAsmString(), clang::Sema::CheckCompleteVariableDeclaration(), checkFormatStringExpr(), CheckObjCCollectionLiteralElement(), clang::analyze_os_log::computeOSLogBufferLayout(), containsNonAscii(), containsNonAsciiOrNull(), DiagnoseCStringFormatDirectiveInCFAPI(), DiagnoseCStringFormatDirectiveInObjCAPI(), clang::ODRDiagsEmitter::diagnoseMismatch(), clang::Sema::FormatStringHasSArg(), getAsmSrcLocInfo(), clang::GCCAsmStmt::getClobber(), getClobberConflictLocation(), clang::CodeGen::CodeGenModule::GetConstantArrayFromStringLiteral(), clang::GCCAsmStmt::getInputConstraint(), and clang::GCCAsmStmt::getOutputConstraint().
◆ getStrTokenLoc()
|
inline |
Get one of the string literal token.
Definition at line 1925 of file Expr.h.
References getNumConcatenated().
Referenced by clang::Sema::ActOnFunctionDeclarator(), clang::Sema::ActOnVariableDeclarator(), and getLocationOfByte().
◆ isOrdinary()
|
inline |
Definition at line 1897 of file Expr.h.
References getKind(), and Ordinary.
Referenced by clang::Sema::ActOnGCCAsmStmt(), clang::Sema::ActOnStartLinkageSpecification(), and clang::analyze_os_log::computeOSLogBufferLayout().
◆ isPascal()
|
inline |
Definition at line 1902 of file Expr.h.
References clang::Stmt::StringLiteralBits.
Referenced by clang::ASTNodeImporter::VisitStringLiteral().
◆ isUTF16()
|
inline |
◆ isUTF32()
|
inline |
◆ isUTF8()
|
inline |
Definition at line 1899 of file Expr.h.
References getKind(), and UTF8.
Referenced by clang::analyze_os_log::computeOSLogBufferLayout().
◆ isWide()
|
inline |
◆ outputString()
| void StringLiteral::outputString | ( | raw_ostream & | OS | ) | const |
Definition at line 1207 of file Expr.cpp.
References getCodeUnit(), getKind(), getLength(), clang::isPrintable(), Ordinary, OS, UTF16, UTF32, UTF8, and Wide.
Referenced by clang::JSONNodeDumper::VisitStringLiteral(), and clang::TextNodeDumper::VisitStringLiteral().
◆ tokloc_begin()
|
inline |
Definition at line 1945 of file Expr.h.
Referenced by getBeginLoc(), and clang::ASTNodeImporter::VisitStringLiteral().
◆ tokloc_end()
|
inline |
Definition at line 1949 of file Expr.h.
References getNumConcatenated().
Referenced by getEndLoc(), and clang::ASTNodeImporter::VisitStringLiteral().
Friends And Related Function Documentation
◆ ASTStmtReader
|
friend |
The documentation for this class was generated from the following files:
