* Synced the perlfaq

[p5sagit/p5-mst-13.2.git] / lib / look.pl

diff --git a/lib/look.pl b/lib/look.pl
index 4c14e64..fec31fe 100644 (file)
--- a/lib/look.pl
+++ b/lib/look.pl
@@ -1,4 +1,15 @@
 ;# Usage: &look(*FILEHANDLE,$key,$dict,$fold)
+#
+# This library is no longer being maintained, and is included for backward
+# compatibility with Perl 4 programs which may require it.
+# This legacy library is deprecated and will be removed in a future
+# release of perl.
+#
+# In particular, this should not be used as an example of modern Perl
+# programming techniques.
+
+warn( "The 'look.pl' legacy library is deprecated and will be"
+      . " removed in the next major release of perl." );
 
 ;# Sets file position in FILEHANDLE to be first line greater than or equal
 ;# (stringwise) to $key.  Pass flags for dictionary order and case folding.
@@ -10,7 +21,7 @@ sub look {
        $blksize,$blocks) = stat(FH);
     $blksize = 8192 unless $blksize;
     $key =~ s/[^\w\s]//g if $dict;
-    $key =~ y/A-Z/a-z/ if $fold;
+    $key = lc $key if $fold;
     $max = int($size / $blksize);
     while ($max - $min > 1) {
        $mid = int(($max + $min) / 2);
@@ -19,7 +30,7 @@ sub look {
        $_ = <FH>;
        chop;
        s/[^\w\s]//g if $dict;
-       y/A-Z/a-z/ if $fold;
+       $_ = lc $_ if $fold;
        if ($_ lt $key) {
            $min = $mid;
        }
@@ -33,7 +44,7 @@ sub look {
     while (<FH>) {
        chop;
        s/[^\w\s]//g if $dict;
-       y/A-Z/a-z/ if $fold;
+       $_ = lc $_ if $fold;
        last if $_ ge $key;
        $min = tell(FH);
     }