parsers

Documentation

Overview

Package parsers provides helper functions to parse and validate different type of string. It can be hosts, unix addresses, tcp addresses, filters, kernel operating system versions.

Index

• func ParseKeyValueOpt(opt string) (key string, value string, err error)
• func ParseUintList(val string) (map[int]bool, error)
• func ParseUintListMaximum(val string, maximum int) (map[int]bool, error)

Functions

func ParseKeyValueOpt

func ParseKeyValueOpt(opt string) (key string, value string, err error)

ParseKeyValueOpt parses and validates the specified string as a key/value pair (key=value).

Deprecated: use strings.Cut instead. This utility was only used internally, and will be removed in the next release.

func ParseUintList

func ParseUintList(val string) (map[int]bool, error)

ParseUintList parses and validates the specified string as the value found in some cgroup file (e.g. `cpuset.cpus`, `cpuset.mems`), which could be one of the formats below. Note that duplicates are actually allowed in the input string. It returns a `map[int]bool` with available elements from `val` set to `true`. Supported formats:

7
1-6
0,3-4,7,8-10
0-0,0,1-7
03,1-3      <- this is gonna get parsed as [1,2,3]
3,2,1
0-2,3,1

Deprecated: ParseUintList was only used internally and will be removed in the next release.

func ParseUintListMaximum

func ParseUintListMaximum(val string, maximum int) (map[int]bool, error)

ParseUintListMaximum parses and validates the specified string as the value found in some cgroup file (e.g. `cpuset.cpus`, `cpuset.mems`), which could be one of the formats below. Note that duplicates are actually allowed in the input string. It returns a `map[int]bool` with available elements from `val` set to `true`. Values larger than `maximum` cause an error if max is non zero, in order to stop the map becoming excessively large. Supported formats:

7
1-6
0,3-4,7,8-10
0-0,0,1-7
03,1-3      <- this is gonna get parsed as [1,2,3]
3,2,1
0-2,3,1

Deprecated: ParseUintListMaximum was only used internally and will be removed in the next release.