|  | /* | 
|  | * 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 |