util

Documentation

Index

• func ParseBool(b string) *bool
• func ParseHexUint64s(ss []string) ([]*uint64, error)
• func ParsePInt64s(ss []string) ([]*int64, error)
• func ParseUint32s(ss []string) ([]uint32, error)
• func ParseUint64s(ss []string) ([]uint64, error)
• func ReadFileNoStat(filename string) ([]byte, error)
• func ReadIntFromFile(path string) (int64, error)
• func ReadUintFromFile(path string) (uint64, error)
• func SysReadFile(file string) (string, error)
• type ValueParser
  • func NewValueParser(v string) *ValueParser
  • func (vp *ValueParser) Err() error
  • func (vp *ValueParser) Int() int
  • func (vp *ValueParser) PInt64() *int64
  • func (vp *ValueParser) PUInt64() *uint64

Functions

func ParseBool

func ParseBool(b string) *bool

ParseBool parses a string into a boolean pointer.

func ParseHexUint64s

func ParseHexUint64s(ss []string) ([]*uint64, error)

Parses a uint64 from given hex in string.

func ParsePInt64s

func ParsePInt64s(ss []string) ([]*int64, error)

ParsePInt64s parses a slice of strings into a slice of int64 pointers.

func ParseUint32s

func ParseUint32s(ss []string) ([]uint32, error)

ParseUint32s parses a slice of strings into a slice of uint32s.

func ParseUint64s

func ParseUint64s(ss []string) ([]uint64, error)

ParseUint64s parses a slice of strings into a slice of uint64s.

func ReadFileNoStat

func ReadFileNoStat(filename string) ([]byte, error)

ReadFileNoStat uses io.ReadAll to read contents of entire file. This is similar to os.ReadFile but without the call to os.Stat, because many files in /proc and /sys report incorrect file sizes (either 0 or 4096). Reads a max file size of 1024kB. For files larger than this, a scanner should be used.

func ReadIntFromFile

func ReadIntFromFile(path string) (int64, error)

ReadIntFromFile reads a file and attempts to parse a int64 from it.

func ReadUintFromFile

func ReadUintFromFile(path string) (uint64, error)

ReadUintFromFile reads a file and attempts to parse a uint64 from it.

func SysReadFile

func SysReadFile(file string) (string, error)

SysReadFile is a simplified os.ReadFile that invokes syscall.Read directly. https://github.com/prometheus/node_exporter/pull/728/files

Note that this function will not read files larger than 128 bytes.

Types

type ValueParser

type ValueParser struct {
	// contains filtered or unexported fields
}

A ValueParser enables parsing a single string into a variety of data types in a concise and safe way. The Err method must be invoked after invoking any other methods to ensure a value was successfully parsed.

func NewValueParser

func NewValueParser(v string) *ValueParser

NewValueParser creates a ValueParser using the input string.

func (*ValueParser) Err

func (vp *ValueParser) Err() error

Err returns the last error, if any, encountered by the ValueParser.

func (*ValueParser) Int

func (vp *ValueParser) Int() int

Int interprets the underlying value as an int and returns that value.

func (*ValueParser) PInt64

func (vp *ValueParser) PInt64() *int64

PInt64 interprets the underlying value as an int64 and returns a pointer to that value.

func (*ValueParser) PUInt64

func (vp *ValueParser) PUInt64() *uint64

PUInt64 interprets the underlying value as an uint64 and returns a pointer to that value.