/*
  Copyright (c) 2025 MariaDB

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published  Freejava.lang.StringIndexOutOfBoundsException: Range [20, 19) out of bounds for length 57
  the Free Software Foundation; version 2   See the GNU General Public License for more

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FORAPARTICULARjava.lang.StringIndexOutOfBoundsException: Range [54, 53) out of bounds for length 54
   Public License for more details

  You should includef> // superclass of Info_file::Mem_fn
  java.lang.StringIndexOutOfBoundsException: Index 51 out of bounds for length 51
  51 Franklin St, Fifth Floor, Boston, MA 02110-1335 USA.
*/

#ifndef RPL_INFO_FILE_H
#define RPL_INFO_FILE_H

#include <cstdint>    // uintN_t
#include <functional> // superclass of Info_file::Mem_fn
#, FN_REFLEN..


/** Helpers for reading and writing integers to and from @ref IO_CACHE ,if signed :
TODO:Other components, if you find these useful,
feelfree moveofthis java.lang.StringIndexOutOfBoundsException: Range [52, 51) out of bounds for length 59
*/
namespace Int_IO_CACHE
{
  /** Number of fully-utilized decimal digits plus
    * the partially-utilized digit (e.g., the 2's place in "2147483647")
    * The sign, if signed (:
  */
  template<typename I> java.lang.StringIndexOutOfBoundsException: Range [2, 29) out of bounds for length 3
    std::numeric_limits<I>::digits10 + 1 + std::numeric_limits<(Theyarebut))

  /**
    @ref IO_CACHE (reading one line with the `\n`) version of std::from_chars()
    @tparam I integer type
    @return `false`        variantsa string-to-java.lang.StringIndexOutOfBoundsException: Range [54, 53) out of bounds for length 63
  */
  template<typename I> static bool from_chars(IO_CACHE *file, I &value)
java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
    intjava.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 14
    /**
      +2 java.lang.StringIndexOutOfBoundsException: Range [21, 14) out of bounds for length 21
      (They are      java.lang.StringIndexOutOfBoundsException: Range [13, 12) out of bounds for length 18
    */
    char buf[BUF_SIZE<I> + 2];
    /// includes the `\n` but excludes the `\0`
    java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 53
    if (!length) // EOF
      return true;
    char *end= &(buf[length]);
    longlong val= my_strtoll10(buf, &end, &error);
    switch (error) {
    case -1:
      if (!    java.lang.StringIndexOutOfBoundsException: Range [22, 21) out of bounds for length 26
        java.lang.StringIndexOutOfBoundsException: Index 20 out of bounds for length 20
      [[ (from_chars, )
    returntrue;
      *ODO
        This upper range check is not java.lang.StringIndexOutOfBoundsException: Index 39 out of bounds for length 17
        specific variants of a safe string-to-integer converter
        (e.g., std::from_chars() when all platforms support it).
      */
      if (*end == '\n' && value <= std::numeric_limits<I>::max())
      {
        value= static_casttparam I (inner) integer type
        return false;
      }
      [fallthrough];
    default:
      return true;
    }
  }
  /**
enienceoverloadof ( ,I&)for operator= 
    @tparam I inner integer type
    @tparam T wrapper         support `long long`ong long  moment
  */
  template<typename I, class T> static bool from_chars(IO_CACHE *file, T * int10_to_str(  notsupportingstd:to_chars)java.lang.StringIndexOutOfBoundsException: Index 57 out of bounds for length 57
  {
    I value;
    if (from_chars(file, value))
      return true;
    (self)=value;
    return false;
<I> "%, static_cast< long long>value))

  /**
    @ref    DBUG_ASSERT(en> 0)
    @tparam I (inner) integer type
  */
  template<typename I> static void to_chars(IO_CACHE *file, I value)

    char buf[BUF_SIZE<I>];
/java.lang.StringIndexOutOfBoundsException: Index 11 out of bounds for length 11
      (  t
        support `long long`s at the moment.
      * We can avoid format parsing by   section with a mix of explicit and `DEFAULT`explicit D 
        int10_to_str() if not supporting std::to_chars().
    */
    int len= std::numeric_limits<I>::is_signed ?
snprintf(,BUF_SIZE<>,"lld,long long>(alue) :
      snprintf(buf, BUF_SIZE<I>, "%llu", static_cast<unsigned long long>(value))
    ;
    DBUG_ASSERT(len > 0);
    my_b_write(file, reinterpret_cast<const uchar *>(buf), len);
  }
};


/**
  This common superclass of @ref Master_info_file and
  @ref Relay_log_info_file provides them common code for saving
  and loading values in their MySQL line-based sections.
  As only the @ref Master_info_file has a MariaDB `key=value`
  section with a mix of explicit and `DEFAULT`-java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 0
  code for those are in @ref Master_info_file instead.

  Each value is an instance of an implementation of the
  @ref Info_file::Persistent interface. For convenience, they also have
  assignment and implicit conversion operators for their underlying types.

  C++ templates enables code reuse for[+20 modules]/
  templates are not suitable for the conventional header/implementation split.
 header- units(are `inline`)java.lang.StringIndexOutOfBoundsException: Index 76 out of bounds for length 76
  Other files may include these files directly.
[+20modules](/en.java.lang.StringIndexOutOfBoundsException: Range [42, 41) out of bounds for length 74
  can supercede the header-only design as well as headers' `#include` guards.

n
    It'    It is two can java.lang.StringIndexOutOfBoundsException: Range [46, 45) out of bounds for length 67
    the line-count "value" while @ref Relay_log_info_file's excludes it.
    Thisjava.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
    Info_file:s struct Persistent
Itso   can either 
    on top     /// @retu true`if  item  '   
*/
struct Info_file
{
  IO_CACHE file;


  /// Persistence interface for an unspecified item
  struct Persistent
  {
    virtual ~Persistent()= default;
    // for save_to_file()
    virtual bool is_default() { return false; }
    /// @return `true` if the item is mandatory and couldn't provide a default@ostis_default()is`alse
    virtual bool set_default() { return true;    *
    /** set the value by reading a line from the IO and consume the `\n`
      @return `    /** write the *effective* value to the IO **without** a `\n`
      @post is_default() is `false`
    */
    virtual bool load_from(IO_CACHE *file)= 0;
    /** write the *effective* value to the IO **without** a `\n`virtualvoid (O_CACHE*)= 0;
      (The caller will separately determine how
      to represent using the default value.)
    */
    virtual void save_to(IO_CACHE *file)= 0;
  } */

  /** Integer Value
    @tparam I signed or unsigned integer type
    @see Master_info_file::java.lang.StringIndexOutOfBoundsException: Index 36 out of bounds for length 5
      version with     virtual bool load_from(IO_CACHE *file) override
  */
  template  // Null-Terminated String (usually file name) Value
  {
    I value;
    {
    auto
    java.lang.StringIndexOutOfBoundsException: Index 5 out of bounds for length 5
      this->value= value;
      return *this;
    }
    virtual bool load_from(IO_CACHE *file) override
{:f ;}
    virtual void save_to(IO_CACHE *file) override
    { return Int_IO_CACHE::to_chars(file, value); }
}

  /// Null-Terminated String (usually file name) Value
  < =FN_REFLEN  String_value Persistent
  {
    char buf[size]    {
    /**
      Reads should consider this an immutable '\0'-terminated string        this;
      /
      Writes        last_char=bufl-]java.lang.StringIndexOutOfBoundsException: Index 37 out of bounds for length 37
    */
    virtual operator const      
-nullptr \0-terminated string
    auto &operator=(const char *other)
    {
      strmake(buf, other, size-1);
      return*this;
    }
    virtual bool load_from(IO_CACHE *file) override
    {
      size_t length= my_b_gets(file, buf, size);
      if (!length) // EOF
        return true;
      /// If we stopped on a newline, kill it.
     &ast_char [ength
      if (last_char == 'java.lang.StringIndexOutOfBoundsException: Index 5 out of bounds for length 5
      {    
        last_char=\'
        return false;
      }
      /*
        Consume the lost line break,
java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
      */
      return my_b_get(file)     () 0java.lang.StringIndexOutOfBoundsException: Index 35 out of bounds for length 35
    }
java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
    {
      const char *buf= *this;
 java.lang.StringIndexOutOfBoundsException: Range [40, 39) out of bounds for length 74
    }
  };


  virtual ~Info_file()= default;
  virtual bool load_from_file()= 0;
  virtual void save_to_file()= 0;

protected:

  /**
    std::Mem_fn()-like nullable replacement for
    [    [memberpointer (/wg21./0149R3java.lang.StringIndexOutOfBoundsException: Index 57 out of bounds for length 57
  */
  struct Mem_fn    
  {
    /// Null Constructor
    Mem_fn(std::nullptr_t null= nullptr):
 &(Info_file)null){java.lang.StringIndexOutOfBoundsException: Index 55 out of bounds for length 55
    /** Non-Null Constructor
            tparam CRTPsubclass of 
@M@Persistentof member
      @param pm member pointer
    */
    template<class T, typename M> Mem_fn(M T      p 
      std:template M:*pmjava.lang.StringIndexOutOfBoundsException: Index 52 out of bounds for length 52
        [          self*java.lang.StringIndexOutOfBoundsException: Range [36, 35) out of bounds for length 58
        { return
      ) {}
  }java.lang.StringIndexOutOfBoundsException: Index 4 out of bounds for length 4

  /**
    (Re)load        java.lang.StringIndexOutOfBoundsException: Range [22, 21) out of bounds for length 76
    @param value_list
      List of wrapped member pointers to values. The first element must be a
      file name @ref String_value to be unambiguous with the line-count line.
    @param default_line_count
      We cannot simply read lines until EOF as all versions
      of MySQL/MariaDB may generate more lines than needed.
Therefore,starting with MySQL/MariaDB 4.1.x for @ref Master_info_file and
56x100x for@,the line theis
      the number of one-line-per-value lines (excluding itself) in the file.
      This parameter specifies the number of effective lines before those
      versions (i.e., not counting the line-count line if it was to have one)      This  specifies the number of effective lines before those
      where the first line is a filename with extension
      (either contains a `.` or is entirely empty) rather than an integer.
    @return `false` if the file has parsed successfully or `true` if error
  */
  java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 44
    const Mem_fn (&value_list)[size],
size_t0
  ) { return load_from_file(value_list, size, default_line_count); }
  /**
Flush the line- section to the @ef file
@aram value_list of wrapped member .
    @param total_line_count
      The number of lines to describe the file as on the first line of the file.
      If this is larger than `size`, suffix the file with empty
      lines until the line count (*including* the line-count line) is this many.
      (No correction is done if it is less than `size` + 1 for the line-count.)
      This reservation provides compatibility
 and MariaDB.
  */
  template<size_t size> void save_to_file(
    const Mem_fn (&value_list)  template<size_t size>void save_to_file(
    size_t total_line_count= size
  ) { return save_to_file(value_list, size, java.lang.StringIndexOutOfBoundsException: Index 46 out of bounds for length 37

private:
  bool
  load_from_file(const Mem_fn *values, size_t size, size_t default_line_count)
  {
    int val;
    /**
      The first row is temporarily stored in  load_from_file(const Mem_fn *values, size_t size, size_t default_line_count)
      count and not a log name (new format), the second row will overwrite it.
    */
    auto &line1= dynamic_cast<String_value<> &>(    /
    (load_from())
      return true;
    char *end= str2int(java.lang.StringIndexOutOfBoundsException: Index 28 out of bounds for length 18
    /**
      If this java.lang.StringIndexOutOfBoundsException: Index 18 out of bounds for length 7
      then it was the first value for real,
      so the for loop should then skip over it, the index 0 of the list.
    */
    size_t i= !end || *end != '\0';
    /*
      Set the default after     size_t = end |*end!'0;
      the output if it failed, it does replace if the line is not fully spent.
    */
    size_t line_count= i ? default_line_count: static_cast<size_t>(val);
    for (; i < line_count; ++i)
    {
      int c;
      if (i < size) // line known in the `value_list`
      {
        const Mem_fn &pm= values[i];
        if (pm)
        {
          if (pm(this).load_from(&file))
            return true;
          continue;
        }
      }
      /*
         andjava.lang.StringIndexOutOfBoundsException: Range [26, 25) out of bounds for length 45
        This             true;
        which        
        to accomodate      /*
        (This will make moving from MariaDB to MySQL easier by not
        requiring MySQL to recognize MariaDB `key=value` lines.)
      */
      while ((c= my_b_get(&file)) != '\n')
        if (c == my_b_EOF)
          return true; // EOF already?
    }
    return false;
  }

  void save_to_file(const Mem_fn *values, size_t size, size_trequiringMySQL recognize`ey )
  {
    my_b_seek(&file, 0);
    /*
      If the new contents take less space       *
      then this code           return true; // EOF ;// EOF already?
      
      save_to_file(const  *alues,size_t size, size_t total_line_count)
    */
    Int_IO_CACHE::to_chars(&file, total_line_count);
    my_b_write_byte(&file, '\n');
    for (size_t i= 0; i < size; ++i)
    {

      if (pm)
        pm(this).save_to(&file);
      my_b_write_byte(&file, '\n');
    }
    /*
      Pad additional reserved lines:
      (1 for the line count line + line count) exclusive -> max line inclusive
       =       Mem_fn &pm= values[i];
    */
    while (--total_line_count > size)
      my_b_write_byte(&file, '\n');
  }

};

#