Initial commit of OpenSPARC T2 design and verification files.

[OpenSPARC-T2-DV] / tools / perl-5.8.0 / lib / site_perl / 5.8.0 / ewhutil.pl

##---------------------------------------------------------------------------##
##  File:
##      $Id: ewhutil.pl,v 2.9 2002/09/25 03:51:13 ehood Exp $
##  Author:
##      Earl Hood       mhonarc@mhonarc.org
##  Description:
##      Generic utility routines
##---------------------------------------------------------------------------##
##    Copyright (C) 1996-2001   Earl Hood, mhonarc@mhonarc.org
##
##    This program is free software; you can redistribute it and/or modify
##    it under the terms of the GNU General Public License as published by
##    the Free Software Foundation; either version 2 of the License, or
##    (at your option) any later version.
##
##    This program is distributed in the hope that it will be useful,
##    but WITHOUT ANY WARRANTY; without even the implied warranty of
##    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
##    GNU General Public License for more details.
##
##    You should have received a copy of the GNU General Public License
##    along with this program; if not, write to the Free Software
##    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
##    02111-1307, USA
##---------------------------------------------------------------------------##

package mhonarc;

my %HTMLSpecials = (
 '"'   => '"',
 '&'   => '&',
 '<'   => '&lt;',
 '>'   => '&gt;',
);

##---------------------------------------------------------------------------
##      Remove duplicates in an array.
##      Returns list with duplicates removed.
##
sub remove_dups {
   my $a = shift;
   return ()  unless scalar(@$a);
   my %dup = ();
   grep(!$dup{$_}++, @$a);
}

##---------------------------------------------------------------------------
##      "Entify" special characters

sub htmlize {                   # Older name
   return ''  unless scalar(@_) && defined($_[0]);
   my($txt) = $_[0];
   $txt =~ s/(["&<>])/$HTMLSpecials{$1}/g;
   $txt;
}

sub entify {                    # Newer name
   return ''  unless scalar(@_) && defined($_[0]);
   my($txt) = $_[0];
   $txt =~ s/(["&<>])/$HTMLSpecials{$1}/g;
   $txt;
}

##      commentize entifies certain characters to avoid problems when a
##      string will be included in a comment declaration

sub commentize {
   my($txt) = $_[0];
   $txt =~ s/([\-&])/'&#'.unpack('C',$1).';'/ge;
   $txt;
}

sub uncommentize {
   my($txt) = $_[0];
   $txt =~ s/&#(\d+);/pack("C",$1)/ge;
   $txt;
}

##---------------------------------------------------------------------------
##      Copy a file.
##
sub cp {
   my($src, $dst) = @_;
   open(SRC, $src) || die("ERROR: Unable to open $src\n");
   open(DST, "> $dst") || die("ERROR: Unable to create $dst\n");
   print DST <SRC>;
   close(SRC);
   close(DST);
}

##---------------------------------------------------------------------------
##      Translate html string back to regular string
##
sub dehtmlize {
   my($str) = shift;
   $str =~ s/\&lt;/</g;
   $str =~ s/\&gt;/>/g;
   $str =~ s/\&amp;/\&/g;
   $str;
}

##---------------------------------------------------------------------------
##      Escape special characters in string for URL use.
##
sub urlize {
   my($url) = shift || "";
   $url =~ s/([^\w@\.\-])/sprintf("%%%X",unpack("C",$1))/ge;
   $url;
}

##---------------------------------------------------------------------------##
##      Perform a "modified" rot13 on a string.  This version includes
##      the '@' character so addresses can be munged a little better.
##
sub mrot13 {
   my $str     = shift;
   $str =~ tr/@A-Z[a-z/N-Z[@A-Mn-za-m/;
   $str;
}

##---------------------------------------------------------------------------##
1;