writer_executor.hpp

#pragma once
 
template <OutputSink Sink, FormatProfile Profile>
class Writer::Executor
{
 public:
  Executor(Sink& sink, const uint8_t* codes, const uint8_t* args);
 
  [[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);
 
  template <typename T>
  [[nodiscard]] static char ResolveFloatSignChar(T value, const Spec& spec);
 
  template <std::signed_integral Int>
  [[nodiscard]] ErrorCode WriteSigned(const Spec& spec, Int value);
 
  template <FormatType Type, std::unsigned_integral UInt>
  [[nodiscard]] ErrorCode WriteUnsigned(const Spec& spec, UInt value);
 
  template <uint8_t Base, bool UpperCase = false,
            bool InlineAlternateOctal = 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);
 
  template <typename T>
  [[nodiscard]] ErrorCode WriteFloat(FormatType type, const Spec& spec, T value);
 
  [[nodiscard]] ErrorCode WriteU32Dec(uint32_t value);
 
  [[nodiscard]] ErrorCode WriteU32ZeroPadWidth(uint8_t width, uint32_t value);
 
  [[nodiscard]] ErrorCode WriteStringRaw(std::string_view text);
 
  [[nodiscard]] ErrorCode WriteF32FixedPrec(uint8_t precision, float value);
 
  [[nodiscard]] ErrorCode WriteF64FixedPrec(uint8_t precision, double value);
 
  // 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();
 
  template <FormatType Type, typename Float>
  [[nodiscard]] ErrorCode DispatchFloatField();
 
  [[nodiscard]] ErrorCode DispatchPointerField();
 
  [[nodiscard]] ErrorCode DispatchCharacterField();
 
  [[nodiscard]] ErrorCode DispatchStringField();
 
  [[nodiscard]] ErrorCode DispatchGenericField(FormatType type);
 
  [[nodiscard]] ErrorCode DispatchOp(FormatOp op);
 
  Sink& sink_;
  CodeReader codes_;
  ArgumentReader args_;
};
 
#include "writer_executor_field.hpp"
#include "writer_executor_value.hpp"
#include "writer_executor_generic.hpp"
#include "writer_executor_opcode.hpp"