output-spec.h

Go to the documentation of this file.

/* Support for the DSL of -fdiagnostics-add-output= and
   -fdiagnostics-set-output=.
   Copyright (C) 2024-2025 Free Software Foundation, Inc.
 
This file is part of GCC.
 
GCC is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 3, or (at your option) any later
version.
 
GCC is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.
 
You should have received a copy of the GNU General Public License
along with GCC; see the file COPYING3.  If not see
<http://www.gnu.org/licenses/>.  */
 
#ifndef GCC_DIAGNOSTICS_OUTPUT_SPEC_H
#define GCC_DIAGNOSTICS_OUTPUT_SPEC_H
 
#include "diagnostics/sink.h"
#include "diagnostics/output-file.h"
 
namespace diagnostics {
namespace output_spec {
 
/* An abstract base class for handling the DSL of -fdiagnostics-add-output=
   and -fdiagnostics-set-output=.  */
 
class context
{
 public:
  std::unique_ptr<sink>
  parse_and_make_sink (const char *,
                       diagnostics::context &dc);
 
  void
  report_error (const char *gmsgid, ...) const
    ATTRIBUTE_GCC_DIAG(2,3);
 
  void
  report_unknown_key (const char *unparsed_arg,
                      const std::string &key,
                      const std::string &scheme_name,
                      auto_vec<const char *> &known_keys) const;
 
  void
  report_missing_key (const char *unparsed_arg,
                      const std::string &key,
                      const std::string &scheme_name,
                      const char *metavar) const;
 
  output_file
  open_output_file (label_text &&filename) const;
 
  const char *
  get_option_name () const { return m_option_name; }
 
  line_maps *
  get_affected_location_mgr () const { return m_affected_location_mgr; }
 
  virtual ~context () {}
 
  virtual void
  report_error_va (const char *gmsgid, va_list *ap) const = 0;
 
  virtual const char *
  get_base_filename () const = 0;
 
protected:
  context (const char *option_name,
           line_maps *affected_location_mgr)
  : m_option_name (option_name),
    m_affected_location_mgr (affected_location_mgr)
  {
  }
 
  const char *m_option_name;
  line_maps *m_affected_location_mgr;
};
 
/* A subclass that implements reporting errors via a diagnostics::context.  */
 
struct dc_spec_context : public output_spec::context
{
public:
  dc_spec_context (diagnostics::context &dc,
                   line_maps *affected_location_mgr,
                   line_maps *control_location_mgr,
                   location_t loc,
                   const char *option_name)
  : context (option_name, affected_location_mgr),
    m_dc (dc),
    m_control_location_mgr (control_location_mgr),
    m_loc (loc)
  {}
 
  void report_error_va (const char *gmsgid, va_list *ap) const final override
    ATTRIBUTE_GCC_DIAG(2, 0)
  {
    m_dc.begin_group ();
    rich_location richloc (m_control_location_mgr, m_loc);
    m_dc.diagnostic_impl (&richloc, nullptr, -1, gmsgid, ap, kind::error);
    m_dc.end_group ();
  }
 
  diagnostics::context &m_dc;
  line_maps *m_control_location_mgr;
  location_t m_loc;
};
 
} // namespace output_spec
} // namespace diagnostics
 
#endif // #ifndef GCC_DIAGNOSTICS_OUTPUT_SPEC_H