Mail::Message::Head::Delayed(3pm)

1Mail::Message::Head::DeUlsaeyredC(o3n)tributed Perl DocuMmaeinlt:a:tMieosnsage::Head::Delayed(3)
2
3
4

NAME

6       Mail::Message::Head::Delayed - a not-read header of a Mail::Message
7

INHERITANCE

9        Mail::Message::Head::Delayed realizes a Mail::Message::Head::Complete
10
11        Mail::Message::Head::Delayed
12          is a Mail::Message::Head
13          is a Mail::Reporter
14

SYNOPSIS

16        my $delayed = Mail::Message::Head::Delayed->new(...)
17        $delayed->isa('Mail::Message::Head')  # true
18        $delayed->guessBodySize               # undef
19        $delayed->isDelayed                   # true
20

DESCRIPTION

22       This object is used as place-holder, to be replaced by a
23       Mail::Message::Head when someone accesses the header of a message.
24

OVERLOADED

26       overload: ""
27           See "OVERLOADED" in Mail::Message::Head
28
29       overload: bool
30           See "OVERLOADED" in Mail::Message::Head
31

METHODS

33   Constructors
34       $obj->build(FIELDS)
35           You cannot create a delayed header with fields.
36
37       Mail::Message::Head::Delayed->new(OPTIONS)
38           See "Constructors" in Mail::Message::Head
39
40   The header
41       $obj->isDelayed
42           See "The header" in Mail::Message::Head
43
44       $obj->isEmpty
45           See "The header" in Mail::Message::Head
46
47       $obj->isModified
48           See "The header" in Mail::Message::Head
49
50       $obj->knownNames
51           See "The header" in Mail::Message::Head
52
53       $obj->message([MESSAGE])
54           See "The header" in Mail::Message::Head
55
56       $obj->modified([BOOLEAN])
57           See "The header" in Mail::Message::Head
58
59       $obj->orderedFields
60           See "The header" in Mail::Message::Head
61
62   Access to the header
63       $obj->get(NAME [,INDEX])
64           Get the information about the header line NAME.  Realization will
65           take place.
66
67       $obj->study(NAME [,INDEX])
68           See "Access to the header" in Mail::Message::Head
69
70   About the body
71       $obj->guessBodySize
72           On a delayed head, this retuns "undef", because when there is no
73           header there is also no body.
74
75           For messages in directory or network organized folders,
76           Mail::Message::size() usually will give a figure for the whole
77           message without much cost.  Subtract a few hundred bytes for the
78           header, and you will get a good estimate.
79
80       $obj->guessTimeStamp
81           Make a guess about when the message was originally posted.  On a
82           delayed head, this returns "undef".  For messages in directory or
83           network organized folders, Mail::Message::timestamp() usually will
84           give a figure without much cost.
85
86       $obj->isMultipart
87           See "About the body" in Mail::Message::Head
88
89   Internals
90       $obj->addNoRealize(FIELD)
91           See "Internals" in Mail::Message::Head
92
93       $obj->addOrderedFields(FIELDS)
94           See "Internals" in Mail::Message::Head
95
96       $obj->fileLocation
97           See "Internals" in Mail::Message::Head
98
99       $obj->load
100           See "Internals" in Mail::Message::Head
101
102       $obj->moveLocation(DISTANCE)
103           See "Internals" in Mail::Message::Head
104
105       $obj->read(PARSER)
106           See "Internals" in Mail::Message::Head
107
108       $obj->setNoRealize(FIELD)
109           See "Internals" in Mail::Message::Head
110
111   Error handling
112       $obj->AUTOLOAD
113           See "Error handling" in Mail::Reporter
114
115       $obj->addReport(OBJECT)
116           See "Error handling" in Mail::Reporter
117
118       $obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])
119           Mail::Message::Head::Delayed->defaultTrace([LEVEL]|[LOGLEVEL,
120           TRACELEVEL]|[LEVEL, CALLBACK])
121
122           See "Error handling" in Mail::Reporter
123
124       $obj->errors
125           See "Error handling" in Mail::Reporter
126
127       $obj->log([LEVEL [,STRINGS]])
128           Mail::Message::Head::Delayed->log([LEVEL [,STRINGS]])
129
130           See "Error handling" in Mail::Reporter
131
132       $obj->logPriority(LEVEL)
133           Mail::Message::Head::Delayed->logPriority(LEVEL)
134
135           See "Error handling" in Mail::Reporter
136
137       $obj->logSettings
138           See "Error handling" in Mail::Reporter
139
140       $obj->notImplemented
141           See "Error handling" in Mail::Reporter
142
143       $obj->report([LEVEL])
144           See "Error handling" in Mail::Reporter
145
146       $obj->reportAll([LEVEL])
147           See "Error handling" in Mail::Reporter
148
149       $obj->trace([LEVEL])
150           See "Error handling" in Mail::Reporter
151
152       $obj->warnings
153           See "Error handling" in Mail::Reporter
154
155   Cleanup
156       $obj->DESTROY
157           See "Cleanup" in Mail::Reporter
158
159       $obj->inGlobalDestruction
160           See "Cleanup" in Mail::Reporter
161

DIAGNOSTICS

163       Error: Cannot build() a delayed header.
164           A delayed message header cannot contain any information, so cannot
165           be build.  You can construct complete or subset headers.
166
167       Error: Package $package does not implement $method.
168           Fatal error: the specific package (or one of its superclasses) does
169           not implement this method where it should. This message means that
170           some other related classes do implement this method however the
171           class at hand does not.  Probably you should investigate this and
172           probably inform the author of the package.
173

LICENSE

179       Copyrights 2001-2011 by Mark Overmeer. For other contributors see
180       ChangeLog.
181
182       This program is free software; you can redistribute it and/or modify it
183       under the same terms as Perl itself.  See
184       http://www.perl.com/perl/misc/Artistic.html
185
186
187
188perl v5.12.3                      2011-01-26   Mail::Message::Head::Delayed(3)