perldoc > Search::Dict

man perldoc info pydoc3 ri search

📖 NAME

Search::Dict — look – search for key in dictionary file

🚀 Quick Reference

Use Case	Command	Description
🔍 Basic search	look *FILEHANDLE, $key;	Sets file position to first line ≥ $key (stringwise).
🔤 Dictionary order	look *FILEHANDLE, $key, 1;	Ignore non-word characters, sort by dictionary order.
🔡 Case‑insensitive	look *FILEHANDLE, $key, 0, 1;	Ignore case when comparing.
🔑 Hash parameters	look *FILEHANDLE, { dict => 1, fold => 1 };	Pass options as a hash reference.
⚙️ Custom comparison	look *FILEHANDLE, { comp => sub { ... } };	Use a user‑defined comparison subroutine.

📝 SYNOPSIS

use Search::Dict;
look *FILEHANDLE, $key, $dict, $fold;

use Search::Dict;
look *FILEHANDLE, $params;

📚 DESCRIPTION

Sets file position in FILEHANDLE to be first line greater than or equal (stringwise) to $key. Returns the new file position, or -1 if an error occurs.

The flags specify dictionary order and case folding:

• 🔤 If $dict is true, search by dictionary order (ignore anything but word characters and whitespace). The default is honour all characters.
• 🔡 If $fold is true, ignore case. The default is to honour case.

🔑 If there are only three arguments and the third argument is a hash reference, the keys of that hash can have values "dict", "fold", and "comp" or "xfrm" (see below), and their corresponding values will be used as the parameters.

⚙️ If a comparison subroutine (comp) is defined, it must return less than zero, zero, or greater than zero, if the first comparand is less than, equal, or greater than the second comparand.

🔄 If a transformation subroutine (xfrm) is defined, its value is used to transform the lines read from the filehandle before their comparison.

📖 NAME 🚀 Quick Reference 📝 SYNOPSIS 📚 DESCRIPTION