Object
strict が真のときはヘッダのパースに失敗すると例外 ParseError を 発生します。偽のときはエラーを無視します。
UNIX mbox のような形式は単独では対応して いません。別途ローダーを使ってください。
ただしここに書きこんでもロード元のファイル(や文字列)は変更されません。 実際に変更するためにはこのポートに書きこんだ後 Mail#write_back を呼ぶ 必要があります。
ただしここに書きこんでもロード元のファイル(や文字列)は変更されません。 実際に変更するためにはこのポートに書きこんだ後 Mail#write_back を呼ぶ 必要があります。
ただしここに書きこんでもロード元のファイル(や文字列)は変更されません。 実際に変更するためにはこのポートに書きこんだ後 Mail#write_back を呼ぶ 必要があります。
0.9 からの to_s はこのメソッドとは違うはたらきをします。
"#<TMail::Mail port=
のような簡潔な文字列化を行います。
- date( default = nil ), date=( time )
-
Date ヘッダで表現される時刻(Time オブジェクト)です。
- to( default = nil ), to=( str )
-
To ヘッダの一番最初のアドレスの文字列 (self['to'].addrs[0].address) です。
To が存在しないときは default を返します。
- to_addrs( default = nil ), to_addrs=( array )
-
To ヘッダと対応するアドレスの Address オブジェクト、の配列
(tmail['to'].addrs) を返します。存在しない時は default を返します。
- from_address( default = nil ), from_address=( str )
- from( default = nil ), from=( str )
-
From の一番最初のアドレスです。
From が存在しないときは default を返します。
- from_phrase( default = nil )
-
From の一番最初のアドレスの phrase 部分を返します。
From が存在しないときは default を返します。
- from_addrs( default = nil ), from_addrs=( array )
-
From に対応するアドレスの Address オブジェクト、の配列を返します。
存在しないときは default を返します。
- subject( default = '' ), subject=( str )
-
Subject です。
Subject ヘッダがないときは default を返します。
- msgid( default = '' ), msgid=( str )
-
メッセージID です。
- mime_version( default = nil ), mime_version=( m, opt = nil )
-
MIME バージョンを '1.0' のような文字列で返します。
セットする時は、'1.0' のような文字列か major と minor
二つの整数を使ってください。
- main_type( default = nil )
-
メール本体のメインタイプを返します。
- sub_type( default = nil )
-
メール本体のサブタイプを返します。
- charset( default = nil ), charset=( str )
-
Content-Type の charset パラメータです。
セットする時は main_type が 'text' でなければならないことに気をつけてください。
- set_content_type( main, sub, params = nil )
-
コンテントタイプを main/sub; param ; param ; ... のように設定します。
params は Hash です。
- encoding( default = nil ), encoding=( str )
-
転送時エンコーディングの方式です。主に 7bit、8bit、binary などがあります。
- destinations
-
To、Cc、Bcc のアドレス(addr-spec 文字列)すべてを配列で返します。
- each_dest {|addr_spec| ....}
-
全ての宛先(addr-spec 文字列)に対するくりかえし。
- clear
-
ヘッダを全て消去します。
- keys
-
ヘッダ名の配列を返します。
- self[ key ]
-
ヘッダ名からヘッダオブジェクトを返します。
- self[ key ] = val
-
keyヘッダの内容としてvalヘッダオブジェクトを使います。
- delete( key )
-
keyヘッダを消します。
- delete_if {|key, val| ..... }
-
ヘッダ名とヘッダを与えてブロックを評価し、真ならその関連づけを消します。
- each_header {|name, field| ... }
- each_pair {|name, field| ... }
-
全てのヘッダ名とヘッダオブジェクトに対するくりかえし。
- each_header_name {|name| .... }
- each_key {|name| .... }
-
全てのヘッダ名に対するくりかえし。
- each_field {|field| ... }
- each_value {|field| ... }
-
全てのヘッダオブジェクトに対するくりかえし。
- orderd_each {|name, field| .... }
-
ヘッダの順序指定付きの each_header です。最初に指定したものが指定した
順番で並び、その他のヘッダがランダムに続きます。順序は文字列の配列
TMail::Mail::FIELD_ORDER で設定してください(詳細はソースコードを参照)。
TMail#encoded/decoded からも使われます。
- self[ key ]
- fetch( key, default_body )
- fetch( key ) { ... }
-
keyヘッダに対応するヘッダオブジェクトを返します。配列 TMail::Mail::USE_ARRAY に
名前が設定されているヘッダに対しては('Received'など)、ヘッダオブジェクトの
配列が返ります。key ヘッダが存在しない場合は default_body に与えられた文字列を
ヘッダボディとして登録したうえでそのヘッダオブジェクトを返します。
default_body が省略され、ブロックが与えられたときは、そのブロックを評価した結果を
default_body として使います。
- has_key?( name )
- include?( name )
- key?( name )
-
name ヘッダがあれば真。
- has_value?( field )
- value?( field )
-
field ヘッダオブジェクトがあれば真。
- indexes( *keys )
- indices( *keys )
-
全てのkeysについてfetchした結果の配列を返します。
- self[ fname ] = fbody
- store( fname, fbody )
-
fname ヘッダを fbody に設定します。fbody は文字列か HeaderField オブジェクトです。
Received: など一部のヘッダに対してはさらにその配列も与えることができます。
- values
-
登録されている全てのヘッダオブジェクトの配列を返します。
Copyright (c) 1998-2001 Minero Aoki <aamine@dp.u-netsurf.ne.jp>