ls-standard-library/include/ls-std/io/FileOutputStream.hpp

/*
 * Author:          Patrick-Christopher Mattulat
 * Co-Author:       Claude Sonnet 4.6 (LLM)
 * Company:         Lynar Studios
 * E-Mail:          webmaster@lynarstudios.com
 * Created:         2020-08-20
 * Changed:         2026-06-23
 *
 * */

#ifndef LS_STD_FILE_OUTPUT_STREAM_HPP
#define LS_STD_FILE_OUTPUT_STREAM_HPP

#include "File.hpp"
#include <fstream>
#include <ls-std/core/Class.hpp>
#include <ls-std/core/interface/IWriter.hpp>
#include <ls-std/os/dynamic-goal.hpp>

/*
 * @doc: class(name: 'FileOutputStream', package: 'io')
 * @doc: io.FileOutputStream.description('This class can be used for writing to a file stream.')
 * */

namespace ls::standard::io
{
  class LS_STD_DYNAMIC_GOAL FileOutputStream : public ls::standard::core::Class, public ls::standard::core::interface_type::IWriter
  {
    public:

      explicit FileOutputStream(const ls::standard::io::File &_file);
      explicit FileOutputStream(const ls::standard::io::File &_file, bool _append);
      ~FileOutputStream() noexcept override;

      void close();
      bool write(const ls::standard::core::type::byte_field &_data) override; // nodiscard is optional here

    private:

      bool append{};
      ls::standard::io::File file;
      ::std::ofstream outputStream{};

      void _close();
      void _init();
  };
}

#endif