writer_executor.hpp

#pragma once
 
template <OutputSink Sink>
class Writer::Executor
{
 public:
  Executor(Sink& sink, const uint8_t* codes, const uint8_t* args);
 
  template <FormatProfile Profile>
  [[nodiscard]] ErrorCode Run();
 
 private:
  // Raw sink and generic field-writing helpers.
  // 原始输出与通用字段写出辅助函数。
  [[nodiscard]] ErrorCode WriteRaw(std::string_view text);
  [[nodiscard]] ErrorCode WritePadding(char fill, size_t count);
  [[nodiscard]] ErrorCode WriteTextField(std::string_view text, const Spec& spec);
  [[nodiscard]] ErrorCode WriteIntegerField(char sign_char, std::string_view prefix,
                                            std::string_view digits, const Spec& spec);
  [[nodiscard]] ErrorCode WriteFloatField(char sign_char, std::string_view text,
                                          const Spec& spec);
 
  template <std::signed_integral Int>
  [[nodiscard]] static char ResolveSignChar(Int value, const Spec& spec);
 
#if LIBXR_PRINT_ENABLE_FLOAT
  template <typename T>
  [[nodiscard]] static char ResolveFloatSignChar(T value, const Spec& spec);
#endif
 
  template <std::signed_integral Int>
  [[nodiscard]] ErrorCode WriteSigned(const Spec& spec, Int value);
 
  template <FormatType Type, std::unsigned_integral UInt>
  [[nodiscard]] ErrorCode DispatchUnsigned(const Spec& spec, UInt value);
 
  template <uint8_t Base, bool UpperCase = false, bool PrependOctalZero = false,
            std::unsigned_integral UInt>
  [[nodiscard]] ErrorCode WriteUnsignedDigits(std::string_view prefix, const Spec& spec,
                                              UInt value);
  [[nodiscard]] ErrorCode WritePointer(const Spec& spec, uintptr_t value);
  [[nodiscard]] ErrorCode WriteCharacter(const Spec& spec, char ch);
  [[nodiscard]] ErrorCode WriteString(const Spec& spec, std::string_view text);
 
#if LIBXR_PRINT_ENABLE_FLOAT
  template <typename T>
  [[nodiscard]] ErrorCode WriteFloat(FormatType type, const Spec& spec, T value);
#endif
 
  [[nodiscard]] ErrorCode WriteU32Dec(uint32_t value);
 
  [[nodiscard]] ErrorCode WriteI32Dec(int32_t value);
 
  template <uint8_t Base, bool UpperCase = false>
  [[nodiscard]] ErrorCode WriteU32Base(uint32_t value);
 
  [[nodiscard]] ErrorCode WriteU32ZeroPadWidth(uint8_t width, uint32_t value);
 
  [[nodiscard]] ErrorCode WriteStringRaw(std::string_view text);
 
  [[nodiscard]] ErrorCode WriteCharacterRaw(char ch);
 
  // Small bridges that keep GenericField dispatch readable while preserving the
  // existing "read spec -> read next packed argument -> call concrete writer"
  // execution order.
  // 这些小桥接函数只负责让 GenericField 分发更易读，同时保持原有的
  // “读 spec -> 读下一个已打包参数 -> 调具体 writer” 执行顺序不变。
  template <std::signed_integral Int>
  [[nodiscard]] ErrorCode DispatchSignedField();
 
  template <FormatType Type, std::unsigned_integral UInt>
  [[nodiscard]] ErrorCode DispatchUnsignedField();
 
#if LIBXR_PRINT_ENABLE_FLOAT
  template <FormatType Type, typename Float>
  [[nodiscard]] ErrorCode DispatchFloatField();
#endif
 
  [[nodiscard]] ErrorCode DispatchPointerField();
 
  [[nodiscard]] ErrorCode DispatchCharacterField();
 
  [[nodiscard]] ErrorCode DispatchStringField();
 
  template <FormatProfile Profile>
  [[nodiscard]] ErrorCode DispatchGenericField(FormatType type);
 
  template <FormatProfile Profile>
  [[nodiscard]] ErrorCode DispatchOp(FormatOp op);
 
  Sink& sink_;
  CodeReader codes_;
  ArgumentReader args_;
};
 
// These implementation headers form an ordered dependency chain.
// clang-format off
#include "writer_executor_field.hpp"
#include "writer_executor_value.hpp"
#include "writer_executor_generic.hpp"
#include "writer_executor_opcode.hpp"
// clang-format on