// See the file "COPYING" in the main distribution directory for copyright. #pragma once #include "zeek/threading/Formatter.h" namespace zeek::threading::formatter { class Ascii final : public Formatter { public: /** * A struct to pass the necessary configuration values to the * Ascii module on initialization. */ struct SeparatorInfo { std::string separator; // Separator between columns std::string set_separator; // Separator between set elements. std::string unset_field; // String marking an unset field. std::string empty_field; // String marking an empty (but set) field. /** * Constructor that defines all the configuration options. * Use if you need either ValToODesc or EntryToVal. */ SeparatorInfo(const std::string& separator, const std::string& set_separator, const std::string& unset_field, const std::string& empty_field); /** * Constructor that leaves separators etc unset to dummy * values. Useful if you use only methods that don't need any * of them, like StringToAddr, etc. */ SeparatorInfo(); }; /** * Constructor. * * @param t The thread that uses this class instance. The class uses * some of the thread's methods, e.g., for error reporting and * internal formatting. * * @param info SeparatorInfo structure defining the necessary * separators. */ Ascii(MsgThread* t, const SeparatorInfo& info); ~Ascii() override = default; virtual bool Describe(ODesc* desc, Value* val, const std::string& name = "") const override; virtual bool Describe(ODesc* desc, int num_fields, const Field* const* fields, Value** vals) const override; virtual Value* ParseValue(const std::string& s, const std::string& name, TypeTag type, TypeTag subtype = TYPE_ERROR) const override; private: bool CheckNumberError(const char* start, const char* end, bool nonneg_only = false) const; SeparatorInfo separators; }; } // namespace zeek::threading::formatter