| 1 | ## -*- Mode: CPerl -*- | ||
| 2 | ## File: Lingua::TT::DBx::Enum.pm | ||
| 3 | ## Author: Bryan Jurish <TT/IO.pm> | ||
| 4 | ## Descript: TT I/O: Berkely DB: enums | ||
| 5 | |||
| 6 | |||
| 7 | package Lingua::TT::DBx::Enum_HH; | ||
| 8 | use Lingua::TT::DBFile; | ||
| 9 | #use Lingua::TT::DBFile::Array; | ||
| 10 | use DB_File; | ||
| 11 | use Fcntl; | ||
| 12 | use Carp; | ||
| 13 | use strict; | ||
| 14 | |||
| 15 | ##============================================================================== | ||
| 16 | ## Globals & Constants | ||
| 17 | |||
| 18 | our @ISA = qw(); | ||
| 19 | |||
| 20 | ##============================================================================== | ||
| 21 | ## Constructors etc. | ||
| 22 | |||
| 23 | ## $dbe = CLASS_OR_OBJECT->new(%opts) | ||
| 24 | ## + %opts, %$doc: | ||
| 25 | ## ##-- user options | ||
| 26 | ## file => $basename, ##-- file basename; default=undef (none) | ||
| 27 | ## opts_s2i => \%opts, ##-- Lingua::TT::DBFile options for 's2i' file | ||
| 28 | ## opts_i2s => \%opts, ##-- Lingua::TT::DBFile options for 'i2s' file | ||
| 29 | ## ## | ||
| 30 | ## ##-- low-level data | ||
| 31 | ## s2i => $s2i, ##-- Lingua::TT::DBFile object for 'sym2id' | ||
| 32 | ## i2s => $i2s, ##-- Lingua::TT::DBFile object for 'id2sym' | ||
| 33 | ## sym2id => \%sym2id, ##-- ref to tied data: $sym => $id | ||
| 34 | ## id2sym => \%id2sym, ##-- ref to tied data: $id => $sym | ||
| 35 | ## size => $n_ids, ##-- number of allocated ids (== index of first free id) | ||
| 36 | sub new { | ||
| 37 | my $that = shift; | ||
| 38 | my $dbe = bless({ | ||
| 39 | file => undef, | ||
| 40 | opts_s2i => { type=>'HASH' }, | ||
| 41 | opts_i2s => { type=>'HASH' }, | ||
| 42 | s2i => undef, | ||
| 43 | i2s => undef, | ||
| 44 | sym2id => undef, | ||
| 45 | id2sym => undef, | ||
| 46 | size => undef, | ||
| 47 | @_ | ||
| 48 | }, ref($that)||$that); | ||
| 49 | return $dbe->open($dbe->{file}) if (defined($dbe->{file})); | ||
| 50 | return $dbe; | ||
| 51 | } | ||
| 52 | |||
| 53 | ## undef = $dbe->clear() | ||
| 54 | sub clear { | ||
| 55 | my $dbe = shift; | ||
| 56 | return if (!$dbe->opened); | ||
| 57 | $dbe->{s2i}->clear; | ||
| 58 | $dbe->{i2s}->clear; | ||
| 59 | $dbe->{size} = 0; | ||
| 60 | return $dbe; | ||
| 61 | } | ||
| 62 | |||
| 63 | ##============================================================================== | ||
| 64 | ## Methods: I/O | ||
| 65 | |||
| 66 | ## $bool = $dbe->opened() | ||
| 67 | sub opened { | ||
| 68 | return defined($_[0]{s2i}); | ||
| 69 | } | ||
| 70 | |||
| 71 | ## $dbe = $dbe->close() | ||
| 72 | sub close { | ||
| 73 | my $dbe = shift; | ||
| 74 | @$dbe{qw(sym2id id2sym size)} = qw(); | ||
| 75 | $dbe->{s2i}->close if ($dbe->{s2i}); | ||
| 76 | $dbe->{i2s}->close if ($dbe->{i2s}); | ||
| 77 | return $dbe; | ||
| 78 | } | ||
| 79 | |||
| 80 | ## $dbe = $dbe->open($file,%opts) | ||
| 81 | ## + %opts are as for new() | ||
| 82 | sub open { | ||
| 83 | my ($dbe,$file,%opts) = @_; | ||
| 84 | $dbe->close() if ($dbe->opened()); | ||
| 85 | $dbe->{file} = $file; | ||
| 86 | @$dbe{keys %opts} = values(%opts); | ||
| 87 | |||
| 88 | $dbe->{s2i} = Lingua::TT::DBFile->new(%{$dbe->{opts_s2i}}, file=>undef); | ||
| 89 | $dbe->{i2s} = Lingua::TT::DBFile->new(%{$dbe->{opts_i2s}}, file=>undef); | ||
| 90 | |||
| 91 | $dbe->{s2i}->open("${file}_s2i.db") | ||
| 92 | or croak(ref($dbe)."::open() failed for '${file}_s2i.db': $!"); | ||
| 93 | $dbe->{i2s}->open($file."_i2s.db") | ||
| 94 | or croak(ref($dbe)."::open() failed for '${file}_i2s.db': $!"); | ||
| 95 | |||
| 96 | ##-- initialize local references | ||
| 97 | $dbe->{id2sym} = $dbe->{i2s}{data}; | ||
| 98 | $dbe->{sym2id} = $dbe->{s2i}{data}; | ||
| 99 | |||
| 100 | $dbe->{size} = 0; | ||
| 101 | my ($key,$val); | ||
| 102 | while (($key,$val)=each(%{$dbe->{sym2id}})) { | ||
| 103 | ++$dbe->{size}; | ||
| 104 | } | ||
| 105 | |||
| 106 | return $dbe; | ||
| 107 | } | ||
| 108 | |||
| 109 | ##============================================================================== | ||
| 110 | ## Methods: Access and Manipulation | ||
| 111 | |||
| 112 | ## $id = $dbe->getId($sym) | ||
| 113 | ## + gets (possibly new) id for $sym | ||
| 114 | sub getId { | ||
| 115 | return $_[0]{sym2id}{$_[1]} if (exists($_[0]{sym2id}{$_[1]})); | ||
| 116 | #$_[0]{id2sym}[$_[0]{size}] = $_[1]; | ||
| 117 | $_[0]{id2sym}{$_[0]{size}} = $_[1]; | ||
| 118 | return $_[0]{sym2id}{$_[1]} = $_[0]{size}++; | ||
| 119 | } | ||
| 120 | |||
| 121 | ## $id = $dbe->getSym($id) | ||
| 122 | ## + gets (possibly new (and if so, "SYM${i}")) symbol for $id | ||
| 123 | sub getSym { | ||
| 124 | return $_[0]{id2sym}[$_[1]] if ($_[1] < $_[0]{size}); | ||
| 125 | $_[0]{sym2id}{"SYM$_[1]"} = $_[1]; | ||
| 126 | #return $_[0]{id2sym}[$_[1]] = "SYM$_[1]"; | ||
| 127 | return $_[0]{id2sym}{$_[1]} = "SYM$_[1]"; | ||
| 128 | } | ||
| 129 | |||
| 130 | |||
| 131 | ##============================================================================== | ||
| 132 | ## Footer | ||
| 133 | 1; | ||
| 134 | |||
| 135 | __END__ |