Files
carbon-lang/common/string_helpers.h
T
Jon Meow c4c5cdc1f5 Replace is_sorted with comparison (#1104)
* Replace is_sorted with comparison

* Switch to StringRefContainsPointer
2022-03-03 10:21:38 -08:00

37 lines
1.2 KiB
C++

// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
// Exceptions. See /LICENSE for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
#ifndef COMMON_STRING_HELPERS_H_
#define COMMON_STRING_HELPERS_H_
#include <optional>
#include <string>
#include "llvm/ADT/StringRef.h"
#include "llvm/Support/Error.h"
namespace Carbon {
// Note llvm StringExtras has significant functionality which is intended to be
// complementary to this.
// Unescapes Carbon escape sequences in the source string. Returns std::nullopt
// on bad input. `is_block_string` enables escaping unique to block string
// literals, such as \<newline>.
auto UnescapeStringLiteral(llvm::StringRef source, bool is_block_string = false)
-> std::optional<std::string>;
// Parses a block string literal in `source`.
auto ParseBlockStringLiteral(llvm::StringRef source)
-> llvm::Expected<std::string>;
// Returns true if the pointer is in the string ref (including equality with
// `ref.end()`). This should be used instead of `<=` comparisons for
// correctness.
auto StringRefContainsPointer(llvm::StringRef ref, const char* ptr) -> bool;
} // namespace Carbon
#endif // COMMON_STRING_HELPERS_H_