open_composite_reader()

std::shared_ptr< CompositeReader > MayaFlux::IO::IOManager::open_composite_reader	(	const std::string &	filepath,
		std::optional< Kakshya::CompositeLayout >	layout = std::nullopt
	)

Open a schema-bearing reader selected by file format.

CSV and TSV currently use DelimitedTextReader. The returned reader is owned by the caller and can inspect its layout or read bounded batches. IOManager does not retain it or register it with IOService.

Parameters

filepath	Path to a supported Composite file.
layout	Optional exact field layout. Without one, CSV/TSV fields are preserved as UTF-8 text.

Returns

Open reader, or nullptr for an unsupported or invalid file.

Definition at line 786 of file IOManager.cpp.

{
    auto delimited = std::make_shared<DelimitedTextReader>();
    if (!delimited->can_read(filepath)) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::open_composite_reader: unsupported format '{}'", filepath);
        return nullptr;
    }
 
    if (layout && !delimited->set_layout(std::move(*layout))) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::open_composite_reader: failed to set layout for '{}'", filepath);
        return nullptr;
    }
 
    if (!delimited->open(filepath)) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::open_composite_reader: failed to open '{}' because {}",
            filepath, delimited->get_last_error());
        return nullptr;
    }
 
    return delimited;
}

References MayaFlux::Journal::API, MayaFlux::Journal::FileIO, and MF_ERROR.

Referenced by load_composite().

Here is the caller graph for this function: