minidump: Add InitializeFromSnapshot() for MinidumpModuleCrashpadInfoListWriter and downstream

minidump/minidump_simple_string_dictionary_writer.h

 // Copyright 2014 The Crashpad Authors. All rights reserved.
 //
 // 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,
@@ skipping 73 matching lines @@
 //!     file, containing a list of MinidumpSimpleStringDictionaryEntry objects.
 //!
 //! Because this class writes a representatin of a dictionary, the order of
 //! entries is insignificant. Entries may be written in any order.
 class MinidumpSimpleStringDictionaryWriter final
     : public internal::MinidumpWritable {
  public:
   MinidumpSimpleStringDictionaryWriter();
   ~MinidumpSimpleStringDictionaryWriter() override;
 
+  //! \brief Adds an initialized MinidumpSimpleStringDictionaryEntryWriter for
+  //!     each key-value pair in \a map to the MinidumpSimpleStringDictionary.
+  //!
+  //! \param[in] map The map to use as source data.
+  //!
+  //! \note Valid in #kStateMutable. No mutator methods may be called before
+  //!     this method, and it is not normally necessary to call any mutator
+  //!     methods after this method.
+  void InitializeFromMap(const std::map<std::string, std::string>& map);
+
   //! \brief Adds a MinidumpSimpleStringDictionaryEntryWriter to the
   //!     MinidumpSimpleStringDictionary.
   //!
   //! This object takes ownership of \a entry and becomes its parent in the
   //! overall tree of internal::MinidumpWritable objects.
   //!
   //! If the key contained in \a entry duplicates the key of an entry already
   //! present in the MinidumpSimpleStringDictionary, the new \a entry will
   //! replace the previous one.
   //!
   //! \note Valid in #kStateMutable.
   void AddEntry(scoped_ptr<MinidumpSimpleStringDictionaryEntryWriter> entry);
 
+  //! \brief Determines whether the object is useful.
+  //!
+  //! A useful object is one that carries data that makes a meaningful
+  //! contribution to a minidump file. An object carrying entries would be
+  //! considered useful.
+  //!
+  //! \return `true` if the object is useful, `false` otherwise.
+  bool IsUseful() const;
+
  protected:
   // MinidumpWritable:
 
   bool Freeze() override;
   size_t SizeOfObject() override;
   std::vector<MinidumpWritable*> Children() override;
   bool WriteObject(FileWriterInterface* file_writer) override;
 
  private:
   MinidumpSimpleStringDictionary simple_string_dictionary_base_;
 
   // This object owns the MinidumpSimpleStringDictionaryEntryWriter objects.
   std::map<std::string, MinidumpSimpleStringDictionaryEntryWriter*> entries_;
 
   DISALLOW_COPY_AND_ASSIGN(MinidumpSimpleStringDictionaryWriter);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_MINIDUMP_MINIDUMP_SIMPLE_STRING_DICTIONARY_WRITER_H_