mime

package
v1.25.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 5, 2025 License: MIT Imports: 2 Imported by: 0

Documentation

Overview

mimeパッケージはMIME仕様の一部を実装します。

Index

Examples

Constants

View Source 
const (
	// BEncodingは、RFC 2045によって定義されたBase64エンコーディングスキームを表します。
	BEncoding = WordEncoder('b')
	// QEncodingは、RFC 2047によって定義されたQ-エンコーディングスキームを表します。
	QEncoding = WordEncoder('q')
)

Variables

View Source 
var ErrInvalidMediaParameter = errors.New("mime: invalid media parameter")

ErrInvalidMediaParameterは、ParseMediaType によって メディアタイプの値が見つかったが、オプションのパラメータの解析でエラーがあった場合に返されます

Functions

func AddExtensionType 

func AddExtensionType(ext, typ string) error

AddExtensionTypeは、拡張子extに関連付けられたMIMEタイプをtypに設定します。 拡張子は、".html"のように先頭にドットを付けて開始する必要があります。

func ExtensionsByType added in v1.5.0 

func ExtensionsByType(typ string) ([]string, error)

ExtensionsByTypeは、MIMEタイプtypに関連付けられていると知られている拡張子を返します。 返される拡張子は、".html"のように先頭にドットが付いて始まります。 typが関連付けられた拡張子を持っていない場合、ExtensionsByTypeはnilスライスを返します。

func FormatMediaType 

func FormatMediaType(t string, param map[string]string) string

FormatMediaTypeは、メディアタイプtとパラメータparamをRFC 2045とRFC 2616に準拠した メディアタイプとしてシリアライズします。タイプとパラメータ名は小文字で書かれます。 引数のいずれかが標準違反を引き起こす場合、FormatMediaTypeは空の文字列を返します。

Example 
package main

import (
	"github.com/shogo82148/std/fmt"
	"github.com/shogo82148/std/mime"
)

func main() {
	mediatype := "text/html"
	params := map[string]string{
		"charset": "utf-8",
	}

	result := mime.FormatMediaType(mediatype, params)

	fmt.Println("result:", result)
}

Output:
result: text/html; charset=utf-8

func ParseMediaType 

func ParseMediaType(v string) (mediatype string, params map[string]string, err error)

ParseMediaTypeは、RFC 1521に従ってメディアタイプの値と任意の パラメータを解析します。メディアタイプは、 Content-TypeとContent-Dispositionヘッダー（RFC 2183）の値です。 成功すると、ParseMediaTypeは空白を削除して小文字に変換したメディアタイプと nilでないマップを返します。 オプションのパラメータの解析でエラーがある場合、 メディアタイプとエラー ErrInvalidMediaParameter が返されます。 返されるマップ、paramsは、小文字の属性から ケースが保持された属性値へのマップです。

Example 
package main

import (
	"github.com/shogo82148/std/fmt"
	"github.com/shogo82148/std/mime"
)

func main() {
	mediatype, params, err := mime.ParseMediaType("text/html; charset=utf-8")
	if err != nil {
		panic(err)
	}

	fmt.Println("type:", mediatype)
	fmt.Println("charset:", params["charset"])
}

Output:
type: text/html
charset: utf-8

func TypeByExtension 

func TypeByExtension(ext string) string

TypeByExtensionは、ファイル拡張子extに関連付けられたMIMEタイプを返します。 拡張子extは、".html"のように先頭にドットを付けて開始する必要があります。 extが関連付けられたタイプを持っていない場合、TypeByExtensionは""を返します。

拡張子は、最初に大文字と小文字を区別して検索され、次に大文字と小文字を区別せずに検索されます。

組み込みのテーブルは小さいですが、unixではローカルシステムのMIME-infoデータベースや mime.typesファイルによって補強されます（もし以下の名前の一つ以上で利用可能な場合）: 

/usr/local/share/mime/globs2
/usr/share/mime/globs2
/etc/mime.types
/etc/apache2/mime.types
/etc/apache/mime.types

Windowsでは、MIMEタイプはレジストリから抽出されます。

テキストタイプは、デフォルトでcharsetパラメータが"utf-8"に設定されています。

Types

type WordDecoder added in v1.5.0 

type WordDecoder struct {
	// CharsetReaderがnilでない場合、提供されたcharsetからUTF-8に変換する
	// charset変換リーダーを生成する関数を定義します。
	// Charsetは常に小文字です。utf-8、iso-8859-1、us-ascii charsetは
	// デフォルトで処理されます。
	// CharsetReaderの結果値のうちの1つは非nilでなければなりません。
	CharsetReader func(charset string, input io.Reader) (io.Reader, error)
}

WordDecoderは、RFC 2047のエンコードされた単語を含むMIMEヘッダーをデコードします。

func (*WordDecoder) Decode added in v1.5.0 

func (d *WordDecoder) Decode(word string) (string, error)

Decodeは、RFC 2047のエンコードされた単語をデコードします。

Example 
package main

import (
	"github.com/shogo82148/std/bytes"
	"github.com/shogo82148/std/fmt"
	"github.com/shogo82148/std/io"
	"github.com/shogo82148/std/mime"
)

func main() {
	dec := new(mime.WordDecoder)
	header, err := dec.Decode("=?utf-8?q?=C2=A1Hola,_se=C3=B1or!?=")
	if err != nil {
		panic(err)
	}
	fmt.Println(header)

	dec.CharsetReader = func(charset string, input io.Reader) (io.Reader, error) {
		switch charset {
		case "x-case":
			// 例のためのフェイクキャラクターセット。
			// 実際の使用では、code.google.com/p/go-charsetのようなパッケージと統合します。
			content, err := io.ReadAll(input)
			if err != nil {
				return nil, err
			}
			return bytes.NewReader(bytes.ToUpper(content)), nil
		default:
			return nil, fmt.Errorf("unhandled charset %q", charset)
		}
	}
	header, err = dec.Decode("=?x-case?q?hello!?=")
	if err != nil {
		panic(err)
	}
	fmt.Println(header)
}

Output:
¡Hola, señor!
HELLO!

func (*WordDecoder) DecodeHeader added in v1.5.0 

func (d *WordDecoder) DecodeHeader(header string) (string, error)

DecodeHeaderは、与えられた文字列のすべてのエンコードされた単語をデコードします。 dの WordDecoder.CharsetReader がエラーを返す場合にのみエラーを返します。

Example 
package main

import (
	"github.com/shogo82148/std/bytes"
	"github.com/shogo82148/std/fmt"
	"github.com/shogo82148/std/io"
	"github.com/shogo82148/std/mime"
)

func main() {
	dec := new(mime.WordDecoder)
	header, err := dec.DecodeHeader("=?utf-8?q?=C3=89ric?= <eric@example.org>, =?utf-8?q?Ana=C3=AFs?= <anais@example.org>")
	if err != nil {
		panic(err)
	}
	fmt.Println(header)

	header, err = dec.DecodeHeader("=?utf-8?q?=C2=A1Hola,?= =?utf-8?q?_se=C3=B1or!?=")
	if err != nil {
		panic(err)
	}
	fmt.Println(header)

	dec.CharsetReader = func(charset string, input io.Reader) (io.Reader, error) {
		switch charset {
		case "x-case":
			// 例のためのフェイクキャラクターセット。
			// 実際の使用では、code.google.com/p/go-charsetのようなパッケージと統合します。
			content, err := io.ReadAll(input)
			if err != nil {
				return nil, err
			}
			return bytes.NewReader(bytes.ToUpper(content)), nil
		default:
			return nil, fmt.Errorf("unhandled charset %q", charset)
		}
	}
	header, err = dec.DecodeHeader("=?x-case?q?hello_?= =?x-case?q?world!?=")
	if err != nil {
		panic(err)
	}
	fmt.Println(header)
}

Output:
Éric <eric@example.org>, Anaïs <anais@example.org>
¡Hola, señor!
HELLO WORLD!

type WordEncoder added in v1.5.0 

type WordEncoder byte

WordEncoderは、RFC 2047のエンコードされたワードエンコーダです。

func (WordEncoder) Encode added in v1.5.0 

func (e WordEncoder) Encode(charset, s string) string

Encodeは、sのエンコードされた単語形式を返します。もしsが特殊文字を含まないASCIIであれば、 それは変更されずに返されます。提供されたcharsetは、sのIANA 文字セット名です。それは大文字と小文字を区別しません。

Example 
package main

import (
	"github.com/shogo82148/std/fmt"
	"github.com/shogo82148/std/mime"
)

func main() {
	fmt.Println(mime.QEncoding.Encode("utf-8", "¡Hola, señor!"))
	fmt.Println(mime.QEncoding.Encode("utf-8", "Hello!"))
	fmt.Println(mime.BEncoding.Encode("UTF-8", "¡Hola, señor!"))
	fmt.Println(mime.QEncoding.Encode("ISO-8859-1", "Caf\xE9"))
}

Output:
=?utf-8?q?=C2=A1Hola,_se=C3=B1or!?=
Hello!
=?UTF-8?b?wqFIb2xhLCBzZcOxb3Ih?=
=?ISO-8859-1?q?Caf=E9?=

Source Files

View all Source files

Directories

Path Synopsis
multipartパッケージは、RFC 2046で定義されているMIMEマルチパートの解析を実装します。
 multipartパッケージは、RFC 2046で定義されているMIMEマルチパートの解析を実装します。
quotedprintableパッケージは、RFC 2045で指定されているquoted-printableエンコーディングを実装します。
 quotedprintableパッケージは、RFC 2045で指定されているquoted-printableエンコーディングを実装します。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.