xlib/README.md

# golang util library #

(c) softlandia@gmail.com

>download: go get -u github.com/softlandia/xlib  
>install: go install

## functions ##

    func Secret(s string) string
      returns a string with the middle removed, "passport" -> "pa...rt"

    func AtoI(s string, def int) int
      returns int from string, on error return def

    func StrHash(s string) uint32
      returns 32bit hash from string, using fnv.New32a

    func StrContainBackSlash(s string) bool
      returns true if string s contain rune back slash '\'

    func StrIsPrintRune(s string) bool  
      returns true if input string contain only of printable rune

    func ChangeFileExt(iFileName, newExt string) string  
      returns file name with new extention

    func FileExists(name string) bool  
      returns true if file exist

    func Max(x, y int) int
      returns max from int

    func SortBytes(b []byte) []byte
      returns sorted slice of byte

    func SeekFileStop(fileName, strToSearch string) (int, *bufio.Scanner, error)
      search string in text file and return *bufio.Scanner at founded line
      return number of line if string 'strToSearch' founded
      return scanner on line with string 'strToSearch'. first call scanner.Text() - return this line
      return (-1, nil, nil) if string 'strToSearch' not founded
      return (-1, nil, nil) if string 'strToSearch' is empty
      return (0, nil, err) if file not open or error occure when file reading
      successfull opened file NOT CLOSED in any case!
      strToSearch must contain only base ASCII rune

    func FindFilesExt(fileList *[]string, path, fileNameExt string) (int, error)  
      search all files in path with 'ext' & put to slice
      sample:  n, err := FindFilesExt(&fl, "c:\\tmp", ".log")

## tests ##

coverage 94%  
folder "test_files" contain files for testing, no remove/change/add