src/developer/debug/zxdb/symbols/type.h

// Copyright 2018 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef SRC_DEVELOPER_DEBUG_ZXDB_SYMBOLS_TYPE_H_
#define SRC_DEVELOPER_DEBUG_ZXDB_SYMBOLS_TYPE_H_

#include <string>
#include <vector>

#include "src/developer/debug/zxdb/symbols/symbol.h"

namespace zxdb {

class Type : public Symbol {
 public:
  // Symbol overrides.
  const Type* AsType() const final;
  const std::string& GetAssignedName() const { return assigned_name_; }

  // Strips "const" and "volatile" qualifiers, as well as the uncommon "restrict" C qualifier.
  // See StripCVT() for why most callers will want a "concrete" type. This function does the
  // maximum, qualifier stripping that doesn't change the name of the type.
  virtual const Type* StripCV() const;

  // Strips "const", "volatile", and follows typedefs to get the underlying type. This also strips
  // "restrict" for C (unusual), and handles C++ "using" statements for defining types (which are
  // encoded in DWARF as typedefs).
  //
  // Prefer ExprValue::GetConcreteType() or EvalContext::GetConcreteType() when possible. That
  // version will also expand forward definitions which is almost always the right thing to do. This
  // variant doesn't have enough context from the symbol system so just follows the type pointers.
  //
  // It is on the Type class rather than the ModifiedType class so that calling code can
  // unconditionally call type->StripCVT().
  virtual const Type* StripCVT() const;

  // The name assigned in the DWARF file. This will be empty for modified types (Which usually have
  // no assigned name). See Symbol::GetAssignedName).
  void set_assigned_name(std::string n) { assigned_name_ = std::move(n); }

  // Types are declarations when the full definition of the type isn't known. This corresponds to a
  // C forward declaration. In some cases, the type definition isn't even encoded in the compilation
  // unit because the full definition was never seen.
  bool is_declaration() const { return is_declaration_; }
  void set_is_declaration(bool id) { is_declaration_ = id; }

  // For forward-defines where the size of the structure is not known, the byte size will be 0.
  uint32_t byte_size() const { return byte_size_; }
  void set_byte_size(uint32_t bs) { byte_size_ = bs; }

 protected:
  FRIEND_REF_COUNTED_THREAD_SAFE(Type);
  FRIEND_MAKE_REF_COUNTED(Type);

  explicit Type(DwarfTag kind);
  virtual ~Type();

 private:
  std::string assigned_name_;
  bool is_declaration_ = false;
  uint32_t byte_size_ = 0;
};

}  // namespace zxdb

#endif  // SRC_DEVELOPER_DEBUG_ZXDB_SYMBOLS_TYPE_H_