1
1
# encoding: utf-8
2
- #
2
+ #
3
3
# = Blind Carbon Copy Field
4
- #
4
+ #
5
5
# The Bcc field inherits from StructuredField and handles the Bcc: header
6
6
# field in the email.
7
- #
7
+ #
8
8
# Sending bcc to a mail message will instantiate a Mail::Field object that
9
9
# has a BccField as its field type. This includes all Mail::CommonAddress
10
10
# module instance metods.
11
- #
11
+ #
12
12
# Only one Bcc field can appear in a header, though it can have multiple
13
13
# addresses and groups of addresses.
14
- #
14
+ #
15
15
# == Examples:
16
- #
16
+ #
17
17
# mail = Mail.new
18
18
# mail.bcc = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
19
19
# mail.bcc #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
20
20
# mail[:bcc] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::BccField:0x180e1c4
21
21
# mail['bcc'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::BccField:0x180e1c4
22
22
# mail['Bcc'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::BccField:0x180e1c4
23
- #
23
+ #
24
24
# mail[:bcc].encoded #=> '' # Bcc field does not get output into an email
25
25
# mail[:bcc].decoded #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
26
26
# mail[:bcc].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
27
27
# mail[:bcc].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
28
- #
28
+ #
29
29
require 'mail/fields/common/common_address'
30
30
31
31
module Mail
32
32
class BccField < StructuredField
33
-
33
+
34
34
include Mail ::CommonAddress
35
-
35
+
36
36
FIELD_NAME = 'bcc'
37
37
CAPITALIZED_FIELD = 'Bcc'
38
-
38
+
39
39
def initialize ( value = '' , charset = 'utf-8' )
40
40
@charset = charset
41
- super ( CAPITALIZED_FIELD , strip_field ( FIELD_NAME , value ) , charset )
41
+ super ( CAPITALIZED_FIELD , value || "" , charset )
42
42
self
43
43
end
44
-
44
+
45
45
def include_in_headers = ( include_in_headers )
46
46
@include_in_headers = include_in_headers
47
47
end
@@ -58,10 +58,10 @@ def encoded
58
58
''
59
59
end
60
60
end
61
-
61
+
62
62
def decoded
63
63
do_decode
64
64
end
65
-
65
+
66
66
end
67
67
end
0 commit comments