/[suikacvs]/test/cvs
Suika

Diff of /test/cvs

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.13 by wakaba, Mon Apr 1 05:32:37 2002 UTC revision 1.40 by wakaba, Sat Jul 27 04:44:25 2002 UTC
# Line 1  Line 1 
1    
2  =head1 NAME  =head1 NAME
3    
4  Message::Header Perl module  Message::Header --- A Perl Module for Internet Message Headers
   
 =head1 DESCRIPTION  
   
 Perl module for RFC 822/2822 message C<header>.  
5    
6  =cut  =cut
7    
8  package Message::Header;  package Message::Header;
9  use strict;  use strict;
10  use vars qw($VERSION %REG %DEFAULT);  use vars qw(%DEFAULT @ISA %REG $VERSION);
11  $VERSION = '1.00';  $VERSION=do{my @r=(q$Revision$=~/\d+/g);sprintf "%d."."%02d" x $#r,@r};
12  use Carp;  require Message::Field::Structured;     ## This may seem silly:-)
13  use overload '@{}' => sub {shift->_delete_empty_field()->{field}},  push @ISA, qw(Message::Field::Structured);
14               '""' => sub {shift->stringify};  
15    %REG = %Message::Util::REG;
16            $REG{M_field} = qr/^([^\x3A]+):$REG{FWS}([\x00-\xFF]*)$/;
17            $REG{M_fromline} = qr/^\x3E?From$REG{WSP}+([\x00-\xFF]*)$/;
18            $REG{ftext} = qr/[\x21-\x39\x3B-\x7E]+/;        ## [2]822
19            $REG{NON_ftext} = qr/[^\x21-\x39\x3B-\x7E]/;    ## [2]822
20            $REG{NON_ftext_usefor} = qr/[^0-9A-Za-z-]/;     ## name-character
21            $REG{NON_ftext_http} = $REG{NON_http_token};
22    
23    ## Namespace support
24            our %NS_phname2uri;     ## PH-namespace name -> namespace URI
25            our %NS_uri2package;    ## namespace URI -> Package name
26            our %NS_uri2phpackage;  ## namespace URI -> PH-Package name
27            require Message::Header::Default;       ## Default namespace
28    
29    ## Initialize of this class -- called by constructors
30    %DEFAULT = (
31        -_HASH_NAME => 'value',
32        -_METHODS   => [qw|field field_exist field_type add replace count delete subject id is|],
33        -_MEMBERS   => [qw|value|],
34        -_VALTYPE_DEFAULT   => ':default',
35        -by => 'name',
36        -field_format_pattern       => '%s: %s',
37        -field_name_case_sensible   => 0,
38        -field_name_unsafe_rule     => 'NON_ftext',
39        -field_name_validation      => 0,
40        -field_sort => 0,
41        -format     => 'mail-rfc2822',
42        -header_default_charset     => 'iso-2022-int-1',
43        -header_default_charset_input       => 'iso-2022-int-1',
44        -hook_init_fill_options     => sub {},
45        -hook_stringify_fill_fields => sub {},
46        -linebreak_strict   => 0,
47        -line_length_max    => 60,  ## For folding
48        #ns_default_phuri
49        -output_bcc => 0,
50        -output_folding     => 1,
51        -output_mail_from   => 0,
52        #parse_all
53        -translate_underscore       => 1,
54        #uri_mailto_safe
55        -uri_mailto_safe_level      => 4,
56        -use_folding        => 1,
57        #value_type
58    );
59    
60  $REG{WSP}     = qr/[\x09\x20]/;  =head1 CONSTRUCTORS
 $REG{FWS}     = qr/[\x09\x20]*/;  
 $REG{M_field} = qr/^([^\x3A]+):$REG{FWS}([\x00-\xFF]*)$/;  
 $REG{M_fromline} = qr/^\x3E?From$REG{WSP}+([\x00-\xFF]*)$/;  
 $REG{UNSAFE_field_name} = qr/[\x00-\x20\x3A\x7F-\xFF]/;  
61    
62  =head2 options  The following methods construct new C<Message::Header> objects:
63    
64  These options can be getten/set by C<get_option>/C<set_option>  =over 4
 method.  
65    
66  =head3 capitalize = 0/1  =cut
67    
68    sub _init ($;%) {
69      my $self = shift;
70      my %options = @_;
71      my $DEFAULT = Message::Util::make_clone (\%DEFAULT);
72      $self->SUPER::_init (%$DEFAULT, %options);
73      $self->{value} = [];
74      $self->_ns_load_ph ('default');
75      $self->_ns_load_ph ('x-rfc822');
76      $self->_ns_load_ph ('x-http');
77      $self->{option}->{ns_default_phuri} = $self->{ns}->{phname2uri}->{'x-rfc822'}
78        unless $self->{option}->{ns_default_phuri};
79      
80      ## For text/rfc822-headers
81      if (ref $options{entity_header}) {
82        $self->{entity_header} = $options{entity_header};
83        delete $options{entity_header};
84      }
85      my @new_fields = ();
86      for my $name (keys %options) {
87        unless (substr ($name, 0, 1) eq '-') {
88          push @new_fields, ($name => $options{$name});
89        }
90      }
91      &{ $self->{option}->{hook_init_fill_options} } ($self, $self->{option});
92      $self->_init_by_format ($self->{option}->{format}, $self->{option});
93      $self->add (@new_fields, -parse => $self->{option}->{parse_all})
94        if $#new_fields > -1;
95    }
96    
97  (First character of) C<field-name> is capitalized  sub _init_by_format ($$\%) {
98  when C<stringify>.  (Default = 1)    my $self = shift;
99      my ($format, $option) = @_;
100      if ($format =~ /http/) {
101        $option->{ns_default_phuri} = $self->{ns}->{phname2uri}->{'x-http'};
102        if ($format =~ /cgi/) {
103          #unshift @header_order, qw(content-type location);
104          $option->{field_sort} = 'good-practice';
105          $option->{use_folding} = 0;
106        } else {
107          $option->{field_sort} = 'good-practice';
108        }
109      } elsif ($format =~ /mail|news|mime/) {       ## RFC 822
110        $option->{ns_default_phuri} = $self->{ns}->{phname2uri}->{'x-rfc822'};
111      }
112      if ($format =~ /uri-url-mailto/) {
113        $option->{output_bcc} = 0;
114        $option->{field_format_pattern} = '%s=%s';
115        $option->{output_folding} = sub {
116          $_[1] =~ s/([^:@+\$A-Za-z0-9\-_.!~*])/sprintf('%%%02X', ord $1)/ge;
117          $_[1];
118        };  ## Yes, this is not folding!
119      }
120    }
121    
122  =head3 fold_length = numeric value  =item $msg = Message::Header->new ([%initial-fields/options])
123    
124  Length of line used to fold.  (Default = 70)  Constructs a new C<Message::Headers> object.  You might pass some initial
125    C<field-name>-C<field-body> pairs and/or options as parameters to the constructor.
126    
127  =head3 mail_from = 0/1  Example:
128    
129  Outputs "From " line (known as Un*x From, Mail-From, and so on)   $hdr = new Message::Headers
130  when C<stringify>.  (Default = 0)          Date         => 'Thu, 03 Feb 1994 00:00:00 +0000',
131            Content_Type => 'text/html',
132            Content_Location => 'http://www.foo.example/',
133            -format => 'mail-rfc2822'       ## not to be header field
134            ;
135    
136  =cut  =cut
137    
138  %DEFAULT = (  ## Inherited
   capitalize    => 1,  
   fold_length   => 70,  
   field_type    => {':DEFAULT' => 'Message::Field::Unstructured'},  
   format        => 'rfc2822',   ## rfc2822, usefor, http  
   mail_from     => -1,  
   output_bcc    => -1,  
   parse_all     => -1,  
 );  
 my @field_type_Structured = qw(cancel-lock  
   importance path precedence  
   x-face x-mail-count x-msmail-priority x-priority xref);  
 for (@field_type_Structured)  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::Structured'}  
 my @field_type_Address = qw(approved bcc cc delivered-to disposition-notification-to  
   envelope-to  
   errors-to fcc from mail-followup-to mail-followup-cc mail-from reply-to resent-bcc  
   resent-cc resent-to resent-from resent-sender return-path  
   return-receipt-to sender to x-approved x-beenthere  
   x-complaints-to x-envelope-from x-envelope-sender  
   x-envelope-to x-ml-address x-ml-command x-ml-to x-nfrom x-nto);  
 for (@field_type_Address)  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::Address'}  
 my @field_type_Date = qw(date date-received delivery-date expires  
   expire-date nntp-posting-date posted reply-by resent-date x-tcup-date);  
 for (@field_type_Date)  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::Date'}  
 my @field_type_MsgID = qw(article-updates content-id in-reply-to message-id  
   references resent-message-id see-also supersedes);  
 for (@field_type_MsgID)  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::MsgID'}  
 for (qw(received x-received))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::Received'}  
 $DEFAULT{field_type}->{'content-type'} = 'Message::Field::ContentType';  
 $DEFAULT{field_type}->{'content-disposition'} = 'Message::Field::ContentDisposition';  
 for (qw(archive link x-face-type))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::ValueParams'}  
 for (qw(accept accept-charset accept-encoding accept-language  
   content-language  
   content-transfer-encoding encrypted followup-to keywords  
   list-archive list-digest list-help list-owner  
   list-post list-subscribe list-unsubscribe list-url uri newsgroups  
   x-brother x-daughter x-respect x-moe x-syster x-wife))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::CSV'}  
 for (qw(content-alias content-base content-location location referer  
   url x-home-page x-http_referer  
   x-info x-pgp-key x-ml-url x-uri x-url x-web))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::URI'}  
 for (qw(list-id))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::Structured'}  
 for (qw(subject title x-nsubject))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::Subject'}  
 for (qw(list-software user-agent server))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::UA'}  
 for (qw(content-length lines max-forwards mime-version))  
   {$DEFAULT{field_type}->{$_} = 'Message::Field::Numval'}  
139    
140  =head2 Message::Header->new ([%option])  =item $msg = Message::Header->parse ($header, [%initial-fields/options])
141    
142  Returns new Message::Header instance.  Some options can be  Parses given C<header> and constructs a new C<Message::Headers>
143  specified as hash.  object.  You might pass some additional C<field-name>-C<field-body> pairs
144    or/and initial options as parameters to the constructor.
145    
146  =cut  =cut
147    
148  sub new ($;%) {  sub parse ($$;%) {
149    my $class = shift;    my $class = shift;
150    my $self = bless {option => {@_}}, $class;    my $header = shift;
151    for (keys %DEFAULT) {$self->{option}->{$_} ||= $DEFAULT{$_}}    my $self = bless {}, $class;
152      $self->_init (@_);
153      if ($self->{option}->{linebreak_strict}) {
154        $header =~ s/\x0D\x0A$REG{WSP}/\x20/gos if $self->{option}->{use_folding};
155      } else {
156        $header =~ s/\x0D?\x0A$REG{WSP}/\x20/gos if $self->{option}->{use_folding};
157      }
158      my %option = (%{ $self->{option} });
159      $option{parse_all} = 0;
160      for my $field (split /\x0D?\x0A/, $header) {
161        if ($field =~ /$REG{M_fromline}/) {
162          my ($s,undef,$value) = $self->_value_to_arrayitem
163            ('mail-from' => $1, \%option);
164          push @{$self->{value}}, $value if $s;
165        } elsif ($field =~ /$REG{M_field}/) {
166          my ($name, $body) = ($1, $2);
167          $body =~ s/$REG{WSP}+$//;
168          my ($s,undef,$value) = $self->_value_to_arrayitem
169            ($name => $body, \%option);
170          push @{$self->{value}}, $value if $s;
171        } elsif (length $field) {
172          my ($s,undef,$value) = $self->_value_to_arrayitem
173            ('x-unknown' => $field, \%option);
174          push @{$self->{value}}, $value if $s;
175        }
176      }
177      $self->_ns_associate_numerical_prefix;        ## RFC 2774 namespace
178      for (@{ $self->{value} }) {
179        no strict 'refs';
180        $_->{name}
181          = &{ ${ &_NS_uri2package ($_->{ns}).'::OPTION' }{n11n_name} }
182          ($self, &_NS_uri2package ($_->{ns}), $_->{name});
183        $_->{body} = $self->_parse_value ($_->{name} => $_->{body}, ns => $_->{ns})
184          if $self->{option}->{parse_all};
185      }
186    $self;    $self;
187  }  }
188    
189  =head2 Message::Header->parse ($header, [%option])  =item $msg = Message::Header->parse_array (\@header, [%initial-fields/options])
190    
191  Parses given C<header> and return a new Message::Header  Parses given C<header> and constructs a new C<Message::Headers>
192  object.  Some options can be specified as hash.  object.  Same as C<Message::Header-E<lt>parse> but this method
193    is given an array reference.  You might pass some additional
194    C<field-name>-C<field-body> pairs or/and initial options
195    as parameters to the constructor.
196    
197  =cut  =cut
198    
199  sub parse ($$;%) {  sub parse_array ($\@;%) {
200    my $class = shift;    my $class = shift;
201    my $header = shift;    my $header = shift;
202    my $self = bless {option => {@_}}, $class;    Carp::croak "parse_array: first argument is not an array reference"
203    for (keys %DEFAULT) {$self->{option}->{$_} ||= $DEFAULT{$_}}      unless ref $header eq 'ARRAY';
204    $header =~ s/\x0D?\x0A$REG{WSP}+/\x20/gos;    ## unfold    my $self = bless {}, $class;
205    for my $field (split /\x0D?\x0A/, $header) {    $self->_init (@_);
206      while (1) {
207        my $field = shift @$header;
208        if ($self->{option}->{use_folding}) {
209          while (1) {
210            if ($$header[0] =~ /^$REG{WSP}/) {
211              $field .= shift @$header;
212            } else {last}
213          }
214        }
215        if ($self->{option}->{linebreak_strict}) {
216          $field =~ s/\x0D\x0A//g;
217        } else {
218          $field =~ tr/\x0D\x0A//d;
219        }
220        local $self->{option}->{parse} = $self->{option}->{parse_all};
221      if ($field =~ /$REG{M_fromline}/) {      if ($field =~ /$REG{M_fromline}/) {
222        my $body = $1;        my ($s,undef,$value) = $self->_value_to_arrayitem
223        $body = $self->_field_body ($body, 'mail-from')          ('mail-from' => $1, $self->{option});
224          if $self->{option}->{parse_all}>0;        push @{$self->{value}}, $value if $s;
       push @{$self->{field}}, {name => 'mail-from', body => $body};  
225      } elsif ($field =~ /$REG{M_field}/) {      } elsif ($field =~ /$REG{M_field}/) {
226        my ($name, $body) = (lc $1, $2);        my ($name, $body) = ($self->_n11n_field_name ($1), $2);
       $name =~ s/$REG{WSP}+$//;  
227        $body =~ s/$REG{WSP}+$//;        $body =~ s/$REG{WSP}+$//;
228        $body = $self->_field_body ($body, $name) if $self->{option}->{parse_all}>0;        my ($s,undef,$value) = $self->_value_to_arrayitem
229        push @{$self->{field}}, {name => $name, body => $body};          ($name => $body, $self->{option});
230          push @{$self->{value}}, $value if $s;
231        } elsif (length $field) {
232          my ($s,undef,$value) = $self->_value_to_arrayitem
233            ('x-unknown' => $field, $self->{option});
234          push @{$self->{value}}, $value if $s;
235      }      }
236        last if $#$header < 0;
237    }    }
238      $self->_ns_associate_numerical_prefix;        ## RFC 2774 namespace
239    $self;    $self;
240  }  }
241    
242    =back
243    
244    =head1 METHODS
245    
246  =head2 $self->field ($field_name)  =head2 $self->field ($field_name)
247    
248  Returns C<field-body> of given C<field-name>.  Returns C<field-body> of given C<field-name>.
# Line 154  context, only first one is returned.) Line 252  context, only first one is returned.)
252    
253  =cut  =cut
254    
255  sub field ($$) {  sub field ($@) {shift->SUPER::item (@_)}
256    sub field_exist ($@) {shift->SUPER::item_exist (@_)}
257    
258    ## item-by?, \$checked-item, {item-key => 1}, \%option
259    sub _item_match ($$\$\%\%) {
260    my $self = shift;    my $self = shift;
261    my $name = lc shift;    my ($by, $i, $list, $option) = @_;
262    my @ret;    return 0 unless ref $$i;  ## Already removed
263    for my $field (@{$self->{field}}) {    if ($by eq 'name') {
264      if ($field->{name} eq $name) {      my %o = %$option; #$o{parse} = 0;
265        unless (wantarray) {      my %l;
266          $field->{body} = $self->_field_body ($field->{body}, $name);      for (keys %$list) {
267          return $field->{body};        my ($s, undef, $v) = $self->_value_to_arrayitem ($_, '', \%o);
268          if ($s) {
269            $l{$v->{name} . ':' . ( $option->{ns} || $v->{ns} ) } = 1;
270        } else {        } else {
271          $field->{body} = $self->_field_body ($field->{body}, $name);          $l{$v->{name} .':'. ( $option->{ns} || $self->{option}->{ns_default_phuri} ) } = 1;
272          push @ret, $field->{body};        }
273        }
274        return 1 if $l{$$i->{name} . ':' . $$i->{ns}};
275      } elsif ($by eq 'ns') {
276        return 1 if $list->{ $$i->{ns} };
277      } elsif ($by eq 'http-ns-define') {
278        if ($$i->{ns} eq $self->{ns}->{phname2uri}->{'x-http'}
279         || $$i->{ns} eq $self->{ns}->{phname2uri}->{'x-http-c'}) {
280          my $n = $$i->{name};
281          if ($n eq 'opt' || $n eq 'c-opt' || $n eq 'man' || $n eq 'c-man') {
282            $option->{parse} = 0;
283            $$i->{body} = $self->_parse_value ($$i->{name} => $$i->{body}, ns => $$i->{ns});
284            for my $j (0..$$i->{body}->count-1) {
285              return 1 if $list->{ ($$i->{body}->value ($j))[0]->value };
286            }
287        }        }
288      }      }
289    }    }
290    if ($#ret < 0) {    0;
     return $self->add ($name);  
   }  
   @ret;  
291  }  }
292    *_delete_match = \&_item_match;
293    
294  sub field_exist ($$) {  ## Returns returned item value    \$item-value, \%option
295    my $self = shift;  sub _item_return_value ($\$\%) {
296    my $name = lc shift;    if (ref ${$_[1]}->{body}) {
297    my @ret;      ${$_[1]}->{body};
298    for my $field (@{$self->{field}}) {    } else {
299      return 1 if ($field->{name} eq $name);      ${$_[1]}->{body} = $_[0]->_parse_value (${$_[1]}->{name} => ${$_[1]}->{body},
300          ns => ${$_[1]}->{ns});
301        ${$_[1]}->{body};
302      }
303    }
304    *_add_return_value = \&_item_return_value;
305    *_replace_return_value = \&_item_return_value;
306    
307    ## Returns returned (new created) item value    $name, \%option
308    sub _item_new_value ($$\%) {
309      my $self = shift;
310      my ($name, $option) = @_;
311      if ($option->{by} eq 'http-ns-define') {
312        my $value = $self->_parse_value (opt => '', ns => $self->{ns}->{phname2uri}->{'x-http'});
313        ($value->value (0))[0]->value ($name);
314        {name => 'opt', body => $value, ns => $self->{ns}->{phname2uri}->{'x-http'}};
315      } else {
316        my ($s,undef,$value) = $self->_value_to_arrayitem
317            ($name => '', $option);
318        $s? $value: undef;
319    }    }
   0;  
320  }  }
321    
 =head2 $self->field_name ($index)  
322    
 Returns C<field-name> of $index'th C<field>.  
323    
324  =head2 $self->field_body ($index)  ## $self->_parse_value ($type, $value, %options);
325    sub _parse_value ($$$;%) {
 Returns C<field-body> of $index'th C<field>.  
   
 =cut  
   
 sub field_name ($$) {  
   my $self = shift;  
   $self->{field}->[shift]->{name};  
 }  
 sub field_body ($$) {  
326    my $self = shift;    my $self = shift;
327    my $i = shift;    my $name = shift ;#|| $self->{option}->{_VALTYPE_DEFAULT};
328    $self->{field}->[$i]->{body}    my $value = shift;  return $value if ref $value;
329     = $self->_field_body ($self->{field}->[$i]->{body}, $self->{field}->[$i]->{name});    my %option = @_;
330    $self->{field}->[$i]->{body};    my $vtype; { no strict 'refs';
331        my $vt = ${&_NS_uri2package ($option{ns}).'::OPTION'}{value_type};
332        if (ref $vt) {
333          $vtype = $vt->{$name} || $vt->{$self->{option}->{_VALTYPE_DEFAULT}};
334        }
335        ## For compatiblity.
336        unless (ref $vtype) { $vtype = $self->{option}->{value_type}->{$name}
337          || $self->{option}->{value_type}->{$self->{option}->{_VALTYPE_DEFAULT}} }
338      }
339      my $vpackage = $vtype->[0];
340      my %vopt = %{$vtype->[1]} if ref $vtype->[1];
341      if ($vpackage eq ':none:') {
342        return $value;
343      } elsif (length $value) {
344        eval "require $vpackage" or Carp::croak qq{<parse>: $vpackage: Can't load package: $@};
345        return $vpackage->parse ($value,
346          -format   => $self->{option}->{format},
347          -field_ns => $option{ns},
348          -field_name       => $name,
349        -header_default_charset     => $self->{option}->{header_default_charset},
350        -header_default_charset_input       => $self->{option}->{header_default_charset_input},
351        -internal_charset_name      => $self->{option}->{internal_charset_name},
352          -parse_all        => $self->{option}->{parse_all},
353        %vopt);
354      } else {
355        eval "require $vpackage" or Carp::croak qq{<parse>: $vpackage: Can't load package: $@};
356        return $vpackage->new (
357          -format   => $self->{option}->{format},
358          -field_ns => $option{ns},
359          -field_name       => $name,
360        -header_default_charset     => $self->{option}->{header_default_charset},
361        -header_default_charset_input       => $self->{option}->{header_default_charset_input},
362        -internal_charset_name      => $self->{option}->{internal_charset_name},
363          -parse_all        => $self->{option}->{parse_all},
364        %vopt);
365      }
366  }  }
367    
368  sub _field_body ($$$) {  ## Defined for text/rfc822-headers
369    my $self = shift;  sub entity_header ($;$) {
370    my ($body, $name) = @_;    my $self = shift;
371    unless (ref $body) {    my $new_header = shift;
372      my $type = $self->{option}->{field_type}->{$name}    if (ref $new_header) {
373              || $self->{option}->{field_type}->{':DEFAULT'};      $self->{header} = $new_header;
     eval "require $type";  
     unless ($body) {  
       $body = $type->new (field_name => $name, format => $self->{option}->{format});  
     } else {  
       $body = $type->parse ($body, field_name => $name,  
         format => $self->{option}->{format});  
     }  
374    }    }
375    $body;    $self->{header};
376  }  }
377    
378  =head2 $self->field_name_list ()  =head2 $self->field_name_list ()
# Line 234  returns ALL names.) Line 385  returns ALL names.)
385    
386  sub field_name_list ($) {  sub field_name_list ($) {
387    my $self = shift;    my $self = shift;
388    $self->_delete_empty_field ();    $self->_delete_empty ();
389    map {$_->{name}} @{$self->{field}};    map { $_->{name} . ':' . $_->{ns} } @{$self->{value}};
390    }
391    
392    sub namespace_ph_default ($;$) {
393      my $self = shift;
394      if (defined $_[0]) {
395        no strict 'refs';
396        $self->{option}->{ns_default_phuri} = $_[0];
397        $self->_ns_load_ph (${&_NS_uri2package ($self->{option}->{ns_default_phuri}).'::OPTION'}{namespace_phname});
398      }
399      $self->{option}->{ns_default_phuri};
400  }  }
401    
402  =head2 $self->add ($field_name, $field_body)  =item $hdr->add ($field-name, $field-body, [$name, $body, ...])
403    
404    Adds some field name/body pairs.  Even if there are
405    one or more fields named given C<$field-name>,
406    given name/body pairs are ADDed.  Use C<replace>
407    to remove same-name-fields.
408    
409    Instead of field name-body pair, you might pass some options.
410    Four options are available for this method.
411    
412    C<-parse>: Parses and validates C<field-body>, and returns
413    C<field-body> object.  (When multiple C<field-body>s are
414    added, returns only last one.)  (Default: C<defined wantarray>)
415    
416  Adds an new C<field>.  It is not checked whether  C<-prepend>: New fields are not appended,
417  the field which named $field_body is already exist or not.  but prepended to current fields.  (Default: C<0>)
418  If you don't want duplicated C<field>s, use C<replace> method.  
419    C<-translate-underscore>: Do C<field-name> =~ tr/_/-/.  (Default: C<1>)
420    
421    C<-validate>: Checks whether C<field-name> is valid or not.
422    
423  =cut  =cut
424    
425  sub add ($$;$%) {  ## [Name: Value] pair -> internal array item
426    ## $self->_value_to_arrayitem ($name => $value, {%options})
427    ## or
428    ## $self->_value_to_arrayitem ($name => [$value, %value_options], {%options})
429    ##
430    ## Return: ((1 = success / 0 = failue), $full_name, $arrayitem)
431    sub _value_to_arrayitem ($$$\%) {
432    my $self = shift;    my $self = shift;
433    my ($name, $body) = (lc shift, shift);    my ($name, $value, $option) = @_;
434    my %option = @_;    my $value_option = {};
435    return 0 if $name =~ /$REG{UNSAFE_field_name}/;    if (ref $value eq 'ARRAY') {
436    $body = $self->_field_body ($body, $name);      ($value, %$value_option) = @$value;
   if ($option{prepend}) {  
     unshift @{$self->{field}}, {name => $name, body => $body};  
   } else {  
     push @{$self->{field}}, {name => $name, body => $body};  
437    }    }
438    $body;    my $default_ns = $option->{ns_default_phuri};
439      my $nsuri = $default_ns;
440      $name =~ s/^$REG{WSP}+//;  $name =~ s/$REG{WSP}+$//;
441      
442      no strict 'refs';
443      if ($value_option->{ns}) {
444        $nsuri = $value_option->{ns};
445      } elsif ($option->{ns}) {
446        $nsuri = $option->{ns};
447      } elsif (($default_ns eq $self->{ns}->{phname2uri}->{'x-http'}
448           && $name =~ s/^([0-9]+)-//)
449        || ($name =~ s/^x-http-([0-9]+)-//i)) {     ## Numric namespace prefix, RFC 2774
450        my $prefix = 0+$1;
451        $nsuri = $self->{ns}->{number2uri}->{ $prefix };
452        unless ($nsuri) {
453          $self->{ns}->{number2uri}->{ $prefix } = 'urn:x-suika-fam-cx:msgpm:header:x-temp:'.$prefix;
454          $nsuri = $self->{ns}->{number2uri}->{ $prefix };
455        }
456      } elsif (
457        ${ &_NS_uri2package ($default_ns).'::OPTION' }{use_ph_namespace}
458        && (
459           ($name =~ s/^([Xx]-[A-Za-z0-9]+|[A-Za-z]*[A-WYZa-wyz0-9][A-Za-z0-9]*)-
460                        ([Xx]-[A-Za-z0-9]+|[A-Za-z0-9]*[A-WYZa-wyz0-9][A-Za-z0-9]*)-//x)
461         || $name =~ s/^([Xx]-[A-Za-z0-9]+|[A-Za-z0-9]*[A-WYZa-wyz0-9][A-Za-z0-9]*)-//
462        )) {
463        my ($prefix1, $prefix2) = ($1, $2);
464        my $original_prefix = $&;  my $one_prefix = 0;
465        unless ($prefix2) {
466          $prefix2 = $prefix1;
467          $prefix1 = $self->{ns}->{uri2phname}->{ $default_ns };
468          $one_prefix = 1;
469        }
470        my $prefix
471          = &{ ${ &_NS_uri2package ($nsuri).'::OPTION' }{n11n_prefix} }
472            ($self, &_NS_uri2package ($nsuri), $prefix1.'-'.$prefix2);
473        $self->_ns_load_ph ($prefix);
474        $nsuri = $self->{ns}->{phname2uri}->{ $prefix };
475        unless ($nsuri) {
476          $nsuri = $default_ns;
477          $prefix
478            = &{ ${ &_NS_uri2package ($nsuri).'::OPTION' }{n11n_prefix} }
479              ($self, &_NS_uri2package ($nsuri), $one_prefix? $prefix2:
480               $prefix1);
481          $self->_ns_load_ph ($prefix);
482          $nsuri = $self->{ns}->{phname2uri}->{ $prefix };
483          if ($nsuri) {
484            $name = $prefix2 . '-' . $name unless $one_prefix;
485          } else {
486            unless ($one_prefix) {
487              $prefix
488                = &{ ${ &_NS_uri2package ($nsuri).'::OPTION' }{n11n_prefix} }
489                  ($self, &_NS_uri2package ($nsuri),
490                   $self->{ns}->{uri2phname}->{ $default_ns } . '-' . $prefix1);
491              $self->_ns_load_ph ($prefix);
492              $nsuri = $self->{ns}->{phname2uri}->{ $prefix };
493              if ($nsuri) {
494                $name = $prefix2 . '-' . $name;
495              }
496            }
497            unless ($nsuri) {
498              $name = $original_prefix . $name;
499              $nsuri = $default_ns;
500            }
501          }
502        }
503      }
504      $name
505        = &{ ${ &_NS_uri2package ($nsuri).'::OPTION' }{n11n_name} }
506          ($self, &_NS_uri2package ($nsuri), $name);
507      Carp::croak "$name: invalid field-name"
508        if $option->{field_name_validation}
509          && $name =~ /$REG{ $option->{field_name_unsafe_rule} }/;
510      $value = $self->_parse_value ($name => $value, ns => $nsuri)
511        if $option->{parse} || $option->{parse_all};
512      $option->{parse} = 0;
513      (1, $name.':'.$nsuri => {name => $name, body => $value, ns => $nsuri});
514  }  }
515    *_add_hash_check = \&_value_to_arrayitem;
516    *_replace_hash_check = \&_value_to_arrayitem;
517    
518  =head2 $self->relace ($field_name, $field_body)  =head2 $self->relace ($field_name, $field_body)
519    
# Line 270  first one is used and the others are not Line 525  first one is used and the others are not
525    
526  =cut  =cut
527    
528  sub replace ($$$) {  sub _replace_hash_shift ($\%$\%) {
529    my $self = shift;    shift; my $r = shift;  my $n = $_[0]->{name} . ':' . $_[0]->{ns};
530    my ($name, $body) = (lc shift, shift);    if ($$r{$n}) {
531    return 0 if $name =~ /$REG{UNSAFE_field_name}/;      my $d = $$r{$n};
532    $body = $self->_field_body ($body, $name);      delete $$r{$n};
533    for my $field (@{$self->{field}}) {      return $d;
     if ($field->{name} eq $name) {  
       $field->{body} = $body;  
       return $body;  
     }  
534    }    }
535    push @{$self->{field}}, {name => $name, body => $body};    undef;
   $body;  
536  }  }
537    
538  =head2 $self->delete ($field_name, [$index])  =head2 $self->delete ($field-name, [$name, ...])
539    
540  Deletes C<field> named as $field_name.  Deletes C<field> named as $field_name.
 If $index is specified, only $index'th C<field> is deleted.  
 ($index of first field is C<1>, not C<0>.)  
 If not, ($index == 0), all C<field>s that have the C<field-name>  
 $field_name are deleted.  
541    
542  =cut  =cut
543    
 sub delete ($$;$) {  
   my $self = shift;  
   my ($name, $index) = (lc shift, shift);  
   my $i = 0;  
   for my $field (@{$self->{field}}) {  
     if ($field->{name} eq $name) {  
       $i++;  
       if ($index == 0 || $i == $index) {  
         undef $field;  
         return $self if $i == $index;  
       }  
     }  
   }  
   $self;  
 }  
544    
545  =head2 $self->count ([$field_name])  =head2 $self->count ([$field_name])
546    
# Line 319  of fields.  (Same as $#$self+1) Line 550  of fields.  (Same as $#$self+1)
550    
551  =cut  =cut
552    
553  sub count ($;$) {  sub _count_by_name ($$\%) {
554      my $self = shift;
555      my ($array, $option) = @_;
556      my $name = $self->_n11n_field_name ($$option{-name});
557      my @a = grep {$_->{name} eq $name} @{$self->{$array}};
558      $#a + 1;
559    }
560    
561    ## Delete empty items
562    sub _delete_empty ($) {
563      my $self = shift;
564      my $array = $self->{option}->{_HASH_NAME};
565      $self->{$array} = [grep {ref $_ && length $_->{name}} @{$self->{$array}}];
566    }
567    
568    =head2 $self->rename ($field-name, $new-name, [$old, $new,...])
569    
570    Renames C<$field-name> as C<$new-name>.
571    
572    =cut
573    
574    sub rename ($%) {
575    my $self = shift;    my $self = shift;
576    my ($name) = (lc shift);    my %params = @_;
577    unless ($name) {    my %option = %{$self->{option}};
578      $self->_delete_empty_field ();    for (grep {/^-/} keys %params) {$option{substr ($_, 1)} = $params{$_}}
579      return $#{$self->{field}}+1;    my %new_name;
580      for (grep {/^[^-]/} keys %params) {
581        my ($old => $new)
582          = ($self->_n11n_field_name ($_) => $self->_n11n_field_name ($params{$_}));
583        $old =~ tr/_/-/ if $option{translate_underscore};
584        $new =~ tr/_/-/ if $option{translate_underscore};
585        Carp::croak "rename: $new: invalid field-name"
586          if $option{field_name_validation}
587            && $new =~ /$REG{$option{field_name_unsafe_rule}}/;
588        $new_name{$old} = $new;
589    }    }
590    my $count = 0;    for my $field (@{$self->{value}}) {
591    for my $field (@{$self->{field}}) {      if (length $new_name{$field->{name}}) {
592      if ($field->{name} eq $name) {        $field->{name} = $new_name{$field->{name}};
       $count++;  
593      }      }
594    }    }
595    $count;    $self if defined wantarray;
596  }  }
597    
 =head2 $self->rename ($field_name, [$index])  
598    
599  Renames C<field> named as $field_name.  =item $self->scan(\&doit)
600  If $index is specified, only $index'th C<field> is renamed.  
601  ($index of first field is C<1>, not C<0>.)  Apply a subroutine to each header field in turn.  The callback routine is
602  If not, ($index == 0), all C<field>s that have the C<field-name>  called with two parameters; the name of the field and a single value.
603  $field_name are renamed.  If the header has more than one value, then the routine is called once
604    for each value.
605    
606  =cut  =cut
607    
608  sub rename ($$$;$) {  sub _scan_sort ($\@\%) {
609      no strict 'refs';
610    my $self = shift;    my $self = shift;
611    my ($name, $newname, $index) = (lc shift, lc shift, shift);    my ($array, $option) = @_;
612    my $i = 0;    my $nspack = &_NS_uri2package ($self->{option}->{ns_default_phuri});
613    croak "rename: new field-name contains of unsafe character: $newname"    my $sort = ${ $nspack.'::OPTION' }{field_sort};
614      if !$newname || $newname =~ /$REG{UNSAFE_field_name}/;    if ($option->{field_sort} eq 'good-practice' && $sort->{'good-practice'}) {
615    for my $field (@{$self->{field}}) {      return $self->Message::Header::Default::sort_good_practice ($array, $nspack, $option);
616      if ($field->{name} eq $name) {    } elsif ($option->{field_sort} eq 'alphabetic' && $sort->{'alphabetic'}) {
617        $i++;      ## TODO: How treat namespace prefix?
618        if ($index == 0 || $i == $index) {      return sort {$a->{name} cmp $b->{name}} @$array;
         $field->{name} = $newname;  
         return $self if $i == $index;  
       }  
     }  
619    }    }
620    $self;    @$array;
621    }
622    
623    sub _n11n_field_name ($$) {
624      no strict 'refs';
625      my $self = shift;
626      my $s = shift;
627      $s =~ s/^$REG{WSP}+//; $s =~ s/$REG{WSP}+$//;
628      $s = lc $s unless ${&_NS_uri2package ($self->{option}->{ns_default_phuri}).'::OPTION'}{case_sensible};
629      $s;
630  }  }
631    
632    
633  =head2 $self->stringify ([%option])  =head2 $self->stringify ([%option])
634    
635  Returns the C<header> as a string.  Returns the C<header> as a string.
# Line 371  Returns the C<header> as a string. Line 638  Returns the C<header> as a string.
638    
639  sub stringify ($;%) {  sub stringify ($;%) {
640    my $self = shift;    my $self = shift;
641    my %OPT = @_;    my %params = @_;
642      my %option = %{$self->{option}};
643      $option{format} = $params{-format} if $params{-format};
644      $self->_init_by_format ($option{format}, \%option)
645        if $self->{option}->{format} ne $option{format};
646      for (grep {/^-/} keys %params) {$option{substr ($_, 1)} = $params{$_}}
647      ## Fill required fields
648        my %exist;
649        for ($self->field_name_list) {$exist{$_} = 1}
650        &{ $option{hook_stringify_fill_fields} } ($self, \%exist, \%option);
651    my @ret;    my @ret;
652    $OPT{capitalize} ||= $self->{option}->{capitalize};    ## RFC 2774 numerical field name prefix
653    $OPT{mail_from} ||= $self->{option}->{mail_from};    my %nprefix;
654    $OPT{output_bcc} ||= $self->{option}->{output_bcc};    {no strict 'refs';
655    $OPT{format} ||= $self->{option}->{format};      %nprefix = reverse %{ $self->{ns}->{number2uri} };
656    push @ret, 'From '.$self->field ('mail-from') if $OPT{mail_from}>0;      my $i = (sort { $a <=> $b } keys %{ $self->{ns}->{number2uri} })[-1] + 1;
657    for my $field (@{$self->{field}}) {      $i = 10 if $i < 10;
658      my $name = $field->{name};      my $hprefix = ${ &_NS_uri2package
659      next unless $name;                         ($self->{ns}->{phname2uri}->{'x-http'})
660      next if $OPT{mail_from}<0 && $name eq 'mail-from';                         .'::OPTION' } {namespace_phname_goodcase};
661      next if $OPT{output_bcc}<0 && ($name eq 'bcc' || $name eq 'resent-bcc');      for my $uri (keys %nprefix) {
662      my $fbody;        if ($nprefix{ $uri } < 10) {
663      if (ref $field->{body}) {          $nprefix{ $uri } = $i++;
664        $fbody = $field->{body}->stringify (format => $OPT{format});        }
665          my $nsfs = $self->item ($uri, -by => 'http-ns-define');
666          for my $i (0..$nsfs->count-1) {
667            my $nsf = ($nsfs->value ($i))[0];
668            if ($nsf->value eq $uri) {
669              $nsf->replace (ns => $nprefix{ $uri });
670              $nprefix{ $uri } = $hprefix . '-' . $nprefix{ $uri };
671              last;
672            }
673          }
674        }
675      }
676      my $_stringify = sub {
677        no strict 'refs';
678          my ($name, $body, $nsuri) = ($_[1]->{name}, $_[1]->{body}, $_[1]->{ns});
679          return unless length $name;
680          return if $option{output_mail_from} && $name eq 'mail-from';
681          $body = '' if !$option{output_bcc} && $name eq 'bcc';
682          my $nspackage = &_NS_uri2package ($nsuri);
683          my $oname;        ## Outputed field-name
684          my $prefix = $nprefix{ $nsuri }
685                    || ${$nspackage.'::OPTION'} {namespace_phname_goodcase}
686                    || $self->{ns}->{uri2phname}->{ $nsuri };
687          my $default_prefix = ${ &_NS_uri2package ($option{ns_default_phuri})
688                                  .'::OPTION'} {namespace_phname_goodcase};
689          $prefix = '' if $prefix eq $default_prefix;
690          $prefix =~ s/^\Q$default_prefix\E-//;
691          my $gc = ${$nspackage.'::OPTION'} {to_be_goodcase};
692          if (ref $gc) { $oname = &$gc ($self, $nspackage, $name, \%option) }
693          else { $oname = $name }
694          if ($prefix) { $oname = $prefix . '-' . $oname }
695          if ($option{format} =~ /uri-url-mailto/) {
696            return if (( ${$nspackage.'::OPTION'} {uri_mailto_safe}->{$name}
697                      || ${$nspackage.'::OPTION'} {uri_mailto_safe}->{':default'})
698                      < $option{uri_mailto_safe_level});
699            if ($name eq 'to') {
700              $body = $self->field ('to', -new_item_unless_exist => 0);
701              if (ref $body && $body->have_group) {
702                #
703              } elsif (ref $body && $body->count > 1) {
704                $body = $body->clone;
705                $body->delete ({-by => 'index'}, 0);
706              }
707            }
708          }
709          my $fbody;
710          if (ref $body) {
711            $fbody = $body->stringify (-format => $option{format});
712          } else {
713            $fbody = $body;
714          }
715          unless (${$nspackage.'::OPTION'} {field}->{$name}->{empty_body}) {
716            return unless length $fbody;
717          }
718          unless ($option{linebreak_strict}) {
719            ## bare \x0D and bare \x0A are unsafe
720            $fbody =~ s/\x0D(?=[^\x09\x0A\x20])/\x0D\x20/g;
721            $fbody =~ s/\x0A(?=[^\x09\x20])/\x0A\x20/g;
722          } else {
723            $fbody =~ s/\x0D\x0A(?=[^\x09\x20])/\x0D\x0A\x20/g;
724          }
725          if ($option{use_folding}) {
726            if (ref $option{output_folding}) {
727              $fbody = &{$option{output_folding}} ($self, $fbody,
728                -initial_length => length ($oname) +2);
729            } elsif ($option{output_folding}) {
730              $fbody = $self->_fold ($fbody, -initial_length => length ($oname) +2);
731            }
732          }
733          push @ret, sprintf $option{field_format_pattern}, $oname, $fbody;
734        };
735      if ($option{format} =~ /uri-url-mailto/) {
736        if ($option{format} =~ /uri-url-mailto-to/) {
737          my $to = $self->field ('to', -new_item_unless_exist => 0);
738          if ($to) {
739            unless ($to->have_group) {
740              my $fbody = $to->stringify (-format => $option{format}, -max => 1);
741              return &{$option{output_folding}} ($self, $fbody);
742            }
743          }
744          '';
745        } elsif ($option{format} =~ /uri-url-mailto-rfc1738/) {
746          my $to = $self->field ('to', -new_item_unless_exist => 0);
747          if ($to) {
748            my $fbody = $to->addr_spec (-format => $option{format});
749            return &{$option{output_folding}} ($self, $fbody);
750          }
751          '';
752      } else {      } else {
753        $fbody = $field->{body};        $self->scan ($_stringify);
754          my $ret = join ('&', @ret);
755          $ret;
756      }      }
757      next unless $fbody;    } else {
758      $fbody =~ s/\x0D([^\x09\x0A\x20])/\x0D\x20$1/g;      if ($option{output_mail_from}) {
759      $fbody =~ s/\x0A([^\x09\x20])/\x0A\x20$1/g;        my $fromline = $self->field ('mail-from', -new_item_unless_exist => 0);
760      $name =~ s/((?:^|-)[a-z])/uc($1)/ge if $OPT{capitalize};        push @ret, 'From '.$fromline if $fromline;
761      push @ret, $name.': '.$self->fold ($fbody);      }
762        $self->scan ($_stringify);
763        my $ret = join ("\x0D\x0A", @ret);
764        $ret? $ret."\x0D\x0A": '';
765    }    }
   my $ret = join ("\n", @ret);  
   $ret? $ret."\n": "";  
766  }  }
767    *as_string = \&stringify;
768    
769  =head2 $self->option ($option_name, [$option_value])  =head2 $self->option ($option_name, [$option_value])
770    
# Line 405  Set/gets new value of the option. Line 772  Set/gets new value of the option.
772    
773  =cut  =cut
774    
775  sub option ($$;$) {  sub option ($@) {
776    my $self = shift;    my $self = shift;
777    my ($name, $value) = @_;    if (@_ == 1) {
778    if (defined $value) {      return $self->{option}->{ shift (@_) };
779      }
780      while (my ($name, $value) = splice (@_, 0, 2)) {
781      $self->{option}->{$name} = $value;      $self->{option}->{$name} = $value;
782      if ($name eq 'format') {      if ($name eq 'format') {
783        for my $f (@{$self->{field}}) {        for my $f (@{$self->{field}}) {
784          if (ref $f) {          if (ref $f->{body}) {
785            $f->option (format => $value);            $f->{body}->option (-format => $value);
786          }          }
787        }        }
788      }      }
789    }    }
   $self->{option}->{$name};  
790  }  }
791    
792  sub field_type ($$;$) {  sub field_type ($@) {shift->SUPER::value_type (@_)}
793    
794    ## $self->_fold ($string, %option = (-max, -initial_length(for field-name)) )
795    sub _fold ($$;%) {
796    my $self = shift;    my $self = shift;
797    my $field_name = shift;    my $string = shift;
798    my $new_field_type = shift;    my %option = @_;
799    if ($new_field_type) {    my $max = $self->{option}->{line_length_max};
800      $self->{option}->{field_type}->{$field_name} = $new_field_type;    $max = 20 if $max < 20;
801    }    
802    $self->{option}->{field_type}->{$field_name}    my $l = $option{-initial_length} || 0;
803    || $self->{option}->{field_type}->{':DEFAULT'};    $l += length $1 if $string =~ /^([^\x09\x20]+)/;
804      $string =~ s{([\x09\x20][^\x09\x20]+)}{
805        my $s = $1;
806        if (($l + length $s) > $max) {
807          $s = "\x0D\x0A\x20" . $s;
808          $l = 1 + length $s;
809        } else { $l += length $s }
810        $s;
811      }gex;
812      $string;
813  }  }
814    
815  sub _delete_empty_field ($) {  sub _ns_load_ph ($$) {
816    my $self = shift;    my $self = shift;
817    my @ret;    my $name = shift;     ## normalized prefix (without HYPHEN-MINUS)
818    for my $field (@{$self->{field}}) {    return if $self->{ns}->{phname2uri}->{$name};
819      push @ret, $field if $field->{name};    $self->{ns}->{phname2uri}->{$name} = $NS_phname2uri{$name};
820    }    $self->{ns}->{uri2phname}->{ $self->{ns}->{phname2uri}->{$name} } = $name;
821    $self->{field} = \@ret;  }
822    $self;  
823    sub _ns_associate_numerical_prefix ($) {
824      my $self = shift;
825      $self->scan (sub {shift;
826        my $f = shift;  return unless $f->{name};
827        if ($f->{ns} eq $self->{ns}->{phname2uri}->{'x-http'}
828         || $f->{ns} eq $self->{ns}->{phname2uri}->{'x-http-c'}) {
829          my $fn = $f->{name};
830          if ($fn eq 'opt' || $fn eq 'man') {
831            $f->{body} = $self->_parse_value ($fn => $f->{body}, ns => $f->{ns});
832            for ($f->{body}->value (0..$f->{body}->count-1)) {
833              my ($nsuri, $number) = ($_->value, $_->item ('ns'));
834              if ($number && $nsuri) {
835                $self->{ns}->{number2uri}->{ $number } = $nsuri;
836              }
837            }
838          }
839        }
840      });
841      $self->scan (sub {shift;
842        my $f = shift;
843        if ($f->{ns} =~ /urn:x-suika-fam-cx:msgpm:header:x-temp:([0-9]+)$/ && $self->{ns}->{number2uri}->{ $1 }) {
844          $f->{ns} = $self->{ns}->{number2uri}->{ $1 };
845        }
846      });
847  }  }
848    
849  sub fold ($$;$) {  ## $package_name = Message::Header::_NS_uri2phpackage ($nsuri)
850    my $self = shift;  ## (For internal use of Message::* modules)
851    my $string = shift;  sub _NS_uri2phpackage ($) {
852    my $len = shift || $self->{option}->{fold_length};    $NS_uri2phpackage{$_[0]}
853    $len = 60 if $len < 60;    || $NS_uri2phpackage{$Message::Header::Default::OPTION{namespace_uri}};
854      }
855    ## This code is taken from Mail::Header 1.43 in MailTools,  sub _NS_uri2package ($) {
856    ## by Graham Barr (Maintained by Mark Overmeer <mailtools@overmeer.net>).    $NS_uri2package{$_[0]}
857    my $max = int($len - 5);         # 4 for leading spcs + 1 for [\,\;]    || $NS_uri2phpackage{$_[0]}
858    my $min = int($len * 4 / 5) - 4;    || $NS_uri2phpackage{$Message::Header::Default::OPTION{namespace_uri}};
   my $ml = $len;  
     
   if (length($string) > $ml) {  
      #Split the line up  
      # first bias towards splitting at a , or a ; >4/5 along the line  
      # next split a whitespace  
      # else we are looking at a single word and probably don't want to split  
      my $x = "";  
      $x .= "$1\n "  
        while($string =~ s/^$REG{WSP}*(  
                           [^"]{$min,$max}?[\,\;]  
                           |[^"]{1,$max}$REG{WSP}  
                           |[^\s"]*(?:"[^"]*"[^\s"]*)+$REG{WSP}  
                           |[^\s"]+$REG{WSP}  
                           )  
                         //x);  
      $x .= $string;  
      $string = $x;  
      $string =~ s/(\A$REG{WSP}+|$REG{WSP}+\Z)//sog;  
      $string =~ s/\s+\n/\n/sog;  
   }  
   $string;  
859  }  }
860    
861    =head2 $self->clone ()
862    
863    Returns a copy of Message::Header object.
864    
865    =cut
866    
867    ## Inhreited
868    
869    =head1 NOTE
870    
871    =head2 C<field-name>
872    
873    The header field name is not case sensitive.  To make the life
874    easier for perl users who wants to avoid quoting before the => operator,
875    you can use '_' as a synonym for '-' in header field names
876    (this behaviour can be suppressed by setting
877    C<translate_underscore> option to C<0> value).
878    
879  =head1 EXAMPLE  =head1 EXAMPLE
880    
881    ## Print field list    ## Print field list
# Line 483  sub fold ($$;$) { Line 883  sub fold ($$;$) {
883    use Message::Header;    use Message::Header;
884    my $header = Message::Header->parse ($header);    my $header = Message::Header->parse ($header);
885        
   ## Next sample is better.  
   #for my $field (@$header) {  
   #  print $field->{name}, "\t=> ", $field->{body}, "\n";  
   #}  
     
886    for my $i (0..$#$header) {    for my $i (0..$#$header) {
887      print $header->field_name ($i), "\t=> ", $header->field_body ($i), "\n";      print $header->field_name ($i), "\t=> ", $header->field_body ($i), "\n";
888    }    }
# Line 510  sub fold ($$;$) { Line 905  sub fold ($$;$) {
905    $header->add ('References' => '<hoge.msgid%foo@foo.example>');    $header->add ('References' => '<hoge.msgid%foo@foo.example>');
906    print $header;    print $header;
907    
908    =head1 ACKNOWLEDGEMENTS
909    
910    Some of codes are taken from other modules such as
911    HTTP::Header, Mail::Header.
912    
913  =head1 LICENSE  =head1 LICENSE
914    
915  Copyright 2002 wakaba E<lt>w@suika.fam.cxE<gt>.  Copyright 2002 wakaba E<lt>w@suika.fam.cxE<gt>.
Legend:
Removed from v.1.13  
changed lines
  Added in v.1.40
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24