xref: /freebsd/contrib/llvm-project/llvm/lib/Support/StringExtras.cpp (revision 30b4df2e4a12016f961f4d4e6b8b5b361feeb96f)
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