llvm::StringRef Class Reference

StringRef - Represent a constant reference to a string, i.e. More...

#include "llvm/ADT/StringRef.h"

Inheritance diagram for llvm::StringRef:

Collaboration diagram for llvm::StringRef:

Public Types
using	iterator = const char *
using	const_iterator = const char *
using	size_type = size_t

Public Member Functions
Iterators
iterator	begin () const
iterator	end () const
const unsigned char *	bytes_begin () const
const unsigned char *	bytes_end () const
iterator_range< const unsigned char * >	bytes () const
String Operations
const LLVM_NODISCARD char *	data () const
	data - Get a pointer to the start of the string (which may not be null terminated). More...
LLVM_NODISCARD bool	empty () const
	empty - Check if the string is empty. More...
LLVM_NODISCARD size_t	size () const
	size - Get the string size. More...
LLVM_NODISCARD char	front () const
	front - Get the first character in the string. More...
LLVM_NODISCARD char	back () const
	back - Get the last character in the string. More...
template<typename Allocator >
LLVM_NODISCARD StringRef	copy (Allocator &A) const
LLVM_NODISCARD bool	equals (StringRef RHS) const
	equals - Check for string equality, this is more efficient than compare() when the relative ordering of inequal strings isn't needed. More...
LLVM_NODISCARD bool	equals_lower (StringRef RHS) const
	equals_lower - Check for string equality, ignoring case. More...
LLVM_NODISCARD int	compare (StringRef RHS) const
	compare - Compare two strings; the result is -1, 0, or 1 if this string is lexicographically less than, equal to, or greater than the RHS. More...
LLVM_NODISCARD int	compare_lower (StringRef RHS) const
	compare_lower - Compare two strings, ignoring case. More...
LLVM_NODISCARD int	compare_numeric (StringRef RHS) const
	compare_numeric - Compare two strings, treating sequences of digits as numbers. More...
LLVM_NODISCARD unsigned	edit_distance (StringRef Other, bool AllowReplacements=true, unsigned MaxEditDistance=0) const
	Determine the edit distance between this string and another string. More...
LLVM_NODISCARD std::string	str () const
	str - Get the contents as an std::string. More...
LLVM_NODISCARD std::string	lower () const
LLVM_NODISCARD std::string	upper () const
	Convert the given ASCII string to uppercase. More...
Operator Overloads
LLVM_NODISCARD char	operator[] (size_t Index) const
template<typename T >
std::enable_if_t< std::is_same< T, std::string >::value, StringRef > &	operator= (T &&Str)=delete
	Disallow accidental assignment from a temporary std::string. More...
Type Conversions
	operator std::string () const
String Predicates
LLVM_NODISCARD bool	startswith (StringRef Prefix) const
	Check if this string starts with the given Prefix. More...
LLVM_NODISCARD bool	startswith_lower (StringRef Prefix) const
	Check if this string starts with the given Prefix, ignoring case. More...
LLVM_NODISCARD bool	endswith (StringRef Suffix) const
	Check if this string ends with the given Suffix. More...
LLVM_NODISCARD bool	endswith_lower (StringRef Suffix) const
	Check if this string ends with the given Suffix, ignoring case. More...
String Searching
LLVM_NODISCARD size_t	find (char C, size_t From=0) const
	Search for the first character C in the string. More...
LLVM_NODISCARD size_t	find_lower (char C, size_t From=0) const
	Search for the first character C in the string, ignoring case. More...
LLVM_NODISCARD size_t	find_if (function_ref< bool(char)> F, size_t From=0) const
	Search for the first character satisfying the predicate F. More...
LLVM_NODISCARD size_t	find_if_not (function_ref< bool(char)> F, size_t From=0) const
	Search for the first character not satisfying the predicate F. More...
LLVM_NODISCARD size_t	find (StringRef Str, size_t From=0) const
	Search for the first string Str in the string. More...
LLVM_NODISCARD size_t	find_lower (StringRef Str, size_t From=0) const
	Search for the first string Str in the string, ignoring case. More...
LLVM_NODISCARD size_t	rfind (char C, size_t From=npos) const
	Search for the last character C in the string. More...
LLVM_NODISCARD size_t	rfind_lower (char C, size_t From=npos) const
	Search for the last character C in the string, ignoring case. More...
LLVM_NODISCARD size_t	rfind (StringRef Str) const
	Search for the last string Str in the string. More...
LLVM_NODISCARD size_t	rfind_lower (StringRef Str) const
	Search for the last string Str in the string, ignoring case. More...
LLVM_NODISCARD size_t	find_first_of (char C, size_t From=0) const
	Find the first character in the string that is C, or npos if not found. More...
LLVM_NODISCARD size_t	find_first_of (StringRef Chars, size_t From=0) const
	Find the first character in the string that is in Chars, or npos if not found. More...
LLVM_NODISCARD size_t	find_first_not_of (char C, size_t From=0) const
	Find the first character in the string that is not C or npos if not found. More...
LLVM_NODISCARD size_t	find_first_not_of (StringRef Chars, size_t From=0) const
	Find the first character in the string that is not in the string Chars, or npos if not found. More...
LLVM_NODISCARD size_t	find_last_of (char C, size_t From=npos) const
	Find the last character in the string that is C, or npos if not found. More...
LLVM_NODISCARD size_t	find_last_of (StringRef Chars, size_t From=npos) const
	Find the last character in the string that is in C, or npos if not found. More...
LLVM_NODISCARD size_t	find_last_not_of (char C, size_t From=npos) const
	Find the last character in the string that is not C, or npos if not found. More...
LLVM_NODISCARD size_t	find_last_not_of (StringRef Chars, size_t From=npos) const
	Find the last character in the string that is not in Chars, or npos if not found. More...
LLVM_NODISCARD bool	contains (StringRef Other) const
	Return true if the given string is a substring of *this, and false otherwise. More...
LLVM_NODISCARD bool	contains (char C) const
	Return true if the given character is contained in *this, and false otherwise. More...
LLVM_NODISCARD bool	contains_lower (StringRef Other) const
	Return true if the given string is a substring of *this, and false otherwise. More...
LLVM_NODISCARD bool	contains_lower (char C) const
	Return true if the given character is contained in *this, and false otherwise. More...
Helpful Algorithms
LLVM_NODISCARD size_t	count (char C) const
	Return the number of occurrences of C in the string. More...
size_t	count (StringRef Str) const
	Return the number of non-overlapped occurrences of Str in the string. More...
template<typename T >
std::enable_if_t< std::numeric_limits< T >::is_signed, bool >	getAsInteger (unsigned Radix, T &Result) const
	Parse the current string as an integer of the specified radix. More...
template<typename T >
std::enable_if_t<!std::numeric_limits< T >::is_signed, bool >	getAsInteger (unsigned Radix, T &Result) const
template<typename T >
std::enable_if_t< std::numeric_limits< T >::is_signed, bool >	consumeInteger (unsigned Radix, T &Result)
	Parse the current string as an integer of the specified radix. More...
template<typename T >
std::enable_if_t<!std::numeric_limits< T >::is_signed, bool >	consumeInteger (unsigned Radix, T &Result)
bool	getAsInteger (unsigned Radix, APInt &Result) const
	Parse the current string as an integer of the specified Radix, or of an autosensed radix if the Radix given is 0. More...
bool	getAsDouble (double &Result, bool AllowInexact=true) const
	Parse the current string as an IEEE double-precision floating point value. More...
Substring Operations
LLVM_NODISCARD StringRef	substr (size_t Start, size_t N=npos) const
	Return a reference to the substring from [Start, Start + N). More...
LLVM_NODISCARD StringRef	take_front (size_t N=1) const
	Return a StringRef equal to 'this' but with only the first N elements remaining. More...
LLVM_NODISCARD StringRef	take_back (size_t N=1) const
	Return a StringRef equal to 'this' but with only the last N elements remaining. More...
LLVM_NODISCARD StringRef	take_while (function_ref< bool(char)> F) const
	Return the longest prefix of 'this' such that every character in the prefix satisfies the given predicate. More...
LLVM_NODISCARD StringRef	take_until (function_ref< bool(char)> F) const
	Return the longest prefix of 'this' such that no character in the prefix satisfies the given predicate. More...
LLVM_NODISCARD StringRef	drop_front (size_t N=1) const
	Return a StringRef equal to 'this' but with the first N elements dropped. More...
LLVM_NODISCARD StringRef	drop_back (size_t N=1) const
	Return a StringRef equal to 'this' but with the last N elements dropped. More...
LLVM_NODISCARD StringRef	drop_while (function_ref< bool(char)> F) const
	Return a StringRef equal to 'this', but with all characters satisfying the given predicate dropped from the beginning of the string. More...
LLVM_NODISCARD StringRef	drop_until (function_ref< bool(char)> F) const
	Return a StringRef equal to 'this', but with all characters not satisfying the given predicate dropped from the beginning of the string. More...
bool	consume_front (StringRef Prefix)
	Returns true if this StringRef has the given prefix and removes that prefix. More...
bool	consume_back (StringRef Suffix)
	Returns true if this StringRef has the given suffix and removes that suffix. More...
LLVM_NODISCARD StringRef	slice (size_t Start, size_t End) const
	Return a reference to the substring from [Start, End). More...
LLVM_NODISCARD std::pair< StringRef, StringRef >	split (char Separator) const
	Split into two substrings around the first occurrence of a separator character. More...
LLVM_NODISCARD std::pair< StringRef, StringRef >	split (StringRef Separator) const
	Split into two substrings around the first occurrence of a separator string. More...
LLVM_NODISCARD std::pair< StringRef, StringRef >	rsplit (StringRef Separator) const
	Split into two substrings around the last occurrence of a separator string. More...
void	split (SmallVectorImpl< StringRef > &A, StringRef Separator, int MaxSplit=-1, bool KeepEmpty=true) const
	Split into substrings around the occurrences of a separator string. More...
void	split (SmallVectorImpl< StringRef > &A, char Separator, int MaxSplit=-1, bool KeepEmpty=true) const
	Split into substrings around the occurrences of a separator character. More...
LLVM_NODISCARD std::pair< StringRef, StringRef >	rsplit (char Separator) const
	Split into two substrings around the last occurrence of a separator character. More...
LLVM_NODISCARD StringRef	ltrim (char Char) const
	Return string with consecutive Char characters starting from the the left removed. More...
LLVM_NODISCARD StringRef	ltrim (StringRef Chars=" \t\n\v\f\r") const
	Return string with consecutive characters in Chars starting from the left removed. More...
LLVM_NODISCARD StringRef	rtrim (char Char) const
	Return string with consecutive Char characters starting from the right removed. More...
LLVM_NODISCARD StringRef	rtrim (StringRef Chars=" \t\n\v\f\r") const
	Return string with consecutive characters in Chars starting from the right removed. More...
LLVM_NODISCARD StringRef	trim (char Char) const
	Return string with consecutive Char characters starting from the left and right removed. More...
LLVM_NODISCARD StringRef	trim (StringRef Chars=" \t\n\v\f\r") const
	Return string with consecutive characters in Chars starting from the left and right removed. More...

Static Public Attributes
static constexpr size_t	npos = ~size_t(0)

Constructors
	StringRef ()=default
	Construct an empty string ref. More...
	StringRef (std::nullptr_t)=delete
	Disable conversion from nullptr. More...
constexpr	StringRef (const char *Str)
	Construct a string ref from a cstring. More...
constexpr	StringRef (const char *data, size_t length)
	Construct a string ref from a pointer and length. More...
	StringRef (const std::string &Str)
	Construct a string ref from an std::string. More...
static StringRef	withNullAsEmpty (const char *data)

Detailed Description

StringRef - Represent a constant reference to a string, i.e.

a character array and a length, which need not be null terminated.

This class does not own the string data, it is expected to be used in situations where the character data resides in some other buffer, whose lifetime extends past that of the StringRef. For this reason, it is not in general safe to store a StringRef.

Definition at line 57 of file StringRef.h.

Member Typedef Documentation

const_iterator

using llvm::StringRef::const_iterator = const char *

Definition at line 62 of file StringRef.h.

iterator

using llvm::StringRef::iterator = const char *

Definition at line 61 of file StringRef.h.

size_type

using llvm::StringRef::size_type = size_t

Definition at line 63 of file StringRef.h.

Constructor & Destructor Documentation

StringRef() [1/5]

llvm::StringRef::StringRef ( )

default

Construct an empty string ref.

StringRef() [2/5]

llvm::StringRef::StringRef ( std::nullptr_t  )

delete

Disable conversion from nullptr.

This prevents things like if (S == nullptr)

StringRef() [3/5]

constexpr llvm::StringRef::StringRef ( const char *  Str )

inlineconstexpr

Construct a string ref from a cstring.

Definition at line 106 of file StringRef.h.

StringRef() [4/5]

constexpr llvm::StringRef::StringRef ( const char *  data, size_t  length  )

inlineconstexpr

Construct a string ref from a pointer and length.

Definition at line 110 of file StringRef.h.

StringRef() [5/5]

llvm::StringRef::StringRef ( const std::string &  Str )

inline

Construct a string ref from an std::string.

Definition at line 114 of file StringRef.h.

Member Function Documentation

back()

LLVM_NODISCARD char llvm::StringRef::back ( ) const

inline

back - Get the last character in the string.

Definition at line 171 of file StringRef.h.

References assert(), llvm::Data, and llvm::empty().

Referenced by llvm::opt::OptTable::findNearest(), getQualifiedNameIndex(), llvm::ChangeReporter< std::string >::handleIRAfterPass(), llvm::ConstantDataSequential::isCString(), optimizeDoubleFP(), parseDuration(), llvm::Pattern::parsePattern(), and llvm::sampleprof::SampleProfileReaderExtBinaryBase::readStringFromTable().

begin()

iterator llvm::StringRef::begin ( ) const

inline

Definition at line 131 of file StringRef.h.

References llvm::Data.

Referenced by llvm::SmallString< 256 >::append(), llvm::SmallString< 256 >::assign(), llvm::MDString::begin(), chopOneUTF32(), llvm::detail::IEEEFloat::convertFromString(), llvm::convertUTF8ToUTF16String(), decodeUTF8(), llvm::yaml::escape(), llvm::APInt::getBitsNeeded(), llvm::sys::detail::getHostCPUNameForPowerPC(), getHostID(), llvm::object::Archive::Symbol::getName(), llvm::object::Archive::getNumberOfSymbols(), llvm::StringToOffsetTable::GetOrAddStringOffset(), llvm::InstrProfReaderItaniumRemapper< HashTableImpl >::getRecords(), llvm::object::WasmObjectFile::getRelocationTypeName(), llvm::object::XCOFFObjectFile::getRelocationTypeName(), llvm::object::MachOObjectFile::getRelocationTypeName(), llvm::ConstantDataArray::getString(), llvm::TargetLoweringObjectFile::getSymbolWithGlobalValueBase(), llvm::yaml::ScalarNode::getValue(), llvm::TextInstrProfReader::hasFormat(), llvm::pdb::hashStringV2(), llvm::Timer::init(), llvm::TGLexer::Lex(), llvm::pdb::NamedStreamMap::load(), llvm::MIToken::location(), lower(), llvm::sys::fs::make_absolute(), makeAbsolute(), mangleCoveragePath(), llvm::object::MachOUniversalBinary::ObjectForArch::ObjectForArch(), llvm::SmallString< 256 >::operator+=(), llvm::sys::path::const_iterator::operator==(), llvm::sys::path::reverse_iterator::operator==(), llvm::object::Archive::Child::operator==(), llvm::InlineAsm::ConstraintInfo::Parse(), llvm::InlineAsm::ParseConstraints(), parseMaybeMangledName(), llvm::InstrProfReaderItaniumRemapper< HashTableImpl >::reconstituteName(), llvm::sys::path::replace_extension(), llvm::AsmLexer::setBuffer(), llvm::EngineBuilder::setMArch(), llvm::EngineBuilder::setMCPU(), llvm::TimerGroup::setName(), llvm::object::Archive::symbol_begin(), llvm::TGLexer::TGLexer(), and upper().

bytes()

iterator_range<const unsigned char *> llvm::StringRef::bytes ( ) const

inline

Definition at line 141 of file StringRef.h.

References llvm::make_range().

Referenced by llvm::ConstantFoldLoadFromConstPtr(), and llvm::djbHash().

bytes_begin()

const unsigned char* llvm::StringRef::bytes_begin ( ) const

inline

Definition at line 135 of file StringRef.h.

References llvm::sys::path::begin().

Referenced by llvm::object::ELFFile< object::ELF64LE >::base(), llvm::MDString::bytes_begin(), llvm::ConstantDataArray::getString(), loadObj(), llvm::xray::readBinaryFormatHeader(), and llvm::readPGOFuncNameStrings().

bytes_end()

const unsigned char* llvm::StringRef::bytes_end ( ) const

inline

Definition at line 138 of file StringRef.h.

References llvm::sys::path::end().

Referenced by llvm::MDString::bytes_end(), loadObj(), and llvm::readPGOFuncNameStrings().

compare()

LLVM_NODISCARD int llvm::StringRef::compare ( StringRef  RHS ) const

inline

compare - Compare two strings; the result is -1, 0, or 1 if this string is lexicographically less than, equal to, or greater than the RHS.

Definition at line 204 of file StringRef.h.

References llvm::Data, and llvm::min().

Referenced by llvm::FunctionComparator::cmpMem(), llvm::SmallString< 256 >::compare(), compareNames(), llvm::IRSimilarity::isClose(), llvm::operator<(), llvm::operator<=(), llvm::operator>(), and llvm::operator>=().

compare_lower()

int StringRef::compare_lower

(

StringRef

RHS

)

const

compare_lower - Compare two strings, ignoring case.

compare_lower - Compare strings, ignoring case.

Definition at line 38 of file StringRef.cpp.

References ascii_strncasecmp(), and llvm::min().

Referenced by llvm::SmallString< 256 >::compare_lower(), gsiRecordCmp(), and llvm::DetectRoundChange::runOnMachineFunction().

compare_numeric()

int StringRef::compare_numeric

(

StringRef

RHS

)

const

compare_numeric - Compare two strings, treating sequences of digits as numbers.

compare_numeric - Compare strings, handle embedded numbers.

Definition at line 64 of file StringRef.cpp.

References E, I, isDigit(), and llvm::min().

Referenced by llvm::SmallString< 256 >::compare_numeric(), and llvm::LessRecord::operator()().

consume_back()

bool llvm::StringRef::consume_back ( StringRef  Suffix )

inline

Returns true if this StringRef has the given suffix and removes that suffix.

Definition at line 693 of file StringRef.h.

References size().

Referenced by llvm::VFABI::tryDemangleForVFABI().

consume_front()

bool llvm::StringRef::consume_front ( StringRef  Prefix )

inline

Returns true if this StringRef has the given prefix and removes that prefix.

Definition at line 683 of file StringRef.h.

References llvm::cl::Prefix, and startswith().

Referenced by llvm::Annotations::Annotations(), llvm::detail::HelperFunctions::consumeHexStyle(), llvm::Triple::getOSVersion(), parseMagic(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::MCContext::setGenDwarfRootFile(), and llvm::VFABI::tryDemangleForVFABI().

consumeInteger() [1/2]

template<typename T >

std::enable_if_t<std::numeric_limits<T>::is_signed, bool> llvm::StringRef::consumeInteger ( unsigned  Radix, T &  Result  )

inline

Parse the current string as an integer of the specified radix.

If Radix is specified as zero, this does radix autosensing using extended C rules: 0 is octal, 0x is hex, 0b is binary.

If the string does not begin with a number of the specified radix, this returns true to signify the error. The string is considered erroneous if empty or if it overflows T. The portion of the string representing the discovered numeric value is removed from the beginning of the string.

Definition at line 545 of file StringRef.h.

References llvm::consumeSignedInteger(), and T.

Referenced by llvm::formatv_object_base::consumeFieldLayout(), llvm::detail::HelperFunctions::consumeNumHexDigits(), llvm::Pattern::parseNumericSubstitutionBlock(), and llvm::formatv_object_base::parseReplacementItem().

consumeInteger() [2/2]

template<typename T >

std::enable_if_t<!std::numeric_limits<T>::is_signed, bool> llvm::StringRef::consumeInteger ( unsigned  Radix, T &  Result  )

inline

Definition at line 556 of file StringRef.h.

References llvm::consumeUnsignedInteger(), and T.

contains() [1/2]

LLVM_NODISCARD bool llvm::StringRef::contains ( char  C ) const

inline

Return true if the given character is contained in *this, and false otherwise.

Definition at line 470 of file StringRef.h.

contains() [2/2]

LLVM_NODISCARD bool llvm::StringRef::contains ( StringRef  Other ) const

inline

Return true if the given string is a substring of *this, and false otherwise.

Definition at line 465 of file StringRef.h.

References llvm::find(), and Other.

Referenced by llvm::Hexagon_MC::addArchSubtarget(), llvm::object::getNameType(), llvm::object::isDecorated(), and llvm::gsym::operator<<().

contains_lower() [1/2]

LLVM_NODISCARD bool llvm::StringRef::contains_lower ( char  C ) const

inline

Return true if the given character is contained in *this, and false otherwise.

Definition at line 482 of file StringRef.h.

contains_lower() [2/2]

LLVM_NODISCARD bool llvm::StringRef::contains_lower ( StringRef  Other ) const

inline

Return true if the given string is a substring of *this, and false otherwise.

Definition at line 475 of file StringRef.h.

References Other.

copy()

template<typename Allocator >

LLVM_NODISCARD StringRef llvm::StringRef::copy ( Allocator &  A ) const

inline

Definition at line 178 of file StringRef.h.

References llvm::sys::path::begin(), copy, llvm::empty(), llvm::sys::path::end(), and S.

Referenced by llvm::yaml::Document::parseBlockNode().

count() [1/2]

LLVM_NODISCARD size_t llvm::StringRef::count ( char  C ) const

inline

Return the number of occurrences of C in the string.

Definition at line 490 of file StringRef.h.

References llvm::Data, llvm::numbers::e, and i.

Referenced by llvm::SmallString< 256 >::count(), llvm::HexagonInstrInfo::getInlineAsmLength(), locateCStrings(), llvm::yaml::MappingTraits< Argument >::mapping(), and llvm::InlineAsm::ConstraintInfo::Parse().

count() [2/2]

size_t StringRef::count

(

StringRef

Str

)

const

Return the number of non-overlapped occurrences of Str in the string.

count - Return the number of non-overlapped occurrences of

• Str in the string.

Definition at line 367 of file StringRef.cpp.

References llvm::numbers::e, equals(), i, N, size(), and substr().

data()

const LLVM_NODISCARD char* llvm::StringRef::data ( ) const

inline

data - Get a pointer to the start of the string (which may not be null terminated).

Definition at line 152 of file StringRef.h.

References llvm::Data.

Referenced by llvm::SourceMgr::AddIncludeFile(), annotateAllFunctions(), llvm::object::coffnamecpy(), llvm::zlib::compress(), llvm::zlib::crc32(), llvm::jitlink::createLinkGraphFromELFObject(), llvm::X86Operand::CreateToken(), llvm::DWARFDebugPubTable::dump(), llvm::DWARFListTableHeader::dump(), edit_distance(), llvm::DIEAbbrev::Emit(), llvm::BitstreamWriter::emitBlob(), llvm::DWARFYAML::emitDebugAbbrev(), llvm::DWARFYAML::emitDebugLine(), llvm::DWARFYAML::emitDebugStr(), llvm::InstrProfRecordWriterTrait::EmitKey(), llvm::RuntimeDyldImpl::emitSection(), llvm::cl::Option::error(), ExpandResponseFile(), llvm::DWARFListType< RangeListEntry >::extract(), llvm::RuntimeDyldCOFFAArch64::generateRelocationStub(), llvm::RuntimeDyldCOFFX86_64::generateRelocationStub(), llvm::irsymtab::storage::Str::get(), llvm::irsymtab::storage::Range< llvm::irsymtab::storage::Comdat >::get(), llvm::object::ArchiveMemberHeader::getAccessMode(), llvm::DataExtractor::getCStr(), llvm::AsmToken::getEndLoc(), llvm::object::ArchiveMemberHeader::getGID(), llvm::DenseMapInfo< StringRef >::getHashValue(), llvm::HexagonInstrInfo::getInlineAsmLength(), getInstructionID(), llvm::object::ArchiveMemberHeader::getLastModified(), llvm::AsmToken::getLoc(), getMemBufferCopyImpl(), llvm::object::ArchiveMemberHeader::getName(), llvm::GCOVFunction::getName(), llvm::object::Elf_Sym_Impl< ELFT >::getName(), llvm::opt::ArgList::GetOrMakeJoinedArgString(), llvm::object::ArchiveMemberHeader::getRawName(), llvm::SparcTargetLowering::getRegForInlineAsmConstraint(), llvm::PPCTargetLowering::getRegForInlineAsmConstraint(), llvm::TargetLowering::getRegForInlineAsmConstraint(), llvm::RuntimeDyldMachO::getRelocationValueRef(), llvm::object::ELFFile< object::ELF64LE >::getSectionName(), llvm::object::ArchiveMemberHeader::getSize(), llvm::object::ArchiveMemberHeader::getUID(), getUUID(), gsiRecordCmp(), llvm::pdb::hashStringV1(), isAsmComment(), llvm::DeclMapInfo::isEqual(), llvm::DenseMapInfo< StringRef >::isEqual(), isRootFile(), LLVMDITypeGetName(), LLVMGetAsString(), LLVMGetNamedMetadataName(), llvm::VETargetLowering::LowerCustomJumpTableEntry(), llvm::LegalizerHelper::lowerReadWriteRegister(), llvm::remarks::magicToFormat(), llvm::sys::path::native(), llvm::MCJIT::notifyFreeingObject(), llvm::MCJIT::notifyObjectLoaded(), llvm::raw_ostream::operator<<(), llvm::remarks::ParsedStringTable::operator[](), optimizeMemCmpConstantSize(), llvm::remarks::ParsedStringTable::ParsedStringTable(), llvm::remarks::parseFormat(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::Pattern::parsePattern(), parseRD(), parseStrTab(), parseStrTabSize(), parseTypeIdSummaryRecord(), parseVersion(), parseWholeProgramDevirtResolution(), llvm::X86Operand::print(), llvm::BitcodeAnalyzer::printStats(), llvm::RuntimeDyldELF::processRelocationRef(), llvm::irsymtab::readBitcode(), readCoverageMappingData(), llvm::jitlink::readTargetMachineArch(), llvm::Regex::Regex(), llvm::report_fatal_error(), reportError(), transformCallee(), llvm::codeview::TypeServer2Record::TypeServer2Record(), llvm::zlib::uncompress(), llvm::SHA1::update(), llvm::SHA256::update(), llvm::MD5::update(), validateMagicNumber(), llvm::writeFileAtomically(), and llvm::yaml::yaml2archive().

drop_back()

LLVM_NODISCARD StringRef llvm::StringRef::drop_back ( size_t  N = 1 ) const

inline

Return a StringRef equal to 'this' but with the last N elements dropped.

Definition at line 662 of file StringRef.h.

References assert(), N, and llvm::size().

Referenced by llvm::ConstantDataSequential::isCString(), and llvm::yaml::Document::parseBlockNode().

drop_front()

LLVM_NODISCARD StringRef llvm::StringRef::drop_front ( size_t  N = 1 ) const

inline

Return a StringRef equal to 'this' but with the first N elements dropped.

Definition at line 654 of file StringRef.h.

References assert(), N, and llvm::size().

Referenced by llvm::Annotations::Annotations(), llvm::ELFAttrs::attrTypeAsString(), llvm::ELFAttrs::attrTypeFromString(), chopOneUTF32(), llvm::formatv_object_base::consumeFieldLayout(), llvm::consumeSignedInteger(), llvm::getFuncNameWithoutPrefix(), llvm::InstrProfSymtab::getOrigFuncName(), llvm::codeview::getSymbolName(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::formatv_object_base::parseReplacementItem(), parseStrTab(), parseStrTabSize(), parseVersion(), printSourceLine(), llvm::sys::path::remove_dots(), llvm::MCContext::setGenDwarfRootFile(), llvm::formatv_object_base::splitLiteralAndReplacement(), and upgradeLoopTag().

drop_until()

LLVM_NODISCARD StringRef llvm::StringRef::drop_until ( function_ref< bool(char)>  F ) const

inline

Return a StringRef equal to 'this', but with all characters not satisfying the given predicate dropped from the beginning of the string.

Definition at line 677 of file StringRef.h.

References F, and llvm::find_if().

drop_while()

LLVM_NODISCARD StringRef llvm::StringRef::drop_while ( function_ref< bool(char)>  F ) const

inline

Return a StringRef equal to 'this', but with all characters satisfying the given predicate dropped from the beginning of the string.

Definition at line 670 of file StringRef.h.

References F, and llvm::find_if_not().

edit_distance()

unsigned StringRef::edit_distance	(	llvm::StringRef	Other,
		bool	AllowReplacements = true,
		unsigned	MaxEditDistance = 0
	)		const

Determine the edit distance between this string and another string.

Parameters

Other	the string to compare this string against.
AllowReplacements	whether to allow character replacements (change one character into another) as a single operation, rather than as two operations (an insertion and a removal).
MaxEditDistance	If non-zero, the maximum edit distance that this routine is allowed to compute. If the edit distance will exceed that maximum, returns MaxEditDistance+1.

Returns

the minimum number of character insertions, removals, or (if AllowReplacements is true) replacements needed to transform one of the given strings into the other. If zero, the strings are identical.

Definition at line 95 of file StringRef.cpp.

References llvm::ComputeEditDistance(), data(), llvm::makeArrayRef(), Other, and size().

Referenced by llvm::opt::OptTable::findNearest(), and LookupNearestOption().

empty()

LLVM_NODISCARD bool llvm::StringRef::empty ( ) const

inline

empty - Check if the string is empty.

Definition at line 156 of file StringRef.h.

Referenced by llvm::CodeViewContext::addFile(), llvm::InstrProfSymtab::addFuncName(), llvm::analyzeImportedModule(), llvm::Annotations::Annotations(), llvm::DwarfUnit::applySubprogramAttributes(), llvm::DwarfUnit::applySubprogramDefinitionAttributes(), llvm::APSInt::APSInt(), llvm::DICompositeType::buildODRType(), llvm::caseFoldingDjbHash(), llvm::checkDebugInfoMetadata(), chopOneUTF32(), llvm::pdb::PDBFileBuilder::commit(), llvm::DIEHash::computeCUSignature(), computeDefaultCPU(), llvm::ARM::computeDefaultTargetABI(), llvm::RISCVABI::computeTargetABI(), llvm::MipsABIInfo::computeTargetABI(), computeTargetABI(), llvm::ConstantFoldLoadFromConstPtr(), llvm::DwarfUnit::constructTypeDIE(), llvm::formatv_object_base::consumeFieldLayout(), llvm::consumeSignedInteger(), llvm::consumeUnsignedInteger(), llvm::detail::IEEEFloat::convertFromString(), llvm::convertUTF8ToUTF16String(), llvm::vfs::RedirectingFileSystem::create(), llvm::sys::fs::create_directories(), createAArch64MCSubtargetInfo(), createProfileFileNameVar(), llvm::createProfileFileNameVar(), createRISCVMCSubtargetInfo(), llvm::createSanitizerCtorAndInitFunctions(), createSparcMCSubtargetInfo(), llvm::sys::fs::createTemporaryFile(), createVEMCSubtargetInfo(), llvm::X86_MC::createX86MCSubtargetInfo(), llvm::declareSanitizerInitFunction(), decodeBase64StringEntry(), llvm::DWARFUnit::determineStringOffsetsTableContributionDWO(), llvm::gsym::GsymReader::dump(), EatNumber(), emitComments(), EmitGenDwarfAbbrev(), llvm::TargetLoweringObjectFileMachO::emitModuleMetadata(), llvm::ARMTargetStreamer::emitTargetAttributes(), llvm::LocationMetadata::empty(), llvm::cl::Option::error(), llvm::sampleprof::FunctionSamples::findFunctionSamplesAt(), llvm::opt::OptTable::findNearest(), llvm::format_provider< Enum, std::enable_if_t< dwarf::EnumTraits< Enum >::value > >::format(), llvm::format_provider< llvm::json::Value >::format(), llvm::JITSymbolFlags::fromGlobalValue(), llvm::Attribute::get(), llvm::get_threadpool_strategy(), getARClassRegisterMask(), llvm::Triple::getARMCPUForArch(), getAsInteger(), llvm::getAsSignedInteger(), llvm::getAsUnsignedInteger(), GetAutoSenseRadix(), llvm::APInt::getBitsNeeded(), llvm::ContextTrieNode::getChildContext(), llvm::DeclContextTree::getChildDeclContext(), getChompedLineBreaks(), llvm::MCContext::getCOFFSection(), getCommonClassOptions(), llvm::getCPU(), llvm::Function::getDenormalMode(), llvm::MCContext::getELFSection(), llvm::json::Path::Root::getError(), getFeatures(), llvm::coverage::CovMapFunctionRecordV1< IntPtrT >::getFuncName(), llvm::getFuncNameWithoutPrefix(), llvm::object::ArchiveMemberHeader::getGID(), llvm::GlobalValue::getGlobalIdentifier(), getGPUOrDefault(), llvm::TargetLibraryInfoImpl::getLibFunc(), llvm::object::MachOObjectFile::getLibraryShortNameByIndex(), llvm::DICompositeType::getODRTypeIfExists(), getOpEnabled(), getOpRefinementSteps(), llvm::DwarfCompileUnit::getOrCreateCommonBlock(), llvm::getOrCreateSanitizerCtorAndInitFunctions(), llvm::MCContext::getOrCreateSymbol(), getPassNameAndInstanceNum(), getPrettyScopeName(), llvm::MCObjectFileInfo::getPseudoProbeDescSection(), getQualifiedNameIndex(), llvm::InstrProfReaderItaniumRemapper< HashTableImpl >::getRecords(), llvm::SparcTargetLowering::getRegForInlineAsmConstraint(), llvm::TargetLowering::getRegForInlineAsmConstraint(), getSearchPaths(), llvm::M68kMCInstLower::GetSymbolFromOperand(), llvm::TargetLoweringObjectFile::getSymbolWithGlobalValueBase(), llvm::lto::getThinLTOOutputFile(), getUnicodeEncoding(), llvm::MCSymbolXCOFF::getUnqualifiedName(), getUUID(), llvm::yaml::Node::getVerbatimTag(), llvm::TargetLibraryInfoImpl::getWidestVF(), llvm::DWARFVerifier::handleDebugAbbrev(), HandlePrefixedOrGroupedOption(), llvm::sys::path::has_extension(), llvm::sys::path::has_filename(), llvm::sys::path::has_parent_path(), llvm::sys::path::has_relative_path(), llvm::sys::path::has_root_directory(), llvm::sys::path::has_root_name(), llvm::sys::path::has_root_path(), llvm::sys::path::has_stem(), llvm::cl::Option::hasArgStr(), llvm::IntelExpr::hasBaseReg(), llvm::SubtargetFeatures::hasFlag(), llvm::IntelExpr::hasIndexReg(), llvm::MCAsmInfo::hasLinkerPrivateGlobalPrefix(), llvm::IntelExpr::hasOffset(), llvm::MCSymbolXCOFF::hasRename(), llvm::GlobalValue::hasSection(), llvm::X86TargetLowering::hasStackProbeSymbol(), llvm::object::Archive::hasSymbolTable(), llvm::MSP430Subtarget::initializeSubtargetDependencies(), llvm::NVPTXSubtarget::initializeSubtargetDependencies(), llvm::MCSubtargetInfo::InitMCProcessorInfo(), llvm::ELFAttributeParser::integerAttribute(), llvm::sampleprof::SampleContext::isBaseContext(), llvm::SubtargetFeatures::isEnabled(), llvm::TargetLibraryInfoImpl::isFunctionVectorizable(), llvm::AMDGPU::MTBUFFormat::isValidNfmt(), llvm::LoadAndStorePromoter::LoadAndStorePromoter(), loadBinaryFormat(), locateCStrings(), LookupNearestOption(), llvm::FileCollectorBase::markAsSeen(), llvm::sampleprof::FunctionSamples::merge(), llvm::Triple::normalize(), llvm::gsym::operator<<(), llvm::jitlink::operator<<(), optimizeDoubleFP(), llvm::AMDGPULibFunc::parse(), llvm::MachO::PackedVersion::parse32(), llvm::MachO::PackedVersion::parse64(), llvm::PassBuilder::parseAAPipeline(), parseARMArch(), llvm::ARM_MC::ParseARMTriple(), parseCC(), llvm::parseDenormalFPAttribute(), llvm::remarks::ParsedStringTable::ParsedStringTable(), parseDuration(), llvm::formatv_object_base::parseFormatString(), llvm::detail::HelperFunctions::parseNumericPrecision(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::Pattern::parsePattern(), llvm::remarks::YAMLRemarkParser::parseRemark(), llvm::formatv_object_base::parseReplacementItem(), llvm::MCSectionMachO::ParseSectionSpecifier(), parseSubArch(), llvm::Pattern::parseVariable(), llvm::MCExpr::print(), llvm::DiagnosticInfoSampleProfile::print(), llvm::MCInstPrinter::printAnnotation(), llvm::ELFAttributeParser::printAttribute(), printCFI(), PrintCFIEscape(), printDwarfFileDirective(), printFile(), llvm::AMDGPUInstPrinter::printHwreg(), llvm::cl::generic_parser_base::printOptionInfo(), llvm::MCSectionMachO::PrintSwitchToSection(), printSymbolizedStackTrace(), llvm::AttributeImpl::Profile(), llvm::SampleContextTracker::promoteMergeContextSamplesTree(), llvm::pruneCache(), llvm::SymbolRemappingReader::read(), llvm::irsymtab::readBitcode(), llvm::GCOVFile::readGCNO(), llvm::TextInstrProfReader::readNextRecord(), llvm::sampleprof::SampleProfileReaderExtBinaryBase::readStringFromTable(), llvm::LessRecordRegister::RecordParts::RecordParts(), registerPartialPipelineCallback(), llvm::sys::path::remove_dots(), llvm::sys::path::replace_path_prefix(), llvm::ThinLTOCodeGenerator::run(), runOnFunction(), sanitizeFunctionName(), llvm::Hexagon_MC::selectHexagonCPU(), selectM68kCPU(), llvm::MIPS_MC::selectMipsCPU(), llvm::EngineBuilder::selectTarget(), llvm::codegen::setFunctionAttributes(), llvm::MCContext::setGenDwarfRootFile(), llvm::lto::setupStatsFile(), llvm::VFABI::setVectorVariantNames(), shouldAlwaysEmitCompleteClassType(), shouldPrintOption(), llvm::AMDGPU::SIModeRegisterDefaults::SIModeRegisterDefaults(), split(), llvm::formatv_object_base::splitLiteralAndReplacement(), llvm::ELFAttributeParser::stringAttribute(), StripTypeNames(), llvm::Regex::sub(), llvm::InlineAdvisorAnalysis::Result::tryCreate(), llvm::VFABI::tryDemangleForVFABI(), llvm::MCDwarfLineTableHeader::tryGetFile(), llvm::UpgradeAttributes(), UsesVectorABI(), llvm::InlineAsm::Verify(), and llvm::ThinLTOCodeGenerator::writeGeneratedObject().

end()

iterator llvm::StringRef::end ( ) const

inline

Definition at line 133 of file StringRef.h.

References llvm::Data.

Referenced by llvm::SmallString< 256 >::append(), llvm::SmallString< 256 >::assign(), chopOneUTF32(), llvm::convertUTF8ToUTF16String(), llvm::MDString::end(), endswith_lower(), llvm::yaml::escape(), llvm::sys::detail::getHostCPUNameForPowerPC(), getHostID(), llvm::StringToOffsetTable::GetOrAddStringOffset(), llvm::InstrProfReaderItaniumRemapper< HashTableImpl >::getRecords(), llvm::SparcTargetLowering::getRegForInlineAsmConstraint(), llvm::TargetLowering::getRegForInlineAsmConstraint(), llvm::object::WasmObjectFile::getRelocationTypeName(), llvm::object::XCOFFObjectFile::getRelocationTypeName(), llvm::object::MachOObjectFile::getRelocationTypeName(), llvm::ConstantDataArray::getString(), llvm::TargetLoweringObjectFile::getSymbolWithGlobalValueBase(), llvm::pdb::hashStringV2(), llvm::Timer::init(), llvm::AsmLexer::LexToken(), llvm::AsmLexer::LexUntilEndOfStatement(), llvm::pdb::NamedStreamMap::load(), lower(), llvm::sys::fs::make_absolute(), mangleCoveragePath(), llvm::SmallString< 256 >::operator+=(), llvm::InlineAsm::ConstraintInfo::Parse(), llvm::InlineAsm::ParseConstraints(), parseMaybeMangledName(), parseRD(), parseRegisterNumber(), llvm::InstrProfReaderItaniumRemapper< HashTableImpl >::reconstituteName(), llvm::Regex::Regex(), llvm::sys::path::replace_extension(), llvm::EngineBuilder::setMArch(), llvm::EngineBuilder::setMCPU(), llvm::TimerGroup::setName(), and upper().

endswith()

LLVM_NODISCARD bool llvm::StringRef::endswith ( StringRef  Suffix ) const

inline

Check if this string ends with the given Suffix.

Definition at line 300 of file StringRef.h.

References llvm::sys::path::end().

Referenced by llvm::analyzeImportedModule(), dumpTypeTagName(), llvm::StringSwitch< T, R >::EndsWith(), llvm::SmallString< 256 >::endswith(), llvm::sys::detail::getHostCPUNameForARM(), llvm::opt::ArgList::GetOrMakeJoinedArgString(), llvm::AMDGPU::IsaInfo::getTargetIDSettingFromFeatureString(), llvm::vfs::RedirectingFileSystem::makeAbsolute(), llvm::parseAnalysisUtilityPasses(), llvm::ARM::parseArchEndian(), and parseSubArch().

endswith_lower()

bool StringRef::endswith_lower

(

StringRef

Suffix

)

const

Check if this string ends with the given Suffix, ignoring case.

Definition at line 53 of file StringRef.cpp.

References ascii_strncasecmp(), and end().

Referenced by llvm::StringSwitch< T, R >::EndsWithLower().

equals()

LLVM_NODISCARD bool llvm::StringRef::equals ( StringRef  RHS ) const

inline

equals - Check for string equality, this is more efficient than compare() when the relative ordering of inequal strings isn't needed.

Definition at line 190 of file StringRef.h.

References llvm::Data.

Referenced by count(), llvm::Hexagon_MC::createHexagonMCSubtargetInfo(), llvm::SmallString< 256 >::equals(), foldFPToIntToFP(), llvm::Triple::getARMCPUForArch(), llvm::BasicBlock::getIrrLoopHeaderWeight(), getSummaryFromMD(), getValMD(), isCaseSensitivePath(), isKeyValuePair(), isSmallDataSection(), isTraversalComponent(), makeStatepointExplicitImpl(), llvm::operator==(), llvm::CodeGenCoverage::parse(), parseBPFArch(), llvm::MIRParserImpl::parseRegisterInfo(), llvm::json::Path::Root::printErrorContext(), and rfind().

equals_lower()

LLVM_NODISCARD bool llvm::StringRef::equals_lower ( StringRef  RHS ) const

inline

equals_lower - Check for string equality, ignoring case.

Definition at line 197 of file StringRef.h.

Referenced by llvm::AArch64FunctionInfo::AArch64FunctionInfo(), llvm::StringSwitch< T, R >::CaseLower(), createX86MCAsmInfo(), llvm::SmallString< 256 >::equals_lower(), llvm::HexagonMCInstrInfo::isOrderedDuplexPair(), llvm::TextInstrProfReader::readHeader(), and rfind_lower().

find() [1/2]

LLVM_NODISCARD size_t llvm::StringRef::find ( char  C, size_t  From = 0  ) const

inline

Search for the first character C in the string.

Returns

The index of the first occurrence of C, or npos if not found.

Definition at line 318 of file StringRef.h.

References llvm::Data, From, llvm::min(), and P.

Referenced by checkLinkerOptCommand(), CommaSeparateAndAddOccurrence(), emitComments(), llvm::RuntimeDyldCheckerExprEval::evaluate(), llvm::SmallString< 256 >::find(), llvm::getConstantStringInfo(), llvm::object::ArchiveMemberHeader::getRawName(), llvm::yaml::ScalarNode::getValue(), llvm::AMDGPU::HSAMD::MetadataStreamerV3::getValueKind(), llvm::ConstantDataSequential::isCString(), isSmallDataSection(), llvm::isSpecialPass(), ParseLine(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::Pattern::parsePattern(), printSourceLine(), printSymbolizedStackTrace(), sanitizeFunctionName(), and llvm::elfabi::terminatedSubstr().

find() [2/2]

size_t StringRef::find	(	StringRef	Str,
		size_t	From = 0
	)		const

Search for the first string Str in the string.

find - Search for the first string

Returns

The index of the first occurrence of Str, or npos if not found.

• Str in the string.

Returns

- The index of the first occurrence of

• Str, or npos if not found.

Definition at line 127 of file StringRef.cpp.

References From, and npos.

find_first_not_of() [1/2]

StringRef::size_type StringRef::find_first_not_of	(	char	C,
		size_t	From = 0
	)		const

Find the first character in the string that is not C or npos if not found.

find_first_not_of - Find the first character in the string that is not

• C or npos if not found.

Definition at line 244 of file StringRef.cpp.

References llvm::numbers::e, From, i, llvm::min(), and npos.

Referenced by llvm::SmallString< 256 >::find_first_not_of(), ParseLine(), and llvm::Regex::sub().

find_first_not_of() [2/2]

StringRef::size_type StringRef::find_first_not_of	(	StringRef	Chars,
		size_t	From = 0
	)		const

Find the first character in the string that is not in the string Chars, or npos if not found.

find_first_not_of - Find the first character in the string that is not in the string

Complexity: O(size() + Chars.size())

• Chars, or npos if not found.

Note: O(size() + Chars.size())

Definition at line 255 of file StringRef.cpp.

References llvm::numbers::e, From, i, llvm::min(), npos, and size().

find_first_of() [1/2]

LLVM_NODISCARD size_t llvm::StringRef::find_first_of ( char  C, size_t  From = 0  ) const

inline

Find the first character in the string that is C, or npos if not found.

Same as find.

Definition at line 413 of file StringRef.h.

References llvm::find(), and From.

Referenced by llvm::SmallString< 256 >::find_first_of(), llvm::InstrProfSymtab::getOrigFuncName(), llvm::yaml::ScalarNode::getValue(), llvm::Regex::isLiteralERE(), locateCStrings(), ParseLine(), llvm::sys::path::remove_dots(), and llvm::formatv_object_base::splitLiteralAndReplacement().

find_first_of() [2/2]

StringRef::size_type StringRef::find_first_of	(	StringRef	Chars,
		size_t	From = 0
	)		const

Find the first character in the string that is in Chars, or npos if not found.

find_first_of - Find the first character in the string that is in

Complexity: O(size() + Chars.size())

• Chars, or npos if not found.

Note: O(size() + Chars.size())

Definition at line 230 of file StringRef.cpp.

References llvm::numbers::e, From, i, llvm::min(), npos, and size().

find_if()

LLVM_NODISCARD size_t llvm::StringRef::find_if ( function_ref< bool(char)>  F, size_t  From = 0  ) const

inline

Search for the first character satisfying the predicate F.

Returns

The index of the first character satisfying F starting from From, or npos if not found.

Definition at line 340 of file StringRef.h.

References F, From, S, and llvm::size().

Referenced by find_lower().

find_if_not()

LLVM_NODISCARD size_t llvm::StringRef::find_if_not ( function_ref< bool(char)>  F, size_t  From = 0  ) const

inline

Search for the first character not satisfying the predicate F.

Returns

The index of the first character not satisfying F starting from From, or npos if not found.

Definition at line 355 of file StringRef.h.

References c, F, llvm::find_if(), and From.

find_last_not_of() [1/2]

StringRef::size_type StringRef::find_last_not_of	(	char	C,
		size_t	From = npos
	)		const

Find the last character in the string that is not C, or npos if not found.

find_last_not_of - Find the last character in the string that is not

• C, or npos if not found.

Definition at line 285 of file StringRef.cpp.

References llvm::numbers::e, From, i, llvm::min(), and npos.

find_last_not_of() [2/2]

StringRef::size_type StringRef::find_last_not_of	(	StringRef	Chars,
		size_t	From = npos
	)		const

Find the last character in the string that is not in Chars, or npos if not found.

find_last_not_of - Find the last character in the string that is not in

Complexity: O(size() + Chars.size())

• Chars, or npos if not found.

Note: O(size() + Chars.size())

Definition at line 296 of file StringRef.cpp.

References llvm::numbers::e, From, i, llvm::min(), npos, and size().

find_last_of() [1/2]

LLVM_NODISCARD size_t llvm::StringRef::find_last_of ( char  C, size_t  From = npos  ) const

inline

Find the last character in the string that is C, or npos if not found.

Definition at line 439 of file StringRef.h.

References From.

Referenced by llvm::sys::path::extension(), llvm::SmallString< 256 >::find_last_of(), llvm::SourceMgr::getLineAndColumn(), llvm::yaml::Node::getVerbatimTag(), ParseLine(), and llvm::sys::path::stem().

find_last_of() [2/2]

StringRef::size_type StringRef::find_last_of	(	StringRef	Chars,
		size_t	From = npos
	)		const

Find the last character in the string that is in C, or npos if not found.

find_last_of - Find the last character in the string that is in

Complexity: O(size() + Chars.size())

• C, or npos if not found.

Note: O(size() + Chars.size())

Definition at line 271 of file StringRef.cpp.

References llvm::numbers::e, From, i, llvm::min(), npos, and size().

find_lower() [1/2]

size_t StringRef::find_lower	(	char	C,
		size_t	From = 0
	)		const

Search for the first character C in the string, ignoring case.

Returns

The index of the first occurrence of C, or npos if not found.

Definition at line 58 of file StringRef.cpp.

References D, find_if(), and From.

find_lower() [2/2]

size_t StringRef::find_lower	(	StringRef	Str,
		size_t	From = 0
	)		const

Search for the first string Str in the string, ignoring case.

Returns

The index of the first occurrence of Str, or npos if not found.

Definition at line 176 of file StringRef.cpp.

References From, npos, size(), substr(), and This.

front()

LLVM_NODISCARD char llvm::StringRef::front ( ) const

inline

front - Get the first character in the string.

Definition at line 164 of file StringRef.h.

References assert(), llvm::Data, and llvm::empty().

Referenced by llvm::Annotations::Annotations(), llvm::consumeSignedInteger(), llvm::JITSymbolFlags::fromGlobalValue(), getAsInteger(), getQualifiedNameIndex(), llvm::PassBuilder::parsePassPipeline(), llvm::formatv_object_base::parseReplacementItem(), llvm::sys::path::remove_dots(), llvm::MCContext::setGenDwarfRootFile(), and llvm::formatv_object_base::splitLiteralAndReplacement().

getAsDouble()

bool StringRef::getAsDouble	(	double &	Result,
		bool	AllowInexact = true
	)		const

Parse the current string as an IEEE double-precision floating point value.

The string must be a well-formed double.

If AllowInexact is false, the function will fail if the string cannot be represented exactly. Otherwise, the function only fails in case of an overflow or underflow, or an invalid floating point representation.

Definition at line 583 of file StringRef.cpp.

References llvm::errorToBool(), F, llvm::APFloatBase::opInexact, llvm::APFloatBase::opOK, and llvm::APFloatBase::rmNearestTiesToEven.

getAsInteger() [1/3]

bool StringRef::getAsInteger	(	unsigned	Radix,
		APInt &	Result
	)		const

Parse the current string as an integer of the specified Radix, or of an autosensed radix if the Radix given is 0.

The current value in Result is discarded, and the storage is changed to be wide enough to store the parsed integer.

Returns

true if the string does not solely consist of a valid non-empty number in the appropriate base.

APInt::fromString is superficially similar but assumes the string is well-formed in the given radix.

Definition at line 508 of file StringRef.cpp.

References assert(), llvm::BitWidth, empty(), front(), GetAutoSenseRadix(), size(), and substr().

getAsInteger() [2/3]

template<typename T >

std::enable_if_t<std::numeric_limits<T>::is_signed, bool> llvm::StringRef::getAsInteger ( unsigned  Radix, T &  Result  ) const

inline

Parse the current string as an integer of the specified radix.

If Radix is specified as zero, this does radix autosensing using extended C rules: 0 is octal, 0x is hex, 0b is binary.

If the string is invalid or if only a subset of the string is valid, this returns true to signify the error. The string is considered erroneous if empty or if it overflows T.

Definition at line 511 of file StringRef.h.

References llvm::getAsSignedInteger(), and T.

Referenced by adjustCallerStackProbeSize(), adjustMinLegalVectorWidth(), llvm::format_provider< llvm::json::Value >::format(), llvm::get_threadpool_strategy(), llvm::object::ArchiveMemberHeader::getAccessMode(), llvm::object::ArchiveMemberHeader::getGID(), llvm::AMDGPU::getIntegerAttribute(), llvm::object::ArchiveMemberHeader::getLastModified(), getPassNameAndInstanceNum(), llvm::SITargetLowering::getRegForInlineAsmConstraint(), getRegNum(), llvm::object::ArchiveMemberHeader::getSize(), llvm::SystemZTargetLowering::getStackProbeSize(), llvm::PPCTargetLowering::getStackProbeSize(), llvm::X86TargetLowering::getStackProbeSize(), llvm::X86TargetMachine::getSubtargetImpl(), llvm::AMDGPU::Exp::getTgtId(), llvm::yaml::isInteger(), llvm::vfs::RedirectingFileSystemParser::parse(), llvm::parseCachePruningPolicy(), parseDuration(), ParseHead(), ParseLine(), parseMetadata(), llvm::detail::HelperFunctions::parseNumericPrecision(), parseRegisterNumber(), parseSectionFlags(), llvm::MCSectionMachO::ParseSectionSpecifier(), llvm::parseStatepointDirectivesFromAttrs(), llvm::StackProtector::runOnFunction(), and llvm::writeArchiveToStream().

getAsInteger() [3/3]

template<typename T >

std::enable_if_t<!std::numeric_limits<T>::is_signed, bool> llvm::StringRef::getAsInteger ( unsigned  Radix, T &  Result  ) const

inline

Definition at line 522 of file StringRef.h.

References llvm::getAsUnsignedInteger(), and T.

lower()

std::string StringRef::lower

(

)

const

Definition at line 108 of file StringRef.cpp.

References begin(), end(), and llvm::map_iterator().

Referenced by llvm::ARMCondCodeFromString(), llvm::ARMVectorCondCodeFromString(), llvm::MipsTargetAsmStreamer::emitDirectiveCpAdd(), llvm::MipsTargetAsmStreamer::emitDirectiveCpLoad(), llvm::MipsTargetAsmStreamer::emitDirectiveCpLocal(), llvm::MipsTargetAsmStreamer::emitDirectiveCpsetup(), llvm::MipsTargetAsmStreamer::emitFrame(), llvm::SparcTargetAsmStreamer::emitSparcRegisterIgnore(), llvm::SparcTargetAsmStreamer::emitSparcRegisterScratch(), llvm::VETargetAsmStreamer::emitVERegisterIgnore(), llvm::VETargetAsmStreamer::emitVERegisterScratch(), getBankedRegisterMask(), llvm::RISCVTargetLowering::getRegForInlineAsmConstraint(), getRegisterName(), llvm::ELFAttributeParser::parseSubsection(), llvm::MIPrinter::print(), llvm::MipsAsmPrinter::printOperand(), llvm::printRegClassOrBank(), llvm::SparcInstPrinter::printRegName(), llvm::ARCInstPrinter::printRegName(), llvm::XCoreInstPrinter::printRegName(), llvm::LanaiInstPrinter::printRegName(), and llvm::MipsInstPrinter::printRegName().

ltrim() [1/2]

LLVM_NODISCARD StringRef llvm::StringRef::ltrim ( char  Char ) const

inline

Return string with consecutive Char characters starting from the the left removed.

Definition at line 823 of file StringRef.h.

References llvm::min().

Referenced by llvm::RuntimeDyldCheckerExprEval::evaluate(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::SymbolRemappingReader::read(), and llvm::VFABI::tryDemangleForVFABI().

ltrim() [2/2]

LLVM_NODISCARD StringRef llvm::StringRef::ltrim ( StringRef  Chars = " \t\n\v\f\r" ) const

inline

Return string with consecutive characters in Chars starting from the left removed.

Definition at line 830 of file StringRef.h.

References llvm::min().

operator std::string()

llvm::StringRef::operator std::string ( ) const

inlineexplicit

Definition at line 275 of file StringRef.h.

operator=()

template<typename T >

std::enable_if_t<std::is_same<T, std::string>::value, StringRef>& llvm::StringRef::operator= ( T &&  Str )

delete

Disallow accidental assignment from a temporary std::string.

The declaration here is extra complicated so that stringRef = {} and stringRef = "abc" continue to select the move assignment operator.

operator[]()

LLVM_NODISCARD char llvm::StringRef::operator[] ( size_t  Index ) const

inline

Definition at line 258 of file StringRef.h.

References assert(), llvm::Data, and Index.

rfind() [1/2]

LLVM_NODISCARD size_t llvm::StringRef::rfind ( char  C, size_t  From = npos  ) const

inline

Search for the last character C in the string.

Returns

The index of the last occurrence of C, or npos if not found.

Definition at line 378 of file StringRef.h.

References llvm::Data, From, i, and llvm::min().

Referenced by llvm::sampleprof::FunctionSamples::getCanonicalFnName(), llvm::object::MachOObjectFile::guessLibraryShortName(), ParseHead(), llvm::SmallString< 256 >::rfind(), and splitUstar().

rfind() [2/2]

size_t StringRef::rfind

(

StringRef

Str

)

const

Search for the last string Str in the string.

rfind - Search for the last string

Returns

The index of the last occurrence of Str, or npos if not found.

• Str in the string.

Returns

- The index of the last occurrence of

• Str, or npos if not found.

Definition at line 202 of file StringRef.cpp.

References llvm::numbers::e, equals(), i, N, npos, size(), and substr().

rfind_lower() [1/2]

size_t StringRef::rfind_lower	(	char	C,
		size_t	From = npos
	)		const

Search for the last character C in the string, ignoring case.

Returns

The index of the last occurrence of C, or npos if not found.

Definition at line 187 of file StringRef.cpp.

References From, i, llvm::min(), and npos.

rfind_lower() [2/2]

size_t StringRef::rfind_lower

(

StringRef

Str

)

const

Search for the last string Str in the string, ignoring case.

Returns

The index of the last occurrence of Str, or npos if not found.

Definition at line 214 of file StringRef.cpp.

References llvm::numbers::e, equals_lower(), i, N, npos, size(), and substr().

rsplit() [1/2]

LLVM_NODISCARD std::pair<StringRef, StringRef> llvm::StringRef::rsplit ( char  Separator ) const

inline

Split into two substrings around the last occurrence of a separator character.

If Separator is in the string, then the result is a pair (LHS, RHS) such that (*this == LHS + Separator + RHS) is true and RHS is minimal. If Separator is not in the string, then the result is a pair (LHS, RHS) where (*this == LHS) and (RHS == "").

Parameters

Separator

- The character to split on.

Returns

- The split substrings.

Definition at line 816 of file StringRef.h.

rsplit() [2/2]

LLVM_NODISCARD std::pair<StringRef, StringRef> llvm::StringRef::rsplit ( StringRef  Separator ) const

inline

Split into two substrings around the last occurrence of a separator string.

If Separator is in the string, then the result is a pair (LHS, RHS) such that (*this == LHS + Separator + RHS) is true and RHS is minimal. If Separator is not in the string, then the result is a pair (LHS, RHS) where (*this == LHS) and (RHS == "").

Parameters

Separator

- The string to split on.

Returns

- The split substrings.

Definition at line 763 of file StringRef.h.

References size().

rtrim() [1/2]

LLVM_NODISCARD StringRef llvm::StringRef::rtrim ( char  Char ) const

inline

Return string with consecutive Char characters starting from the right removed.

Definition at line 837 of file StringRef.h.

References llvm::min().

Referenced by llvm::RuntimeDyldCheckerExprEval::evaluate(), llvm::object::ArchiveMemberHeader::getAccessMode(), llvm::object::ArchiveMemberHeader::getGID(), llvm::object::ArchiveMemberHeader::getLastModified(), llvm::object::ArchiveMemberHeader::getRawLastModified(), llvm::object::ArchiveMemberHeader::getSize(), llvm::object::ArchiveMemberHeader::getUID(), llvm::Pattern::parseNumericSubstitutionBlock(), and trim().

rtrim() [2/2]

LLVM_NODISCARD StringRef llvm::StringRef::rtrim ( StringRef  Chars = " \t\n\v\f\r" ) const

inline

Return string with consecutive characters in Chars starting from the right removed.

Definition at line 844 of file StringRef.h.

References llvm::min().

size()

LLVM_NODISCARD size_t llvm::StringRef::size ( ) const

inline

size - Get the string size.

Definition at line 160 of file StringRef.h.

Referenced by llvm::Hexagon_MC::addArchSubtarget(), angleBracketString(), llvm::Annotations::Annotations(), llvm::APSInt::APSInt(), argPlusPrefixesSize(), argPrefix(), llvm::RuntimeDyldCheckerImpl::checkAllRulesInBuffer(), checkArchVersion(), llvm::FunctionComparator::cmpMem(), llvm::object::coffnamecpy(), llvm::sys::unicode::columnWidthUTF8(), llvm::zlib::compress(), computeStringTable(), llvm::ConstantFoldLoadFromConstPtr(), consume_back(), llvm::formatv_object_base::consumeFieldLayout(), llvm::consumeUnsignedInteger(), llvm::detail::IEEEFloat::convertFromString(), llvm::convertUTF8ToUTF16String(), count(), llvm::zlib::crc32(), llvm::StringMapEntry< llvm::Comdat >::Create(), llvm::jitlink::createLinkGraphFromELFObject(), llvm::X86Operand::CreateToken(), decodeBase64StringEntry(), llvm::DWARFUnit::determineStringOffsetsTableContributionDWO(), dumpStringOffsetsSection(), dumpTypeTagName(), edit_distance(), llvm::BitstreamWriter::emitBlob(), llvm::DwarfStreamer::emitCIE(), llvm::DWARFYAML::emitDebugAbbrev(), llvm::DWARFYAML::emitDebugLine(), llvm::DWARFYAML::emitDebugStr(), llvm::AMDGPUTargetELFStreamer::EmitDirectiveHSACodeObjectISAV2(), llvm::DwarfStreamer::emitFDE(), llvm::InstrProfRecordWriterTrait::EmitKeyDataLength(), llvm::DwarfStreamer::emitLineTableForUnit(), llvm::emitSourceFileHeader(), llvm::CodeViewContext::encodeDefRange(), llvm::sys::path::end(), llvm::sys::path::extension(), find_first_not_of(), find_first_of(), find_last_not_of(), find_last_of(), find_lower(), llvm::opt::OptTable::findNearest(), llvm::TernOpInit::Fold(), for(), formatPax(), llvm::DWARFUnit::getAddrOffsetSectionItem(), llvm::ConstantDataSequential::getAsCString(), getAsInteger(), GetAutoSenseRadix(), llvm::APInt::getBitsNeeded(), llvm::object::ELFFile< object::ELF64LE >::getBufSize(), llvm::sampleprof::FunctionSamples::getCanonicalFnName(), llvm::SparcTargetLowering::getConstraintType(), llvm::MSP430TargetLowering::getConstraintType(), llvm::AVRTargetLowering::getConstraintType(), llvm::VETargetLowering::getConstraintType(), llvm::HexagonTargetLowering::getConstraintType(), llvm::RISCVTargetLowering::getConstraintType(), llvm::SITargetLowering::getConstraintType(), llvm::SystemZTargetLowering::getConstraintType(), llvm::NVPTXTargetLowering::getConstraintType(), llvm::ARMTargetLowering::getConstraintType(), llvm::PPCTargetLowering::getConstraintType(), llvm::X86TargetLowering::getConstraintType(), llvm::TargetLowering::getConstraintType(), llvm::AsmToken::getEndLoc(), llvm::Triple::getEnvironmentVersion(), llvm::getFuncNameWithoutPrefix(), getHexUint(), llvm::HexagonInstrInfo::getInlineAsmLength(), llvm::RISCVTargetLowering::getInlineAsmMemConstraint(), llvm::SystemZTargetLowering::getInlineAsmMemConstraint(), llvm::ARMTargetLowering::getInlineAsmMemConstraint(), llvm::MDString::getLength(), llvm::DWARFContext::getLineTableForUnit(), getMemBufferCopyImpl(), llvm::object::ArchiveMemberHeader::getName(), llvm::object::Elf_Sym_Impl< ELFT >::getName(), llvm::WritableMemoryBuffer::getNewUninitMemBuffer(), llvm::cl::generic_parser_base::getOptionWidth(), llvm::cl::basic_parser_impl::getOptionWidth(), llvm::StringToOffsetTable::GetOrAddStringOffset(), llvm::opt::ArgList::GetOrMakeJoinedArgString(), llvm::Triple::getOSVersion(), getQualifiedNameIndex(), llvm::BPFTargetLowering::getRegForInlineAsmConstraint(), llvm::SparcTargetLowering::getRegForInlineAsmConstraint(), llvm::LanaiTargetLowering::getRegForInlineAsmConstraint(), llvm::MSP430TargetLowering::getRegForInlineAsmConstraint(), llvm::AVRTargetLowering::getRegForInlineAsmConstraint(), llvm::VETargetLowering::getRegForInlineAsmConstraint(), llvm::HexagonTargetLowering::getRegForInlineAsmConstraint(), llvm::RISCVTargetLowering::getRegForInlineAsmConstraint(), llvm::SITargetLowering::getRegForInlineAsmConstraint(), llvm::SystemZTargetLowering::getRegForInlineAsmConstraint(), llvm::NVPTXTargetLowering::getRegForInlineAsmConstraint(), llvm::ARMTargetLowering::getRegForInlineAsmConstraint(), llvm::PPCTargetLowering::getRegForInlineAsmConstraint(), llvm::X86TargetLowering::getRegForInlineAsmConstraint(), llvm::TargetLowering::getRegForInlineAsmConstraint(), llvm::object::ELFFile< object::ELF64LE >::getSectionName(), llvm::object::MachOObjectFile::getSectionSize(), llvm::gsym::StringTable::getString(), llvm::ConstantDataArray::getString(), llvm::AsmToken::getStringContents(), llvm::DWARFUnit::getStringOffsetSectionItem(), llvm::AMDGPU::Exp::getTgtId(), getUnicodeEncoding(), getUUID(), llvm::yaml::ScalarNode::getValue(), getVarName(), gsiRecordCmp(), llvm::object::MachOObjectFile::guessLibraryShortName(), llvm::pdb::hashStringV1(), isAsmComment(), llvm::TrigramIndex::isDefinitelyOut(), isImmConstraint(), LLVMDITypeGetName(), LLVMGetAsString(), LLVMGetNamedMetadataName(), llvm::gsym::FunctionInfo::lookup(), llvm::Intrinsic::lookupLLVMIntrinsicByName(), llvm::InlineAsmLowering::lowerAsmOperandForConstraint(), llvm::opt::DerivedArgList::MakeJoinedArg(), mapNameAndUniqueName(), matchOption(), maybeLexIndex(), maybeLexIndexAndName(), maybeLexIRBlock(), maybeLexIRValue(), maybeLexSubRegisterIndex(), llvm::DWARFExpression::iterator::operator++(), llvm::gsym::operator<<(), llvm::raw_ostream::operator<<(), llvm::remarks::ParsedStringTable::operator[](), optimizeDoubleFP(), optimizeMemCmpConstantSize(), optionMatches(), llvm::parseAnalysisUtilityPasses(), parseBackslash(), parseDuration(), ParseLine(), parseMagic(), llvm::Pattern::parsePattern(), parseRefinementStep(), parseRegisterNumber(), parseStrTab(), parseStrTabSize(), llvm::Pattern::parseVariable(), parseVersion(), printCFI(), PrintCFIEscape(), llvm::cl::Option::printEnumValHelpStr(), llvm::cl::generic_parser_base::printGenericOptionDiff(), PrintHelpOptionList(), printLine(), llvm::cl::generic_parser_base::printOptionInfo(), printSourceLine(), llvm::sampleprof::SampleContext::promoteOnPath(), llvm::sys::path::rbegin(), llvm::sampleprof::ProfileSymbolList::read(), llvm::irsymtab::readBitcode(), readCoverageMappingData(), llvm::sampleprof::SampleProfileReaderBinary::readString(), llvm::InstrProfReaderItaniumRemapper< HashTableImpl >::reconstituteName(), llvm::sys::path::relative_path(), llvm::sys::path::remove_dots(), llvm::sys::path::remove_leading_dotslash(), llvm::sys::path::replace_extension(), llvm::sys::path::replace_path_prefix(), llvm::report_fatal_error(), rfind(), rfind_lower(), rsplit(), llvm::cl::Option::setArgStr(), llvm::DIEInlineString::SizeOf(), split(), llvm::formatv_object_base::splitLiteralAndReplacement(), splitUstar(), llvm::sys::path::starts_with(), llvm::sys::path::stem(), llvm::Regex::sub(), llvm::cl::TokenizeGNUCommandLine(), tokenizeWindowsCommandLineImpl(), llvm::StringAttributeImpl::totalSizeToAlloc(), llvm::DwarfStreamer::translateLineTable(), llvm::codeview::TypeServer2Record::TypeServer2Record(), llvm::zlib::uncompress(), llvm::SHA1::update(), llvm::SHA256::update(), llvm::MD5::update(), upgradeLoopTag(), llvm::writeFileAtomically(), writeStringRecord(), writeStringRef(), and llvm::yaml::yaml2archive().

slice()

LLVM_NODISCARD StringRef llvm::StringRef::slice ( size_t  Start, size_t  End  ) const

inline

Return a reference to the substring from [Start, End).

Parameters

Start	The index of the starting character in the substring; if the index is npos or greater than the length of the string then the empty substring will be returned.
End	The index following the last character to include in the substring. If this is npos or exceeds the number of characters remaining in the string, the string suffix (starting with Start) will be returned. If this is less than Start, an empty string will be returned.

Definition at line 713 of file StringRef.h.

Referenced by llvm::object::ObjectFile::createMachOObjectFile(), llvm::AsmToken::getStringContents(), llvm::object::MachOObjectFile::guessLibraryShortName(), locateCStrings(), parseDuration(), parseRegisterNumber(), printSourceLine(), llvm::formatv_object_base::splitLiteralAndReplacement(), llvm::Regex::sub(), and llvm::DwarfStreamer::translateLineTable().

split() [1/4]

LLVM_NODISCARD std::pair<StringRef, StringRef> llvm::StringRef::split ( char  Separator ) const

inline

Split into two substrings around the first occurrence of a separator character.

If Separator is in the string, then the result is a pair (LHS, RHS) such that (*this == LHS + Separator + RHS) is true and RHS is maximal. If Separator is not in the string, then the result is a pair (LHS, RHS) where (*this == LHS) and (RHS == "").

Parameters

Separator

The character to split on.

Returns

The split substrings.

Definition at line 730 of file StringRef.h.

References split.

Referenced by llvm::MachO::Target::create(), llvm::sampleprof::SampleContext::decodeContextString(), llvm::AMDGPU::HSAMD::MetadataStreamerV3::emitKernelArg(), forceAttributes(), llvm::Triple::getArchName(), llvm::codeview::getBytesAsCString(), llvm::sampleprof::FunctionSamples::getCanonicalFnName(), llvm::Triple::getEnvironmentName(), llvm::sys::detail::getHostCPUNameForARM(), llvm::sys::detail::getHostCPUNameForS390x(), getIntOperandFromRegisterString(), getIntOperandsFromRegisterString(), getOpEnabled(), getOpRefinementSteps(), llvm::Triple::getOSAndEnvironmentName(), llvm::Triple::getOSName(), getSearchPaths(), llvm::GCOVBuffer::getString(), llvm::codeview::getSymbolName(), llvm::Triple::getVendorName(), llvm::handleExecNameEncodedBEOpts(), llvm::handleExecNameEncodedOptimizerOpts(), isThumbFunction(), llvm::Triple::normalize(), llvm::SpecialCaseList::parse(), llvm::PassBuilder::parseAAPipeline(), parseCHRFilterFiles(), llvm::parseDenormalFPAttribute(), llvm::remarks::ParsedStringTable::ParsedStringTable(), parseNamePrefix(), llvm::MCSectionMachO::ParseSectionSpecifier(), llvm::cl::Option::printEnumValHelpStr(), llvm::cl::Option::printHelpStr(), printSymbolizedStackTrace(), llvm::DebugCounter::push_back(), llvm::SymbolRemappingReader::read(), llvm::readPGOFuncNameStrings(), llvm::GCOVBuffer::readString(), llvm::ReplayInlineAdvisor::ReplayInlineAdvisor(), llvm::Hexagon_MC::selectHexagonCPU(), llvm::AMDGPU::IsaInfo::AMDGPUTargetID::setTargetIDFromTargetIDStream(), split(), llvm::sampleprof::SampleContext::splitContextString(), llvm::Regex::sub(), llvm::opt::OptTable::suggestValueCompletions(), and llvm::Triple::Triple().

split() [2/4]

void StringRef::split	(	SmallVectorImpl< StringRef > &	A,
		char	Separator,
		int	MaxSplit = -1,
		bool	KeepEmpty = true
	)		const

Split into substrings around the occurrences of a separator character.

Each substring is stored in A. If MaxSplit is >= 0, at most MaxSplit splits are done and consequently <= MaxSplit + 1 elements are added to A. If KeepEmpty is false, empty strings are not added to A. They still count when considering MaxSplit An useful invariant is that Separator.join(A) == *this if MaxSplit == -1 and KeepEmpty == true

Parameters

A	- Where to put the substrings.
Separator	- The string to split on.
MaxSplit	- The maximum number of times the string is split.
KeepEmpty	- True if empty substring should be added.

Definition at line 335 of file StringRef.cpp.

References npos, and S.

split() [3/4]

void StringRef::split	(	SmallVectorImpl< StringRef > &	A,
		StringRef	Separator,
		int	MaxSplit = -1,
		bool	KeepEmpty = true
	)		const

Split into substrings around the occurrences of a separator string.

Each substring is stored in A. If MaxSplit is >= 0, at most MaxSplit splits are done and consequently <= MaxSplit + 1 elements are added to A. If KeepEmpty is false, empty strings are not added to A. They still count when considering MaxSplit An useful invariant is that Separator.join(A) == *this if MaxSplit == -1 and KeepEmpty == true

Parameters

A	- Where to put the substrings.
Separator	- The string to split on.
MaxSplit	- The maximum number of times the string is split.
KeepEmpty	- True if empty substring should be added.

Definition at line 308 of file StringRef.cpp.

References npos, S, and size().

split() [4/4]

LLVM_NODISCARD std::pair<StringRef, StringRef> llvm::StringRef::split ( StringRef  Separator ) const

inline

Split into two substrings around the first occurrence of a separator string.

If Separator is in the string, then the result is a pair (LHS, RHS) such that (*this == LHS + Separator + RHS) is true and RHS is maximal. If Separator is not in the string, then the result is a pair (LHS, RHS) where (*this == LHS) and (RHS == "").

Parameters

Separator

- The string to split on.

Returns

- The split substrings.

Definition at line 745 of file StringRef.h.

References llvm::find(), and size().

startswith()

LLVM_NODISCARD bool llvm::StringRef::startswith ( StringRef  Prefix ) const

inline

Check if this string starts with the given Prefix.

Definition at line 289 of file StringRef.h.

References llvm::Data, and llvm::cl::Prefix.

Referenced by llvm::analyzeImportedModule(), llvm::AsmLexer::AsmLexer(), llvm::ELFAttrs::attrTypeFromString(), llvm::RuntimeDyldCheckerImpl::checkAllRulesInBuffer(), llvm::RISCVABI::computeTargetABI(), llvm::MipsABIInfo::computeTargetABI(), computeTargetABI(), llvm::coverage::BinaryCoverageReader::create(), llvm::remarks::createYAMLParserFromMeta(), doesIgnoreDataTypeSuffix(), dumpTypeTagName(), llvm::ARMTargetStreamer::emitTargetAttributes(), llvm::JITSymbolFlags::fromGlobalValue(), llvm::AArch64::getArchExtFeature(), GetAutoSenseRadix(), llvm::Triple::getEnvironmentVersion(), llvm::getFuncNameWithoutPrefix(), llvm::GCOVFunction::getName(), llvm::object::getNameType(), llvm::opt::ArgList::GetOrMakeJoinedArgString(), llvm::Triple::getOSVersion(), getRegularRegInfo(), llvm::yaml::Node::getVerbatimTag(), llvm::object::MachOObjectFile::guessLibraryShortName(), INITIALIZE_PASS(), llvm::LTOModule::isBitcodeForTarget(), llvm::object::isDecorated(), llvm::MCSectionCOFF::isImplicitlyDiscardable(), llvm::makeFollowupLoopID(), llvm::yaml::MappingTraits< std::unique_ptr< ELFYAML::Chunk > >::mapping(), matchOption(), llvm::Triple::normalize(), optimizeDoubleFP(), llvm::parseAnalysisUtilityPasses(), parseArch(), llvm::ARM::parseArchEndian(), parseARMArch(), parseMetadata(), llvm::Pattern::parsePattern(), parseSubArch(), printSymbolizedStackTrace(), processGlobal(), llvm::RuntimeDyldCOFFI386::processRelocationRef(), llvm::RuntimeDyldCOFFThumb::processRelocationRef(), llvm::RuntimeDyldCOFFAArch64::processRelocationRef(), llvm::RuntimeDyldCOFFX86_64::processRelocationRef(), llvm::sampleprof::SampleContext::promoteOnPath(), llvm::pruneCache(), llvm::SymbolRemappingReader::read(), llvm::TextInstrProfReader::readHeader(), llvm::TextInstrProfReader::readNextRecord(), llvm::object::replace(), llvm::ThunkInserter< Derived >::run(), llvm::pdb::NativeSession::searchForPdb(), llvm::HexagonTargetObjectFile::SelectSectionForGlobal(), llvm::sys::path::starts_with(), llvm::StringSwitch< T, R >::StartsWith(), llvm::SmallString< 256 >::startswith(), StripSymtab(), StripTypeNames(), and upgradeLoopTag().

startswith_lower()

bool StringRef::startswith_lower

(

StringRef

Prefix

)

const

Check if this string starts with the given Prefix, ignoring case.

Definition at line 47 of file StringRef.cpp.

References ascii_strncasecmp(), and llvm::cl::Prefix.

Referenced by llvm::detail::HelperFunctions::consumeHexStyle(), matchOption(), and llvm::StringSwitch< T, R >::StartsWithLower().

str()

LLVM_NODISCARD std::string llvm::StringRef::str ( ) const

inline

str - Get the contents as an std::string.

Definition at line 248 of file StringRef.h.

References llvm::Data.

Referenced by llvm::DwarfCompileUnit::addGlobalType(), llvm::DwarfCompileUnit::addGlobalTypeUnitType(), llvm::sampleprof::SampleProfileWriterBinary::addName(), llvm::cacheAnnotationFromMD(), llvm::RuntimeDyldCheckerImpl::checkAllRulesInBuffer(), checkOperandCount(), llvm::sys::path::convert_to_slash(), llvm::Hexagon_MC::createHexagonMCSubtargetInfo(), llvm::MachO::Symbol::dump(), llvm::AMDGPUAsmPrinter::emitFunctionEntryLabel(), llvm::MCJIT::finalizeLoadedModules(), llvm::DiagnosticLocation::getAbsolutePath(), llvm::FieldInit::getAsString(), llvm::pdb::NativeSourceFile::getChecksum(), llvm::GlobalValue::getGlobalIdentifier(), llvm::DOTGraphTraits< DOTFuncInfo * >::getGraphName(), llvm::DOTGraphTraits< DOTFuncMSSAInfo * >::getGraphName(), llvm::vfs::File::getName(), getQualifiedNameIndex(), llvm::pdb::PDBSymbolCompiland::getSourceFileName(), llvm::RISCVTargetMachine::getSubtargetImpl(), llvm::HexagonTargetMachine::getSubtargetImpl(), llvm::SparcTargetMachine::getSubtargetImpl(), llvm::AArch64TargetMachine::getSubtargetImpl(), llvm::SystemZTargetMachine::getSubtargetImpl(), llvm::WebAssemblyTargetMachine::getSubtargetImpl(), llvm::PPCTargetMachine::getSubtargetImpl(), llvm::M68kTargetMachine::getSubtargetImpl(), llvm::ARMBaseTargetMachine::getSubtargetImpl(), llvm::MipsTargetMachine::getSubtargetImpl(), llvm::CompileUnit::getSysRoot(), llvm::Record::getValueAsBitOrUnset(), llvm::M68kSubtarget::initializeSubtargetDependencies(), llvm::ChangeReporter< std::string >::isInterestingPass(), llvm::LockFileManager::LockFileManager(), mangleCoveragePath(), llvm::yaml::MappingTraits< const InterfaceFile * >::NormalizedTBD::NormalizedTBD(), parseIRConstant(), llvm::DivergencePropagator::printDefs(), llvm::remapPath(), replaceWithCallToVeclib(), llvm::PseudoProbeVerifier::runAfterPass(), llvm::vfs::RedirectingFileSystem::setExternalContentsPrefixDir(), llvm::vfs::YAMLVFSWriter::setOverlayDir(), smallData(), llvm::OutlinableRegion::splitCandidate(), llvm::Twine::str(), llvm::json::ObjectKey::str(), suffixed_name_or(), llvm::timeTraceProfilerWrite(), llvm::AMDGPU::IsaInfo::AMDGPUTargetID::toString(), llvm::writeFileAtomically(), llvm::LTOCodeGenerator::writeMergedModules(), llvm::sampleprof::SampleProfileWriterBinary::writeNameIdx(), and writeTimestampFile().

substr()

LLVM_NODISCARD StringRef llvm::StringRef::substr ( size_t  Start, size_t  N = npos  ) const

inline

Return a reference to the substring from [Start, Start + N).

Parameters

Start	The index of the starting character in the substring; if the index is npos or greater than the length of the string then the empty substring will be returned.
N	The number of characters to included in the substring. If N exceeds the number of characters remaining in the string, the string suffix (starting with Start) will be returned.

Definition at line 612 of file StringRef.h.

Referenced by llvm::Hexagon_MC::addArchSubtarget(), llvm::RuntimeDyldCheckerImpl::checkAllRulesInBuffer(), CommaSeparateAndAddOccurrence(), llvm::consumeUnsignedInteger(), count(), decodeBase64StringEntry(), dumpTypeTagName(), EatNumber(), emitComments(), llvm::DwarfStreamer::emitLocationsForUnit(), llvm::emitSourceFileHeader(), llvm::RuntimeDyldCheckerExprEval::evaluate(), llvm::sys::path::extension(), find_lower(), llvm::MCJIT::findModuleForSymbol(), for(), llvm::JITSymbolFlags::fromGlobalValue(), llvm::AArch64::getArchExtFeature(), llvm::object::MachOUniversalBinary::ObjectForArch::getAsArchive(), llvm::ConstantDataSequential::getAsCString(), getAsInteger(), llvm::object::MachOUniversalBinary::ObjectForArch::getAsIRObject(), llvm::object::MachOUniversalBinary::ObjectForArch::getAsObjectFile(), GetAutoSenseRadix(), llvm::sampleprof::FunctionSamples::getCanonicalFnName(), llvm::getConstantStringInfo(), llvm::TargetLowering::getConstraintType(), llvm::Triple::getEnvironmentVersion(), getOpEnabled(), getOpRefinementSteps(), llvm::Triple::getOSVersion(), getQualifiedNameIndex(), llvm::SITargetLowering::getRegForInlineAsmConstraint(), llvm::object::MachOObjectFile::getStringTableData(), llvm::yaml::ScalarNode::getValue(), getVarName(), llvm::yaml::Node::getVerbatimTag(), HandlePrefixedOrGroupedOption(), llvm::isSpecialPass(), matchOption(), llvm::sys::path::parent_path(), llvm::parseAnalysisUtilityPasses(), llvm::yaml::Document::parseBlockNode(), ParseHead(), ParseLine(), parseMetadata(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::Pattern::parsePattern(), llvm::Pattern::parseVariable(), llvm::sampleprof::SampleContext::promoteOnPath(), llvm::GCOVBuffer::readGCDAFormat(), llvm::GCOVBuffer::readGCNOFormat(), llvm::TextInstrProfReader::readHeader(), llvm::sys::path::relative_path(), llvm::sys::path::remove_leading_dotslash(), llvm::sys::path::rend(), llvm::object::replace(), llvm::sys::path::replace_path_prefix(), rfind(), rfind_lower(), llvm::sys::path::root_path(), llvm::formatv_object_base::splitLiteralAndReplacement(), splitUstar(), llvm::sys::path::stem(), llvm::SubtargetFeatures::StripFlag(), llvm::Regex::sub(), llvm::elfabi::terminatedSubstr(), and llvm::UpgradeSectionAttributes().

take_back()

LLVM_NODISCARD StringRef llvm::StringRef::take_back ( size_t  N = 1 ) const

inline

Return a StringRef equal to 'this' but with only the last N elements remaining.

If N is greater than the length of the string, the entire string is returned.

Definition at line 631 of file StringRef.h.

References N, and llvm::size().

Referenced by llvm::DWARFLinker::link().

take_front()

LLVM_NODISCARD StringRef llvm::StringRef::take_front ( size_t  N = 1 ) const

inline

Return a StringRef equal to 'this' but with only the first N elements remaining.

If N is greater than the length of the string, the entire string is returned.

Definition at line 621 of file StringRef.h.

References N, and llvm::size().

Referenced by mapNameAndUniqueName(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::Pattern::parseVariable(), llvm::sys::path::remove_dots(), and llvm::formatv_object_base::splitLiteralAndReplacement().

take_until()

LLVM_NODISCARD StringRef llvm::StringRef::take_until ( function_ref< bool(char)>  F ) const

inline

Return the longest prefix of 'this' such that no character in the prefix satisfies the given predicate.

Definition at line 647 of file StringRef.h.

References F, and llvm::find_if().

take_while()

LLVM_NODISCARD StringRef llvm::StringRef::take_while ( function_ref< bool(char)>  F ) const

inline

Return the longest prefix of 'this' such that every character in the prefix satisfies the given predicate.

Definition at line 640 of file StringRef.h.

References F, and llvm::find_if_not().

Referenced by llvm::Annotations::Annotations(), llvm::formatv_object_base::splitLiteralAndReplacement(), and llvm::VFABI::tryDemangleForVFABI().

trim() [1/2]

LLVM_NODISCARD StringRef llvm::StringRef::trim ( char  Char ) const

inline

Return string with consecutive Char characters starting from the left and right removed.

Definition at line 851 of file StringRef.h.

References rtrim().

Referenced by llvm::RuntimeDyldCheckerImpl::check(), llvm::RuntimeDyldCheckerExprEval::evaluate(), llvm::DataExtractor::getFixedLengthString(), parseMetadata(), llvm::Pattern::parseNumericSubstitutionBlock(), and llvm::formatv_object_base::parseReplacementItem().

trim() [2/2]

LLVM_NODISCARD StringRef llvm::StringRef::trim ( StringRef  Chars = " \t\n\v\f\r" ) const

inline

Return string with consecutive characters in Chars starting from the left and right removed.

Definition at line 858 of file StringRef.h.

References rtrim().

upper()

std::string StringRef::upper

(

)

const

Convert the given ASCII string to uppercase.

Definition at line 113 of file StringRef.cpp.

References begin(), end(), and llvm::map_iterator().

Referenced by isCaseSensitivePath().

withNullAsEmpty()

static StringRef llvm::StringRef::withNullAsEmpty ( const char *  data )

inlinestatic

Definition at line 123 of file StringRef.h.

Member Data Documentation

npos

constexpr size_t StringRef::npos = ~size_t(0)

staticconstexpr

Definition at line 59 of file StringRef.h.

Referenced by llvm::X86FrameLowering::adjustForHiPEPrologue(), buildFixItLine(), CommaSeparateAndAddOccurrence(), llvm::sys::fs::createTemporaryFile(), llvm::sys::path::extension(), find(), find_first_not_of(), find_first_of(), find_last_not_of(), find_last_of(), find_lower(), llvm::SourceMgr::FindLocForLineAndColumn(), llvm::format_provider< T, std::enable_if_t< detail::use_string_formatter< T >::value > >::format(), llvm::ARM::getCanonicalArchName(), llvm::sampleprof::FunctionSamples::getCanonicalFnName(), llvm::HexagonTargetObjectFile::getExplicitSectionGlobal(), llvm::sys::detail::getHostCPUNameForS390x(), llvm::SourceMgr::getLineAndColumn(), llvm::InstrProfSymtab::getOrigFuncName(), llvm::object::ArchiveMemberHeader::getRawName(), llvm::getTypeName(), getTypeNamePrefix(), llvm::yaml::ScalarNode::getValue(), llvm::AMDGPU::HSAMD::MetadataStreamerV3::getValueKind(), llvm::object::MachOObjectFile::guessLibraryShortName(), hasObjCCategory(), hasWildcard(), llvm::GCNSubtarget::initializeSubtargetDependencies(), llvm::ConstantDataSequential::isCString(), llvm::Regex::isLiteralERE(), llvm::objcarc::IsObjCIdentifiedObject(), isSmallDataSection(), llvm::isSpecialPass(), locateCStrings(), llvm::Intrinsic::lookupLLVMIntrinsicByName(), llvm::sys::path::reverse_iterator::operator++(), llvm::sys::path::parent_path(), ParseLine(), llvm::Pattern::parseNumericSubstitutionBlock(), llvm::Pattern::parsePattern(), parseRefinementStep(), llvm::sys::printArg(), printSourceLine(), llvm::BinaryStreamReader::readCString(), llvm::sys::path::remove_dots(), llvm::sys::path::remove_filename(), llvm::object::replace(), llvm::sys::path::replace_extension(), rfind(), rfind_lower(), sanitizeFunctionName(), split(), llvm::formatv_object_base::splitLiteralAndReplacement(), splitUstar(), llvm::sys::path::stem(), llvm::elfabi::terminatedSubstr(), UpgradeIntrinsicFunction1(), and llvm::sampleprof::SampleProfileWriterExtBinaryBase::writeNameTableSection().

---

The documentation for this class was generated from the following files:

• include/llvm/ADT/StringRef.h
• lib/Support/StringRef.cpp