Class TYsonString

library/cpp/yt/yson_string/string.h:66–127

An owning version of TYsonStringBuf. ! * Internally captures the data either via TCowString or a polymorphic ref-counted holder. */

 *  Internally captures the data either via TCowString or a polymorphic ref-counted holder.
 */
class TYsonString
{
public:
    //! Constructs a null instance.
    TYsonString();

    //! Constructs an instance from TYsonStringBuf.
    //! Copies the data into a ref-counted payload.
    explicit TYsonString(const TYsonStringBuf& ysonStringBuf);

    //! Constructs an instance from TStringBuf.
    //! Copies the data into a ref-counted payload.
    explicit TYsonString(
        TStringBuf data,
        EYsonType type = EYsonType::Node);

    //! Constructs an instance from TString.
    //! Zero-copy for CoW TString: retains the reference to TString in payload.
    explicit TYsonString(
        const TString& data,
        EYsonType type = EYsonType::Node);

    //! Constructs an instance from TSharedRef.
    //! Zero-copy; retains the reference to TSharedRef holder in payload.
    explicit TYsonString(
        const TSharedRef& ref,
        EYsonType type = EYsonType::Node);

    //! Returns |true| if the instance is not null.
    explicit operator bool() const;

    //! Returns type of YSON contained here. The instance must be non-null.
    EYsonType GetType() const;

    //! Returns the non-owning data. The instance must be non-null.
    TStringBuf AsStringBuf() const;

    //! Returns the data represented by TString. The instance must be non-null.
    //! Copies the data in case the payload is not TString.
    TString ToString() const;

    //! Returns the data represented by TSharedRef. The instance must be non-null.
    //! The data is never copied.
    TSharedRef ToSharedRef() const;

    //! Computes the hash code.
    size_t ComputeHash() const;

    //! Allow to serialize/deserialize using the ::Save ::Load functions. See util/ysaveload.h.
    void Save(IOutputStream* s) const;
    void Load(IInputStream* s);

private:
    struct TNullPayload
    { };

    std::variant<TNullPayload, TSharedRangeHolderPtr, TCowString> Payload_;