CSV data source

Refer to Developer Guide: CSV data source.

Programming Interface

All types and functions in this section are declared in the oneapi::dal::csv namespace and be available via inclusion of the oneapi/dal/io/csv.hpp header file.

enum class read_options : std::uint64_t {
   none = 0,
   parse_header = 1 << 0
};

constexpr char default_delimiter = ',';
constexpr read_options default_read_options = read_options::none;

class data_source {
public:
   data_source(const char *file_name,
               char delimiter = default_delimiter,
               read_options opts = default_read_options);

   data_source(const std::string &file_name,
               char delimiter = default_delimiter,
               read_options opts = default_read_options);

   std::string get_file_name() const;
   char get_delimiter() const;
   read_options get_read_options() const;
};
class data_source
data_source(const char *file_name, char delimiter = default_delimiter, read_options opts = default_read_options)

Creates a new instance of a CSV data source with the given file_name, delimiter and read options opts flag.

data_source(const std::string &file_name, char delimiter = default_delimiter, read_options opts = default_read_options)

Creates a new instance of a CSV data source with the given file_name, delimiter and read options opts flag.

std::string file_name = ""

A string that contains the name of the file with the dataset to read.

Getter
std::string get_filename() const
char delimiter = default_delimiter

A character that represents the delimiter between separate features in the input file.

Getter
char get_delimter() const
read_options options = default_read_options

Value that stores read options to be applied during reading of the input file. Enabled parse_header option indicates that the first line in the input file is processed as a header record with features names.

Getter
read_options get_read_options() const

Reading oneapi::dal::read<Object>(...)

Args

template <typename Object>
class read_args {
public:
   read_args();
};
template<typename Object>
class read_args
read_args()

Creates args for the read operation with the default attribute values.

Operation

oneapi::dal::table is the only supported value of the Object template parameter for read operation with CSV data source.

template<typename Object, typename DataSource>
Object read(const DataSource &ds)
Template Parameters
  • Object – oneDAL object type that is produced as a result of reading from the data source.

  • DataSource – CSV data source csv::data_source.

Usage example

using namespace oneapi;

const auto data_source = dal::csv::data_source("data.csv", ',');

const auto table = dal::read<dal::table>(data_source);