1 //===-- StringExtras.cpp - Implement the StringExtras header --------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file implements the StringExtras.h header
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #include "llvm/ADT/StringExtras.h"
14 #include "llvm/ADT/SmallVector.h"
15 #include "llvm/Support/raw_ostream.h"
16 using namespace llvm;
17 
18 /// StrInStrNoCase - Portable version of strcasestr.  Locates the first
19 /// occurrence of string 's1' in string 's2', ignoring case.  Returns
20 /// the offset of s2 in s1 or npos if s2 cannot be found.
21 StringRef::size_type llvm::StrInStrNoCase(StringRef s1, StringRef s2) {
22   size_t N = s2.size(), M = s1.size();
23   if (N > M)
24     return StringRef::npos;
25   for (size_t i = 0, e = M - N + 1; i != e; ++i)
26     if (s1.substr(i, N).equals_lower(s2))
27       return i;
28   return StringRef::npos;
29 }
30 
31 /// getToken - This function extracts one token from source, ignoring any
32 /// leading characters that appear in the Delimiters string, and ending the
33 /// token at any of the characters that appear in the Delimiters string.  If
34 /// there are no tokens in the source string, an empty string is returned.
35 /// The function returns a pair containing the extracted token and the
36 /// remaining tail string.
37 std::pair<StringRef, StringRef> llvm::getToken(StringRef Source,
38                                                StringRef Delimiters) {
39   // Figure out where the token starts.
40   StringRef::size_type Start = Source.find_first_not_of(Delimiters);
41 
42   // Find the next occurrence of the delimiter.
43   StringRef::size_type End = Source.find_first_of(Delimiters, Start);
44 
45   return std::make_pair(Source.slice(Start, End), Source.substr(End));
46 }
47 
48 /// SplitString - Split up the specified string according to the specified
49 /// delimiters, appending the result fragments to the output list.
50 void llvm::SplitString(StringRef Source,
51                        SmallVectorImpl<StringRef> &OutFragments,
52                        StringRef Delimiters) {
53   std::pair<StringRef, StringRef> S = getToken(Source, Delimiters);
54   while (!S.first.empty()) {
55     OutFragments.push_back(S.first);
56     S = getToken(S.second, Delimiters);
57   }
58 }
59 
60 void llvm::printEscapedString(StringRef Name, raw_ostream &Out) {
61   for (unsigned i = 0, e = Name.size(); i != e; ++i) {
62     unsigned char C = Name[i];
63     if (C == '\\')
64       Out << '\\' << C;
65     else if (isPrint(C) && C != '"')
66       Out << C;
67     else
68       Out << '\\' << hexdigit(C >> 4) << hexdigit(C & 0x0F);
69   }
70 }
71 
72 void llvm::printHTMLEscaped(StringRef String, raw_ostream &Out) {
73   for (char C : String) {
74     if (C == '&')
75       Out << "&amp;";
76     else if (C == '<')
77       Out << "&lt;";
78     else if (C == '>')
79       Out << "&gt;";
80     else if (C == '\"')
81       Out << "&quot;";
82     else if (C == '\'')
83       Out << "&apos;";
84     else
85       Out << C;
86   }
87 }
88 
89 void llvm::printLowerCase(StringRef String, raw_ostream &Out) {
90   for (const char C : String)
91     Out << toLower(C);
92 }
93