Create a module for parsing functions

/*! \file Parsers.cpp

 */

#include <fstream>

#include <string>

#include "include/List.h"

#include "include/Parsers.h"

std::string *load_file(std::string file_name, int *count = 0) {

  std::fstream input_file(file_name.c_str(), std::ios::in);

  List<std::string> file_lines = List<std::string>();

  std::string line;

  if (input_file.is_open()) {

    getline(input_file, line);

    file_lines.set(0, line);

    while (getline(input_file, line)) {

      file_lines.append(line);

    }

    input_file.close();

  } else {

	  throw FILE_NOT_FOUND_ERROR;

  }

  std::string *array_lines = file_lines.to_array();

  if (count != 0) *count = file_lines.length();

  return array_lines;

}

/*! \file Parsers.h

 */

#ifndef INCLUDE_PARSERS_H_

#define INCLUDE_PARSERS_H_

#ifndef FILE_NOT_FOUND_ERROR

//! Error code if a file is not found.

#define FILE_NOT_FOUND_ERROR 21

#endif

/*! \brief Load a text file as a sequence of strings in memory.

 *

 * The configuration of the field expansion code in FORTRAN uses

 * shared memory access and file I/O operations managed by different

 * functions. Although this approach could be theoretically replicated,

 * it is more convenient to handle input and output to distinct files

 * using specific functions. load_file() helps in the task of handling

 * input such as configuration files or text data structures that need

 * to be loaded entirely. The function performs a line-by line scan of

 * the input file and returns an array of strings that can be later

 * parsed and ingested by the concerned code blocks. An optional pointer

 * to integer allows the function to keep track of the number of file

 * lines that were read, if needed.

 *

 * \param file_name: `string` The path of the file to be read.

 * \param count: `int*` Pointer to an integer recording the number of

 * read lines [OPTIONAL, default=NULL].

 * \return array_lines `string*` An array of strings, one for each input

 * file line.

 */

std::string *load_file(std::string file_name, int *count);

#endif /* INCLUDE_PARSERS_H_ */