Documentation
¶
Index ¶
- type Directives
- type Dispenser
- func (d *Dispenser) Addr() (string, error)
- func (d *Dispenser) ArgErr() error
- func (d *Dispenser) Args(targets ...*string) bool
- func (d *Dispenser) EOFErr() error
- func (d *Dispenser) Err(msg string) error
- func (d *Dispenser) Errf(format string, args ...any) error
- func (d *Dispenser) File() string
- func (d *Dispenser) Keys() []string
- func (d *Dispenser) Line() int
- func (d *Dispenser) Nesting() int
- func (d *Dispenser) Next() bool
- func (d *Dispenser) NextArg() bool
- func (d *Dispenser) NextBlock(initialNestingLevel int) bool
- func (d *Dispenser) NextLine() bool
- func (d *Dispenser) PropEmptyErr(prop string) error
- func (d *Dispenser) PropErr(err ...error) error
- func (d *Dispenser) RemainingAddrs() ([]string, error)
- func (d *Dispenser) RemainingArgs() []string
- func (d *Dispenser) RemainingIPs() ([]string, error)
- func (d *Dispenser) SyntaxErr(expected string) error
- func (d *Dispenser) Val() string
- type ServerBlock
- type Token
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Directives ¶
type Dispenser ¶
type Dispenser struct {
// contains filtered or unexported fields
}
Dispenser is a type that dispenses tokens, similarly to a lexer, except that it can do so with some notion of structure and has some really convenient methods.
func NewDispenser ¶
NewDispenser returns a Dispenser filled with the given tokens.
func NewTestDispenser ¶
func (*Dispenser) Addr ¶ added in v0.5.0
Addr parses the host and port in the current token, i.e. 127.0.0.0:53 is parsed and returned, same for IPv6 addresses [2004:32]:53. If there is no port the default port will be added (53).
func (*Dispenser) ArgErr ¶
ArgErr returns an argument error, meaning that another argument was expected but not found. In other words, a line break or open curly brace was encountered instead of an argument.
func (*Dispenser) Args ¶
Args is a convenience function that loads the next arguments (tokens on the same line) into an arbitrary number of strings pointed to in targets. If there are fewer tokens available than string pointers, the remaining strings will not be changed and false will be returned. If there were enough tokens available to fill the arguments, then true will be returned.
func (*Dispenser) EOFErr ¶
EOFErr returns an error indicating that the dispenser reached the end of the input when searching for the next token.
func (*Dispenser) File ¶
File gets the filename of the current token. If there is no token loaded, it returns the filename originally given when parsing started.
func (*Dispenser) Line ¶
Line gets the line number of the current token. If there is no token loaded, it returns 0.
func (*Dispenser) Nesting ¶
Nesting returns the current nesting level. Necessary if using NextBlock()
func (*Dispenser) Next ¶
Next loads the next token. Returns true if a token was loaded; false otherwise. If false, all tokens have been consumed.
func (*Dispenser) NextArg ¶
NextArg loads the next token if it is on the same line. Returns true if a token was loaded; false otherwise. If false, all tokens on the line have been consumed. It handles imported tokens correctly.
func (*Dispenser) NextBlock ¶
NextBlock can be used as the condition of a for loop to load the next token as long as it opens a block or is already in a block. It returns true if a token was loaded, or false when the block's closing curly brace was loaded and thus the block ended. Nested blocks are not supported.
func (*Dispenser) NextLine ¶
NextLine loads the next token only if it is not on the same line as the current token, and returns true if a token was loaded; false otherwise. If false, there is not another token or it is on the same line. It handles imported tokens correctly.
func (*Dispenser) PropEmptyErr ¶ added in v0.5.24
PropEmptyErr create a error that a property was not defined or still empty after parsing.
func (*Dispenser) PropErr ¶
PropErr return a property error, meaning that x was expect but we got y.
func (*Dispenser) RemainingAddrs ¶ added in v0.5.0
RemainingAddrs calls RemainingArgs and return each actual address. If the address does not have port :53 is added.
func (*Dispenser) RemainingArgs ¶
RemainingArgs loads any more arguments (tokens on the same line) into a slice and returns them. Open curly brace tokens also indicate the end of arguments, and the curly brace is not included in the return value nor is it loaded.
func (*Dispenser) RemainingIPs ¶ added in v0.5.4
RemainingIPs calls RemainingArgs and return all IPs. If a arg does not look like an IP, it is assume to be a interface name.
Source Files