csvutils

README

csvutils

CSV utility library for Go.

Installation

1. Run go get git.mirkodi.eu/mirk0dex/csvutils in your terminal emulator of choice, inside the directory your Go source code is;

2. add the following to your imports:

   csvutils "git.mirkodi.eu/mirk0dex/csvutils"

   .

   So, for instance, if the top of your source file looked like this:

       import (
           "fmt"
       )
   

   it would now look like this:

   import (
       "fmt"
   
       csvutils "git.mirkodi.eu/mirk0dex/csvutils"
   )
   

   .

Documentation

Index

• func CSVToMap(filename string, keyPosition, valuePosition int) (map[string]string, error)
• func CSVToMapMulti(filename string, keyPosition int, valuePositions ...int) (map[string][]string, error)
• func CSVToMapMultiReader(f io.Reader, keyPosition int, valuePositions ...int) (map[string][]string, error)
• func CSVToMapReader(f io.Reader, keyPosition, valuePosition int) (map[string]string, error)
• func GetCSVValue(filename, pattern string, ...) (string, error)
• func GetCSVValueReader(f io.Reader, pattern string, ...) (string, error)
• func GetCSVValueWhereStringIsFound(filename string, n int, stringToLookFor string, caseSensitive bool) (string, error)
• func GetCSVValueWhereStringIsFoundReader(f io.Reader, n int, stringToLookFor string, caseSensitive bool) (string, error)
• func GetValuesInColumnNFromCSV(filename string, n int) ([]string, error)
• func GetValuesInColumnNFromCSVReader(f io.Reader, n int) ([]string, error)
• func OnCSV(filename string, minValues int, function func(i int, record []string)) error
• func OnCSVCSVReader(r *csv.Reader, minValues int, function func(i int, record []string)) error
• func OnCSVReader(f io.Reader, minValues int, function func(i int, record []string)) error
• func OnEachLineCSV(filename string, minValues int, function func(i int, record []string)) error
• func OnEachLineCSVReader(f io.Reader, minValues int, function func(i int, record []string)) error

Functions

func CSVToMap

func CSVToMap(filename string, keyPosition, valuePosition int) (map[string]string, error)

returns given CSV file's contents as map[string]string

func CSVToMapMulti

func CSVToMapMulti(filename string, keyPosition int, valuePositions ...int) (map[string][]string, error)

returns given CSV file's contents as map[string][]string

func CSVToMapMultiReader

func CSVToMapMultiReader(f io.Reader, keyPosition int, valuePositions ...int) (map[string][]string, error)

returns given CSV file's contents as map[string][]string (but with io.Reader arg)

func CSVToMapReader

func CSVToMapReader(f io.Reader, keyPosition, valuePosition int) (map[string]string, error)

func GetCSVValue

func GetCSVValue(filename, pattern string, positionOfValueToReturn, positionOfValueToLookFor int, caseSensitive, contains bool) (string, error)

gets value in position positionOfValueToReturn in the line where pattern is found at position positionOfValueToLookFor

func GetCSVValueReader

func GetCSVValueReader(f io.Reader, pattern string, positionOfValueToReturn, positionOfValueToLookFor int, caseSensitive, contains bool) (string, error)

func GetCSVValueWhereStringIsFound

func GetCSVValueWhereStringIsFound(filename string, n int, stringToLookFor string, caseSensitive bool) (string, error)

returns value at column n at line where string is found; returns strNil if nothing is found

NOTE: columns start from 0

func GetCSVValueWhereStringIsFoundReader

func GetCSVValueWhereStringIsFoundReader(f io.Reader, n int, stringToLookFor string, caseSensitive bool) (string, error)

func GetValuesInColumnNFromCSV

func GetValuesInColumnNFromCSV(filename string, n int) ([]string, error)

get all values in column n in CSV file

func GetValuesInColumnNFromCSVReader

func GetValuesInColumnNFromCSVReader(f io.Reader, n int) ([]string, error)

get all values in column n in CSV file (io.Reader)

func OnCSV

func OnCSV(filename string, minValues int, function func(i int, record []string)) error

run given function on each line in CSV

func OnCSVCSVReader

func OnCSVCSVReader(r *csv.Reader, minValues int, function func(i int, record []string)) error

OnCSV(), but *csv.Reader must be passed instead of a filename or a io.Reader

func OnCSVReader

func OnCSVReader(f io.Reader, minValues int, function func(i int, record []string)) error

OnCSV(), but io.Reader must be passed instead of a filename

func OnEachLineCSV

func OnEachLineCSV(filename string, minValues int, function func(i int, record []string)) error

alias for OnCSV()

func OnEachLineCSVReader

func OnEachLineCSVReader(f io.Reader, minValues int, function func(i int, record []string)) error

alias for OnCSVReader()