Skip to main content
  • Home
  • Development
  • Documentation
  • Donate
  • Operational login
  • Browse the archive

swh logo
SoftwareHeritage
Software
Heritage
Archive
Features
  • Search

  • Downloads

  • Save code now

  • Add forge now

  • Help

https://github.com/TakehideSoh/SAF
18 January 2026, 11:53:51 UTC
  • Code
  • Branches (4)
  • Releases (0)
  • Visits
    • Branches
    • Releases
    • HEAD
    • refs/heads/dev
    • refs/heads/main
    • refs/tags/v1.0-cmsb2023
    • refs/tags/v1.1-CMSB2023
    No releases to show
  • 83aaea6
  • /
  • cadical
  • /
  • src
  • /
  • parse.cpp
Raw File Download Save again
Take a new snapshot of a software origin

If the archived software origin currently browsed is not synchronized with its upstream version (for instance when new commits have been issued), you can explicitly request Software Heritage to take a new snapshot of it.

Use the form below to proceed. Once a request has been submitted and accepted, it will be processed as soon as possible. You can then check its processing state by visiting this dedicated page.
swh spinner

Processing "take a new snapshot" request ...

To reference or cite the objects present in the Software Heritage archive, permalinks based on SoftWare Hash IDentifiers (SWHIDs) must be used.
Select below a type of object currently browsed in order to display its associated SWHID and permalink.

  • content
  • directory
  • revision
  • snapshot
origin badgecontent badge
swh:1:cnt:21bb620fdd0e1d7675f9d4e94acd3111afde830b
origin badgedirectory badge
swh:1:dir:01d80ce94d8f49344a6b25660f682eedd134ff96
origin badgerevision badge
swh:1:rev:d26cc9f94a4f79c046ee0cdd3a127a44f7b443b6
origin badgesnapshot badge
swh:1:snp:d3fcf0e446f52630e867f11dee4c2c828bf46951

This interface enables to generate software citations, provided that the root directory of browsed objects contains a citation.cff or codemeta.json file.
Select below a type of object currently browsed in order to generate citations for them.

  • content
  • directory
  • revision
  • snapshot
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Tip revision: d26cc9f94a4f79c046ee0cdd3a127a44f7b443b6 authored by TakehideSoh on 23 June 2023, 07:02:26 UTC
Merge pull request #2 from TakehideSoh/dev
Tip revision: d26cc9f
parse.cpp
#include "internal.hpp"

/*------------------------------------------------------------------------*/

namespace CaDiCaL {

/*------------------------------------------------------------------------*/

// Parse error.

#define PER(...) \
do { \
  internal->error_message.init ("%s:%" PRIu64 ": parse error: ", \
    file->name (), (uint64_t) file->lineno ()); \
  return internal->error_message.append (__VA_ARGS__); \
} while (0)

/*------------------------------------------------------------------------*/

// Parsing utilities.

inline int Parser::parse_char () { return file->get (); }

// Return an non zero error string if a parse error occurred.

inline const char *
Parser::parse_string (const char * str, char prev) {
  for (const char * p = str; *p; p++)
    if (parse_char () == *p) prev = *p;
    else if (*p == ' ') PER ("expected space after '%c'", prev);
    else PER ("expected '%c' after '%c'", *p, prev);
  return 0;
}

inline const char *
Parser::parse_positive_int (int & ch, int & res, const char * name) {
  assert (isdigit (ch));
  res = ch - '0';
  while (isdigit (ch = parse_char ())) {
    int digit = ch - '0';
    if (INT_MAX/10 < res || INT_MAX - digit < 10*res)
      PER ("too large '%s' in header", name);
    res = 10*res + digit;
  }
  return 0;
}

static const char * cube_token = "unexpected 'a' in CNF";

inline const char *
Parser::parse_lit (int & ch, int & lit, int & vars, int strict) {
  if (ch == 'a')
    return cube_token;
  int sign = 0;
  if (ch == '-') {
    if (!isdigit (ch = parse_char ())) PER ("expected digit after '-'");
    sign = -1;
  } else if (!isdigit (ch)) PER ("expected digit or '-'");
  else sign = 1;
  lit = ch - '0';
  while (isdigit (ch = parse_char ())) {
    int digit = ch - '0';
    if (INT_MAX/10 < lit || INT_MAX - digit < 10*lit)
      PER ("literal too large");
    lit = 10*lit + digit;
  }
  if (ch == '\r') ch = parse_char ();
  if (ch != 'c' && ch != ' ' && ch != '\t' && ch != '\n' && ch != EOF)
    PER ("expected white space after '%d'", sign*lit);
  if (lit > vars) {
    if (strict != FORCED)
      PER ("literal %d exceeds maximum variable %d", sign*lit, vars);
    else vars = lit;
  }
  lit *= sign;
  return 0;
}

/*------------------------------------------------------------------------*/

// Parsing CNF in DIMACS format.

const char * Parser::parse_dimacs_non_profiled (int & vars, int strict) {

#ifndef QUIET
  double start = internal->time ();
#endif

  bool found_inccnf_header = false;
  int ch, clauses = 0;
  vars = 0;

  // First read comments before header with possibly embedded options.
  //
  for (;;) {
    ch = parse_char ();
    if (strict != STRICT)
      if (ch == ' ' || ch == '\n' || ch == '\t' || ch == '\r') continue;
    if (ch != 'c') break;
    string buf;
    while ((ch = parse_char ()) != '\n')
      if (ch == EOF) PER ("unexpected end-of-file in header comment");
      else if (ch != '\r') buf.push_back (ch);
    const char * o;
    for (o = buf.c_str (); *o && *o != '-'; o++)
      ;
    if (!*o) continue;
    PHASE ("parse-dimacs", "found option '%s'", o);
    if (*o) solver->set_long_option (o);
  }

  if (ch != 'p') PER ("expected 'c' or 'p'");

  ch = parse_char ();
  if (strict == STRICT) {
    if (ch != ' ') PER ("expected space after 'p'");
    ch = parse_char ();
  } else if (ch != ' ' && ch != '\t')
    PER ("expected white space after 'p'");
  else {
    do ch = parse_char (); while (ch == ' ' || ch == '\t');
  }

  // Now read 'p cnf <var> <clauses>' header of DIMACS file
  // or 'p inccnf' of incremental 'INCCNF' file.
  //
  if (ch == 'c')
    {
      assert (!found_inccnf_header);
      if (strict == STRICT) {
        const char * err = parse_string ("nf ", 'c');
        if (err) return err;
        ch = parse_char ();
        if (!isdigit (ch)) PER ("expected digit after 'p cnf '");
        err = parse_positive_int (ch, vars, "<max-var>");
        if (err) return err;
        if (ch != ' ') PER ("expected ' ' after 'p cnf %d'", vars);
        if (!isdigit (ch = parse_char ()))
          PER ("expected digit after 'p cnf %d '", vars);
        err = parse_positive_int (ch, clauses, "<num-clauses>");
        if (err) return err;
        if (ch != '\n')
          PER ("expected new-line after 'p cnf %d %d'", vars, clauses);
      } else {
        if (parse_char () != 'n') PER ("expected 'n' after 'p c'");
        if (parse_char () != 'f') PER ("expected 'f' after 'p cn'");
        ch = parse_char ();
        if (!isspace (ch)) PER ("expected space after 'p cnf'");
        do ch = parse_char (); while (isspace (ch));
        if (!isdigit (ch)) PER ("expected digit after 'p cnf '");
        const char * err = parse_positive_int (ch, vars, "<max-var>");
        if (err) return err;
        if (!isspace (ch)) PER ("expected space after 'p cnf %d'", vars);
        do ch = parse_char (); while (isspace (ch));
        if (!isdigit (ch)) PER ("expected digit after 'p cnf %d '", vars);
        err = parse_positive_int (ch, clauses, "<num-clauses>");
        if (err) return err;
        while (ch != '\n') {
          if (ch != '\r' && !isspace (ch))
            PER ("expected new-line after 'p cnf %d %d'", vars, clauses);
          ch = parse_char ();
        }
      }

      MSG ("found %s'p cnf %d %d'%s header",
        tout.green_code (), vars, clauses, tout.normal_code ());

      if (strict != FORCED)
        solver->reserve (vars);
    }
  else if (!parse_inccnf_too)
    PER ("expected 'c' after 'p '");
  else if (ch == 'i')
    {
      found_inccnf_header = true;
      const char * err = parse_string ("nccnf", 'i');
      if (err) return err;
      ch = parse_char ();
      if (strict == STRICT) {
        if (ch != '\n')
          PER ("expected new-line after 'p inccnf'");
      } else {
        while (ch != '\n')
          {
            if (ch != '\r' && !isspace (ch))
              PER ("expected new-line after 'p inccnf'");
            ch = parse_char ();
          }
      }

      MSG ("found %s'p inccnf'%s header",
        tout.green_code (), tout.normal_code ());

      strict = FORCED;
    }
  else
    PER ("expected 'c' or 'i' after 'p '");

  if (parse_inccnf_too)
    *parse_inccnf_too = false;

  // Now read body of DIMACS part.
  //
  int lit = 0, parsed = 0;
  while ((ch = parse_char ()) != EOF) {
    if (ch == ' ' || ch == '\n' || ch == '\t' || ch == '\r') continue;
    if (ch == 'c') {
      while ((ch = parse_char ()) != '\n' && ch != EOF)
        ;
      if (ch == EOF) break;
      continue;
    }
    if (ch == 'a' && found_inccnf_header) break;
    const char * err = parse_lit (ch, lit, vars, strict);
    if (err) return err;
    if (ch == 'c') {
      while ((ch = parse_char ()) != '\n')
        if (ch == EOF)
          PER ("unexpected end-of-file in comment");
    }
    solver->add (lit);
    if (!found_inccnf_header &&
        !lit && parsed++ >= clauses && strict != FORCED)
      PER ("too many clauses");
  }

  if (lit) PER ("last clause without terminating '0'");

  if (!found_inccnf_header && parsed < clauses && strict != FORCED)
    PER ("clause missing");

#ifndef QUIET
  double end = internal->time ();
  MSG ("parsed %d clauses in %.2f seconds %s time",
    parsed, end - start, internal->opts.realtime ? "real" : "process");
#endif

#ifndef QUIET
  start = end;
#endif
  size_t num_cubes = 0;
  if (ch == 'a') {
    assert (parse_inccnf_too);
    assert (found_inccnf_header);
    if (!*parse_inccnf_too) *parse_inccnf_too = true;
    for (;;) {
      ch = parse_char ();
      if (ch == ' ' || ch == '\n' || ch == '\t' || ch == '\r')
        continue;
      if (ch == 'c') {
        while ((ch = parse_char ()) != '\n' && ch != EOF)
          ;
        if (ch == EOF) break;
        continue;
      }
      const char * err = parse_lit (ch, lit, vars, strict);
      if (err == cube_token) PER ("two 'a' in a row");
      else if (err) return err;
      if (ch == 'c') {
        while ((ch = parse_char ()) != '\n')
          if (ch == EOF)
            PER ("unexpected end-of-file in comment");
      }
      if (cubes)
        cubes->push_back (lit);
      if (!lit) {
        num_cubes++;
        for (;;)
          {
            ch = parse_char ();
            if (ch == ' ' || ch == '\n' || ch == '\t' || ch == '\r')
              continue;
            if (ch == 'c') {
              while ((ch = parse_char ()) != '\n' && ch != EOF)
                ;
              if (ch == EOF) break;
            }
            if (ch == EOF) break;
            if (ch != 'a')
              PER ("expected 'a' or end-of-file after zero");
            lit = INT_MIN;
            break;
          }
        if (ch == EOF) break;
      }
    }
    if (lit) PER ("last cube without terminating '0'");
  }
#ifndef QUIET
  if (found_inccnf_header)
    {
      double end = internal->time ();
      MSG ("parsed %zd cubes in %.2f seconds %s time",
        num_cubes, end - start, internal->opts.realtime ? "real" : "process");
    }
#endif

  return 0;
}

/*------------------------------------------------------------------------*/

// Parsing solution in competition output format.

const char * Parser::parse_solution_non_profiled () {
  external->solution = new signed char [ external->max_var + 1u ];
  clear_n (external->solution, external->max_var + 1u);
  int ch;
  for (;;) {
    ch = parse_char ();
    if (ch == EOF) PER ("missing 's' line");
    else if (ch == 'c') {
      while ((ch = parse_char ()) != '\n')
        if (ch == EOF) PER ("unexpected end-of-file in comment");
    } else if (ch == 's') break;
    else PER ("expected 'c' or 's'");
  }
  const char * err = parse_string (" SATISFIABLE", 's');
  if (err) return err;
  if ((ch = parse_char ()) == '\r') ch = parse_char ();
  if (ch != '\n') PER ("expected new-line after 's SATISFIABLE'");
  int count = 0;
  for (;;) {
    ch = parse_char ();
    if (ch != 'v') PER ("expected 'v' at start-of-line");
    if ((ch = parse_char ()) != ' ') PER ("expected ' ' after 'v'");
    int lit = 0; ch = parse_char ();
    do {
      if (ch == ' ' || ch == '\t') { ch = parse_char (); continue; }
      err = parse_lit (ch, lit, external->max_var, false);
      if (err) return err;
      if (ch == 'c') PER ("unexpected comment");
      if (!lit) break;
      if (external->solution[abs (lit)])
        PER ("variable %d occurs twice", abs (lit));
      LOG ("solution %d", lit);
      external->solution [abs (lit)] = sign (lit);
      count++;
      if (ch == '\r') ch = parse_char ();
    } while (ch != '\n');
    if (!lit) break;
  }
  MSG ("parsed %d values %.2f%%",
    count, percent (count, external->max_var));
  return 0;
}

/*------------------------------------------------------------------------*/

// Wrappers to profile parsing and at the same time use the convenient
// implicit 'return' in PER in the non-profiled versions.

const char * Parser::parse_dimacs (int & vars, int strict) {
  assert (strict == FORCED || strict == RELAXED || strict == STRICT);
  START (parse);
  const char * err = parse_dimacs_non_profiled (vars, strict);
  STOP (parse);
  return err;
}

const char * Parser::parse_solution () {
  START (parse);
  const char * err = parse_solution_non_profiled ();
  STOP (parse);
  return err;
}

}

back to top

Software Heritage — Copyright (C) 2015–2026, The Software Heritage developers. License: GNU AGPLv3+.
The source code of Software Heritage itself is available on our development forge.
The source code files archived by Software Heritage are available under their own copyright and licenses.
Terms of use: Archive access, API— Content policy— Contact— JavaScript license information— Web API