| /* |
| * Copyright (C) 2022 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #pragma once |
| |
| #include <bitset> |
| #include <map> |
| #include <optional> |
| #include <set> |
| #include <sstream> |
| #include <string> |
| #include <vector> |
| |
| namespace android { |
| |
| template <size_t N> |
| std::string bitsetToString(const std::bitset<N>& bitset) { |
| if (bitset.none()) { |
| return "<none>"; |
| } |
| return bitset.to_string(); |
| } |
| |
| template <class T> |
| std::string streamableToString(const T& streamable) { |
| std::stringstream out; |
| out << streamable; |
| return out.str(); |
| } |
| |
| template <typename T> |
| inline std::string constToString(const T& v) { |
| return std::to_string(v); |
| } |
| |
| template <> |
| inline std::string constToString(const bool& value) { |
| return value ? "true" : "false"; |
| } |
| |
| template <> |
| inline std::string constToString(const std::vector<bool>::reference& value) { |
| return value ? "true" : "false"; |
| } |
| |
| inline std::string constToString(const std::string& s) { |
| return s; |
| } |
| |
| /** |
| * Convert an optional type to string. |
| */ |
| template <typename T> |
| inline std::string toString(const std::optional<T>& optional, |
| std::string (*toString)(const T&) = constToString) { |
| return optional ? toString(*optional) : "<not set>"; |
| } |
| |
| /** |
| * Convert a set of integral types to string. |
| */ |
| template <typename T> |
| std::string dumpSet(const std::set<T>& v, std::string (*toString)(const T&) = constToString) { |
| std::string out; |
| for (const T& entry : v) { |
| out += out.empty() ? "{" : ", "; |
| out += toString(entry); |
| } |
| return out.empty() ? "{}" : (out + "}"); |
| } |
| |
| /** |
| * Convert a map or multimap to string. Both keys and values of the map should be integral type. |
| */ |
| template <typename T> |
| std::string dumpMap(const T& map, |
| std::string (*keyToString)(const typename T::key_type&) = constToString, |
| std::string (*valueToString)(const typename T::mapped_type&) = constToString) { |
| std::string out; |
| for (const auto& [k, v] : map) { |
| if (!out.empty()) { |
| out += "\n"; |
| } |
| out += keyToString(k) + ":" + valueToString(v); |
| } |
| return out; |
| } |
| |
| /** |
| * Convert map keys to string. The keys of the map should be integral type. |
| */ |
| template <typename K, typename V> |
| std::string dumpMapKeys(const std::map<K, V>& map, |
| std::string (*keyToString)(const K&) = constToString) { |
| std::string out; |
| for (const auto& [k, _] : map) { |
| out += out.empty() ? "{" : ", "; |
| out += keyToString(k); |
| } |
| return out.empty() ? "{}" : (out + "}"); |
| } |
| |
| /** Convert a vector to a string. */ |
| template <typename T> |
| std::string dumpVector(const std::vector<T>& values, |
| std::string (*valueToString)(const T&) = constToString) { |
| std::string out; |
| for (const auto& value : values) { |
| out += out.empty() ? "[" : ", "; |
| out += valueToString(value); |
| } |
| return out.empty() ? "[]" : (out + "]"); |
| } |
| |
| const char* toString(bool value); |
| |
| /** |
| * Add "prefix" to the beginning of each line in the provided string |
| * "str". |
| * The string 'str' is typically multi-line. |
| * The most common use case for this function is to add some padding |
| * when dumping state. |
| */ |
| std::string addLinePrefix(std::string str, const std::string& prefix); |
| |
| } // namespace android |