cannam@132: // Copyright (c) 2013-2014 Sandstorm Development Group, Inc. and contributors
cannam@132: // Licensed under the MIT License:
cannam@132: //
cannam@132: // Permission is hereby granted, free of charge, to any person obtaining a copy
cannam@132: // of this software and associated documentation files (the "Software"), to deal
cannam@132: // in the Software without restriction, including without limitation the rights
cannam@132: // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
cannam@132: // copies of the Software, and to permit persons to whom the Software is
cannam@132: // furnished to do so, subject to the following conditions:
cannam@132: //
cannam@132: // The above copyright notice and this permission notice shall be included in
cannam@132: // all copies or substantial portions of the Software.
cannam@132: //
cannam@132: // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
cannam@132: // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
cannam@132: // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
cannam@132: // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
cannam@132: // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
cannam@132: // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
cannam@132: // THE SOFTWARE.
cannam@132: 
cannam@132: #ifndef KJ_STRING_TREE_H_
cannam@132: #define KJ_STRING_TREE_H_
cannam@132: 
cannam@132: #if defined(__GNUC__) && !KJ_HEADER_WARNINGS
cannam@132: #pragma GCC system_header
cannam@132: #endif
cannam@132: 
cannam@132: #include "string.h"
cannam@132: 
cannam@132: namespace kj {
cannam@132: 
cannam@132: class StringTree {
cannam@132:   // A long string, represented internally as a tree of strings.  This data structure is like a
cannam@132:   // String, but optimized for concatenation and iteration at the expense of seek time.  The
cannam@132:   // structure is intended to be used for building large text blobs from many small pieces, where
cannam@132:   // repeatedly concatenating smaller strings into larger ones would waste copies.  This structure
cannam@132:   // is NOT intended for use cases requiring random access or computing substrings.  For those,
cannam@132:   // you should use a Rope, which is a much more complicated data structure.
cannam@132:   //
cannam@132:   // The proper way to construct a StringTree is via kj::strTree(...), which works just like
cannam@132:   // kj::str(...) but returns a StringTree rather than a String.
cannam@132:   //
cannam@132:   // KJ_STRINGIFY() functions that construct large strings from many smaller strings are encouraged
cannam@132:   // to return StringTree rather than a flat char container.
cannam@132: 
cannam@132: public:
cannam@132:   inline StringTree(): size_(0) {}
cannam@132:   inline StringTree(String&& text): size_(text.size()), text(kj::mv(text)) {}
cannam@132: 
cannam@132:   StringTree(Array<StringTree>&& pieces, StringPtr delim);
cannam@132:   // Build a StringTree by concatenating the given pieces, delimited by the given delimiter
cannam@132:   // (e.g. ", ").
cannam@132: 
cannam@132:   inline size_t size() const { return size_; }
cannam@132: 
cannam@132:   template <typename Func>
cannam@132:   void visit(Func&& func) const;
cannam@132: 
cannam@132:   String flatten() const;
cannam@132:   // Return the contents as a string.
cannam@132: 
cannam@132:   // TODO(someday):  flatten() when *this is an rvalue and when branches.size() == 0 could simply
cannam@132:   //   return `kj::mv(text)`.  Requires reference qualifiers (Clang 3.3 / GCC 4.8).
cannam@132: 
cannam@132:   void flattenTo(char* __restrict__ target) const;
cannam@132:   // Copy the contents to the given character array.  Does not add a NUL terminator.
cannam@132: 
cannam@132: private:
cannam@132:   size_t size_;
cannam@132:   String text;
cannam@132: 
cannam@132:   struct Branch;
cannam@132:   Array<Branch> branches;  // In order.
cannam@132: 
cannam@132:   inline void fill(char* pos, size_t branchIndex);
cannam@132:   template <typename First, typename... Rest>
cannam@132:   void fill(char* pos, size_t branchIndex, First&& first, Rest&&... rest);
cannam@132:   template <typename... Rest>
cannam@132:   void fill(char* pos, size_t branchIndex, StringTree&& first, Rest&&... rest);
cannam@132:   template <typename... Rest>
cannam@132:   void fill(char* pos, size_t branchIndex, Array<char>&& first, Rest&&... rest);
cannam@132:   template <typename... Rest>
cannam@132:   void fill(char* pos, size_t branchIndex, String&& first, Rest&&... rest);
cannam@132: 
cannam@132:   template <typename... Params>
cannam@132:   static StringTree concat(Params&&... params);
cannam@132:   static StringTree&& concat(StringTree&& param) { return kj::mv(param); }
cannam@132: 
cannam@132:   template <typename T>
cannam@132:   static inline size_t flatSize(const T& t) { return t.size(); }
cannam@132:   static inline size_t flatSize(String&& s) { return 0; }
cannam@132:   static inline size_t flatSize(StringTree&& s) { return 0; }
cannam@132: 
cannam@132:   template <typename T>
cannam@132:   static inline size_t branchCount(const T& t) { return 0; }
cannam@132:   static inline size_t branchCount(String&& s) { return 1; }
cannam@132:   static inline size_t branchCount(StringTree&& s) { return 1; }
cannam@132: 
cannam@132:   template <typename... Params>
cannam@132:   friend StringTree strTree(Params&&... params);
cannam@132: };
cannam@132: 
cannam@132: inline StringTree&& KJ_STRINGIFY(StringTree&& tree) { return kj::mv(tree); }
cannam@132: inline const StringTree& KJ_STRINGIFY(const StringTree& tree) { return tree; }
cannam@132: 
cannam@132: inline StringTree KJ_STRINGIFY(Array<StringTree>&& trees) { return StringTree(kj::mv(trees), ""); }
cannam@132: 
cannam@132: template <typename... Params>
cannam@132: StringTree strTree(Params&&... params);
cannam@132: // Build a StringTree by stringifying the given parameters and concatenating the results.
cannam@132: // If any of the parameters stringify to StringTree rvalues, they will be incorporated as
cannam@132: // branches to avoid a copy.
cannam@132: 
cannam@132: // =======================================================================================
cannam@132: // Inline implementation details
cannam@132: 
cannam@132: namespace _ {  // private
cannam@132: 
cannam@132: template <typename... Rest>
cannam@132: char* fill(char* __restrict__ target, const StringTree& first, Rest&&... rest) {
cannam@132:   // Make str() work with stringifiers that return StringTree by patching fill().
cannam@132: 
cannam@132:   first.flattenTo(target);
cannam@132:   return fill(target + first.size(), kj::fwd<Rest>(rest)...);
cannam@132: }
cannam@132: 
cannam@132: template <typename T> constexpr bool isStringTree() { return false; }
cannam@132: template <> constexpr bool isStringTree<StringTree>() { return true; }
cannam@132: 
cannam@132: inline StringTree&& toStringTreeOrCharSequence(StringTree&& tree) { return kj::mv(tree); }
cannam@132: inline StringTree toStringTreeOrCharSequence(String&& str) { return StringTree(kj::mv(str)); }
cannam@132: 
cannam@132: template <typename T>
cannam@132: inline auto toStringTreeOrCharSequence(T&& value)
cannam@132:     -> decltype(toCharSequence(kj::fwd<T>(value))) {
cannam@132:   static_assert(!isStringTree<Decay<T>>(),
cannam@132:       "When passing a StringTree into kj::strTree(), either pass it by rvalue "
cannam@132:       "(use kj::mv(value)) or explicitly call value.flatten() to make a copy.");
cannam@132: 
cannam@132:   return toCharSequence(kj::fwd<T>(value));
cannam@132: }
cannam@132: 
cannam@132: }  // namespace _ (private)
cannam@132: 
cannam@132: struct StringTree::Branch {
cannam@132:   size_t index;
cannam@132:   // Index in `text` where this branch should be inserted.
cannam@132: 
cannam@132:   StringTree content;
cannam@132: };
cannam@132: 
cannam@132: template <typename Func>
cannam@132: void StringTree::visit(Func&& func) const {
cannam@132:   size_t pos = 0;
cannam@132:   for (auto& branch: branches) {
cannam@132:     if (branch.index > pos) {
cannam@132:       func(text.slice(pos, branch.index));
cannam@132:       pos = branch.index;
cannam@132:     }
cannam@132:     branch.content.visit(func);
cannam@132:   }
cannam@132:   if (text.size() > pos) {
cannam@132:     func(text.slice(pos, text.size()));
cannam@132:   }
cannam@132: }
cannam@132: 
cannam@132: inline void StringTree::fill(char* pos, size_t branchIndex) {
cannam@132:   KJ_IREQUIRE(pos == text.end() && branchIndex == branches.size(),
cannam@132:               kj::str(text.end() - pos, ' ', branches.size() - branchIndex).cStr());
cannam@132: }
cannam@132: 
cannam@132: template <typename First, typename... Rest>
cannam@132: void StringTree::fill(char* pos, size_t branchIndex, First&& first, Rest&&... rest) {
cannam@132:   pos = _::fill(pos, kj::fwd<First>(first));
cannam@132:   fill(pos, branchIndex, kj::fwd<Rest>(rest)...);
cannam@132: }
cannam@132: 
cannam@132: template <typename... Rest>
cannam@132: void StringTree::fill(char* pos, size_t branchIndex, StringTree&& first, Rest&&... rest) {
cannam@132:   branches[branchIndex].index = pos - text.begin();
cannam@132:   branches[branchIndex].content = kj::mv(first);
cannam@132:   fill(pos, branchIndex + 1, kj::fwd<Rest>(rest)...);
cannam@132: }
cannam@132: 
cannam@132: template <typename... Rest>
cannam@132: void StringTree::fill(char* pos, size_t branchIndex, String&& first, Rest&&... rest) {
cannam@132:   branches[branchIndex].index = pos - text.begin();
cannam@132:   branches[branchIndex].content = StringTree(kj::mv(first));
cannam@132:   fill(pos, branchIndex + 1, kj::fwd<Rest>(rest)...);
cannam@132: }
cannam@132: 
cannam@132: template <typename... Params>
cannam@132: StringTree StringTree::concat(Params&&... params) {
cannam@132:   StringTree result;
cannam@132:   result.size_ = _::sum({params.size()...});
cannam@132:   result.text = heapString(
cannam@132:       _::sum({StringTree::flatSize(kj::fwd<Params>(params))...}));
cannam@132:   result.branches = heapArray<StringTree::Branch>(
cannam@132:       _::sum({StringTree::branchCount(kj::fwd<Params>(params))...}));
cannam@132:   result.fill(result.text.begin(), 0, kj::fwd<Params>(params)...);
cannam@132:   return result;
cannam@132: }
cannam@132: 
cannam@132: template <typename... Params>
cannam@132: StringTree strTree(Params&&... params) {
cannam@132:   return StringTree::concat(_::toStringTreeOrCharSequence(kj::fwd<Params>(params))...);
cannam@132: }
cannam@132: 
cannam@132: }  // namespace kj
cannam@132: 
cannam@132: #endif  // KJ_STRING_TREE_H_