File: format.go

package info (click to toggle)
golang-golang-x-text 0.14.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 41,604 kB
  • sloc: xml: 1,022; makefile: 6
file content (41 lines) | stat: -rw-r--r-- 1,207 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
// Copyright 2015 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// Package format contains types for defining language-specific formatting of
// values.
//
// This package is internal now, but will eventually be exposed after the API
// settles.
package format // import "golang.org/x/text/internal/format"

import (
	"fmt"

	"golang.org/x/text/language"
)

// State represents the printer state passed to custom formatters. It provides
// access to the fmt.State interface and the sentence and language-related
// context.
type State interface {
	fmt.State

	// Language reports the requested language in which to render a message.
	Language() language.Tag

	// TODO: consider this and removing rune from the Format method in the
	// Formatter interface.
	//
	// Verb returns the format variant to render, analogous to the types used
	// in fmt. Use 'v' for the default or only variant.
	// Verb() rune

	// TODO: more info:
	// - sentence context such as linguistic features passed by the translator.
}

// Formatter is analogous to fmt.Formatter.
type Formatter interface {
	Format(state State, verb rune)
}