using System;
using Robust.Shared.Player;
namespace Robust.Shared.GameObjects;
///
/// A type that represents an entity, and allows you to get a string containing human-readable information about it.
/// This type converts implicitly to string, for convenience purposes.
///
///
/// This can be used to pretty-print information about entities and also to log various information regarding an
/// entity, if you're using string interpolation handlers.
///
/// The unique identifier of the entity.
/// Whether the entity has been deleted or not. Also true if the entity does not exist.
/// The name of the entity.
/// The prototype identifier of the entity, if any.
/// The session attached to the entity, if any.
public readonly record struct EntityStringRepresentation
(EntityUid Uid, NetEntity Nuid, bool Deleted, string? Name = null, string? Prototype = null, ICommonSession? Session = null) : IFormattable
{
public EntityStringRepresentation(Entity entity) : this(entity.Owner, entity.Comp)
{
}
public EntityStringRepresentation(EntityUid uid, MetaDataComponent meta, ActorComponent? actor = null)
: this(uid, meta.NetEntity, meta.EntityDeleted, meta.EntityName, meta.EntityPrototype?.ID, actor?.PlayerSession)
{
}
public override string ToString()
{
if (Deleted && Name == null)
return $"{Uid}/n{Nuid}D";
return $"{Name} ({Uid}/n{Nuid}{(Prototype != null ? $", {Prototype}" : "")}{(Session != null ? $", {Session.Name}" : "")}){(Deleted ? "D" : "")}";
}
public string ToString(string? format, IFormatProvider? formatProvider)
{
return ToString();
}
public static implicit operator string(EntityStringRepresentation rep) => rep.ToString();
}