Database Loading

Magic database loading methods. More...

Collaboration diagram for Database Loading:

Functions
void	Recognition::Magic::LoadDatabaseFile (const std::filesystem::path &database_file=DEFAULT_DATABASE_FILE)
	Load a magic database file.
bool	Recognition::Magic::LoadDatabaseFile (const std::nothrow_t &tag, const std::filesystem::path &database_file=DEFAULT_DATABASE_FILE) noexcept
	Load a magic database file (noexcept version).

Detailed Description

Magic database loading methods.

Methods for loading magic database files to enable identification.

Function Documentation

LoadDatabaseFile() [1/2]

void Recognition::Magic::LoadDatabaseFile

(

const std::filesystem::path &

database_file = DEFAULT_DATABASE_FILE

)

Load a magic database file.

Loads the specified magic database file into the Magic instance. Must be called after Open() before file identification can be performed.

Parameters

[in]

database_file

Path to the database file (default: DEFAULT_DATABASE_FILE).

Exceptions

MagicIsClosed	If the Magic instance is closed.
EmptyPath	If database_file path is empty.
PathDoesNotExist	If database_file does not exist.
PathIsNotRegularFile	If database_file is not a regular file.
MagicLoadDatabaseFileError	If loading fails.

Magic magic;
magic.Open(Magic::Flags::Mime);
magic.LoadDatabaseFile();  // Load default database
 
// Or load custom database
magic.LoadDatabaseFile("/custom/magic");

Note

The ".mgc" extension is automatically appended if appropriate.

See also

Open()

IsDatabaseLoaded()

Since

10.0.0

Examples

magic_examples.cpp.

LoadDatabaseFile() [2/2]

bool Recognition::Magic::LoadDatabaseFile ( const std::nothrow_t & tag, const std::filesystem::path & database_file = DEFAULT_DATABASE_FILE )

nodiscardnoexcept

Load a magic database file (noexcept version).

Parameters

[in]	tag	Pass std::nothrow to select this overload.
[in]	database_file	Path to the database file (default: DEFAULT_DATABASE_FILE).

Returns

true on success, false on failure.

Note

The ".mgc" extension is automatically appended if appropriate.

Since

10.0.0