File::M...o::Magic(3)

💖 NAME 💖

File::MimeInfo::Magic — determine file type with magic. ✨

okay bestie, this is the File::M...o::Magic(3) page — User Contributed Perl Documentation — and it's literally all about File::MimeInfo::Magic. 💅

✨ SYNOPSIS ✨

use File::MimeInfo::Magic;
my $mime_type = mimetype($file);

🦋 DESCRIPTION 🦋

This module inherits from File::MimeInfo. It's transparent to its functions but adds support for the freedesktop magic file. 🎀

Magic data is hashed when you need it for the first time. If you want to force hashing earlier, use the rehash() function. 🔥

🎀 EXPORT 🎀

The method mimetype is exported by default. The methods magic, inodetype, globs and describe can be exported on demand. periodt. 💖

🌈 METHODS 🌈

See also File::MimeInfo for methods that are inherited. 🫶

💖 mimetype($file)

Returns a mime-type string for $file, returns undef on failure. 😭

This method bundles inodetype(), globs() and magic(). The way that it works: magic rules with a priority of 80 and higher are checked before globs() is called, all other magic rules afterwards. ⭐

If this doesn't work, the file is read and the mime-type defaults to 'text/plain' or to 'application/octet-stream' when the first ten chars of the file match ascii control chars (white spaces excluded). If the file doesn't exist or isn't readable, undef is returned. 💀

If $file is an object reference, only magic and the default method are used. See below for details. 👀

🔥 magic($file)

Returns a mime-type string for $file based on the magic rules, returns undef on failure. 🌸

$file can be an object reference; in that case it is supposed to have a seek() and a read() method. This allows you, for example, to determine the mimetype of data in memory by using IO::Scalar. 🧚

Be aware that when using a filehandle or an IO:: object you need to set the :utf8 binmode yourself if appropriate. 🙈

🎀 rehash()

Rehash the data files. Glob and magic information is preparsed when this method is called. 💫

If you want to by-pass the XDG basedir system you can specify your database directories by setting @File::MimeInfo::DIRS. But normally it is better to change the XDG basedir environment variables. 👑

🫶 "default", "describe", "extensions", "globs", "inodetype"

These routines are imported from File::MimeInfo. 💜

🌟 SEE ALSO 🌟

• File::MimeInfo

💀 LIMITATIONS 💀

Only word sizes of 1, 2 or 4 are supported. Any other word size is ignored and will cause a warning. ⚠️

👑 AUTHOR 👑

Jaap Karssenberg <pardus@cpan.org> — maintained by Michiel Beijen <mb@x14.nl>. 🫡

🍓 COPYRIGHT 🍓

Copyright (c) 2003, 2012 Jaap G Karssenberg. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 📜

---

mwah 💋 — that's a wrap, bestie. This page is signed off with perl v5.42.0, dated 2024-04-26, and filed under File::M...o::Magic(3). 💖✨