[![Join the chat at https://gitter.im/bluesuncorp/validator](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/bluesuncorp/validator?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Join the chat at https://gitter.im/bluesuncorp/validator](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/bluesuncorp/validator?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
// returns nil or ValidationErrors ( map[string]*FieldError )
errs := validate.Struct(user)
errs := validate.Struct(user)
if errs != nil {
if errs != nil {
// err will be of type *FieldError
fmt.Println(errs) // output: Key: "User.Age" Error:Field validation for "Age" failed on the "lte" tag
err := errs.Errors["Age"]
// Key: "User.Addresses[0].City" Error:Field validation for "City" failed on the "required" tag
fmt.Println(err.Error()) // output: Field validation for "Age" failed on the "lte" tag
err := errs["User.Addresses[0].City"]
fmt.Println(err.Field) // output: Age
fmt.Println(err.Tag) // output: lte
fmt.Println(err.Kind) // output: uint8
fmt.Println(err.Type) // output: uint8
fmt.Println(err.Param) // output: 130
fmt.Println(err.Value) // output: 135
// or if you prefer you can use the Flatten function
// NOTE: I find this usefull when using a more hard static approach of checking field errors.
// The above, is best for passing to some generic code to say parse the errors. i.e. I pass errs
// to a routine which loops through the errors, creates and translates the error message into the
// users locale and returns a map of map[string]string // field and error which I then use
// within the HTML rendering.
flat := errs.Flatten()
fmt.Println(flat) // output: map[Age:Field validation for "Age" failed on the "lte" tag Addresses[0].Address.City:Field validation for "City" failed on the "required" tag]
err = flat["Addresses[0].Address.City"]
fmt.Println(err.Field) // output: City
fmt.Println(err.Field) // output: City
fmt.Println(err.Tag) // output: required
fmt.Println(err.Tag) // output: required
fmt.Println(err.Kind) // output: string
fmt.Println(err.Kind) // output: string
@ -126,14 +114,18 @@ func main() {
Benchmarks
Benchmarks
------
------
###### Run on MacBook Pro (Retina, 15-inch, Late 2013) 2.6 GHz Intel Core i7 16 GB 1600 MHz DDR3
###### Run on MacBook Pro (Retina, 15-inch, Late 2013) 2.6 GHz Intel Core i7 16 GB 1600 MHz DDR3
NOTE: allocations for structs are up from v5, however ns/op for parallel operations are way down.
It was a decicion not to cache struct info because although it reduced allocation to v5 levels, it
// returns nil or ValidationErrors ( map[string]*FieldError )
errs:=validate.Struct(user)
errs:=validate.Struct(user)
iferrs!=nil{
iferrs!=nil{
// err will be of type *FieldError
fmt.Println(errs)// output: Key: "User.Age" Error:Field validation for "Age" failed on the "lte" tag
err:=errs.Errors["Age"]
// Key: "User.Addresses[0].City" Error:Field validation for "City" failed on the "required" tag
fmt.Println(err.Error())// output: Field validation for "Age" failed on the "lte" tag
err:=errs["User.Addresses[0].City"]
fmt.Println(err.Field)// output: Age
fmt.Println(err.Tag)// output: lte
fmt.Println(err.Kind)// output: uint8
fmt.Println(err.Type)// output: uint8
fmt.Println(err.Param)// output: 130
fmt.Println(err.Value)// output: 135
// or if you prefer you can use the Flatten function
// NOTE: I find this usefull when using a more hard static approach of checking field errors.
// The above, is best for passing to some generic code to say parse the errors. i.e. I pass errs
// to a routine which loops through the errors, creates and translates the error message into the
// users locale and returns a map of map[string]string // field and error which I then use
// within the HTML rendering.
flat:=errs.Flatten()
fmt.Println(flat)// output: map[Age:Field validation for "Age" failed on the "lte" tag Addresses[0].Address.City:Field validation for "City" failed on the "required" tag]