README
¶
Go语言工具辅助库
Go语言是一门伟大、强大的语言，我接触他只有一个多月的时间，已经深刻感受到了他的魅力。
不得不说，Go仍是一门处于发展阶段的语言，尤其是他也是游走于面向函数、面向对象和面向接口编程的边缘（和Scala类似，不过Scala的类和Trait的数量实在让人望而却步）。也包括Go本身提供的很多类库，都存在大量的枚举、反射、hardcode的问题。
所以有了这个工具辅助库，这个库的设计初衷是面向使用，而非做一个大全、或高性能（毕竟Go已经提供了一个环境），我最主要的一个目的就是，将一些日常频繁使用的方法，能用一个统一明确的方式返回结果，少写两个if。
获取指令：go get git.oschina.net/janpoem/go-agi
工具库
agi.SplitDirFile(path string) (string, string)
根据传入的路径，分离出目录和文件
agi.RealPathSplitDirFile(path string) (string, string, error)
基于真实的物理路径，检查传入的路径，并分离出目录和文件名，这个函数还有待调整。
agi.Exist(path string) bool
检查路径是否存在，这个不会区分是文件还是目录。
agi.IsFile(path string) bool
检查路径是不是文件
agi.IsDir(path string) bool
检查路径是不是目录
agi.ReadFileByte(path string) ([]byte, error)
读取指定的文件，并返回[]byte
agi.ReadFileStr(path string) (string, error)
读取指定的文件，并返回字符串
agi.TF(format string) (string)
生成go的时间格式，主要基于PHP的时间格式，目前支持：Y-m-d H:i:s和Y-n-j H:i:s
agi.OffsetIndex(index int, size int) int
取得索引值的偏移值，-1对应的是size的最末。
agi.Seconds(seconds int) time.Duration
取得多少秒的间隔时间
agi.Minutes(minutes int) time.Duration
取得多少分钟的间隔时间
agi.Hours(hours int) time.Duration
取得多少小时的间隔时间
性能测试
这部分以后会改为一个Benchmark struct。性能测试的代码，主要为了方便对一些写法的性能能快速的做一个甄别，以后会考虑加入CPU和内存的监控。
agi.TimesTest(times int, fn func(int)) time.Duration
循环执行指定的匿名函数次数，并返回执行过程所花费的时间。
运行时
这里主要提供一些识别运行时的环境变量，并且这些环境变量不应该可变，所以采用函数的方式来查询。
agi.Args() []string
返回执行当前文件的命令行参数，注意不包含可执行文件本身。这里会后面会加入start-stop-daemon的那个--的判断。
agi.AppPath() string
返回当前执行文件的全路径
agi.AppDir() string
返回当前执行文件的目录
agi.AppFile() string
返回当前执行文件的文件名
agi.AppTimeZone() string
返回当前运行时的时区名称，注意，凡是涉及当前运行时的时区，偏移值的，都是基于启动时，创建一个time.Now()，需要确保你执行环境的系统已经设置了正确的时区（服务器上手第一修正时区，第二upgrade）。
agi.AppTimeOffset() int
取得当前时区的日期偏移值
agi.AppTimeLoc() *time.Location
返回当前时区的Location对象，如果你输出这个对象会不显示任何值（都是私有值），在很多修正时间的地方需要用到。
agi.GetOsFlag() int
取得系统的标示整型OS_LINUX => 0, OS_MAC => 1, OS_WIN => 2, OS_OTHERS => 3。
agi.GetOsEof() string
取得系统的EOF
agi.GetOsDirSpr() string
取得系统目录的分隔符。
agi.GetOsEndian() binary.ByteOrder
取得系统的编码顺序，大小编码，你懂的。
类型处理
agi.BytesToStrUnsafe(rawBytes []byte) string
[]byte转字符串类型，据说是黑魔法
agi.Round(f float64, places int) string
浮点数取精确的小数点数
agi.StrToFloat(value string) float64
字符串数值转浮点，返回的是float64。如果为非数值字符，返回0
agi.StrToFInt(value string) int
字符串数值转整型，不过会先转为浮点，而后再转为整型，尽可能的取得一个有效的值。如果为非数值字符，返回0
agi.StrToFInt64(value string) int64
字符串数值转64位整型，同上
agi.StrToInt(value string) int
这个只是单纯意义的转整型。
agi.StrToIntBool(value string) bool
字符串整值转为布尔类型，这里特别针对0 => false, 大于 0 => true，而不同于go本身提供的ParseBoolean
agi.StrToTime(value string, layout string) time.Time
字符串的时间值，转为时间类型，layout这里是输入go那个奇葩的时间格式：Mon Jan 2 15:04:05 -0700 MST 2006。
为了方便使用，目前提供一个函数agi.TF("Y-m-d H:i:s")的方式转为go的时间格式（PHP风格），不过小弟时间有限，没有支持太多的format。
整体调用时：agi.StrToTime("2014-12-31 12:33:34", agi.TF("Y-m-d H:i:s"))
agi.IntToTime(value int64) time.Time
字符串的数值转为时间类型，特别注意，如果传入的值 <= 0，也会返回一个时间值，但这个时间类型的值得是无效的。要判断其是否为有效的时间值，需要使用agi.IsValidTime(agi.IntToTime(value))。
agi.IsValidTime(t time.Time) bool
检查传入的时间值是不是一个有效的时间值。
agi.CallAnyStructMethod(v interface{}, method string) interface{}
调用任意结构的任意的方法，这个函数还需要修改，需要允许传参数，和返回[]interface{}
agi.KindOf(v interface {}) reflect.Kind
取得任意变量的go原生类型（值反射）。注意，这里获取的是go的原生类型，这是个非常非常重要的方法。如果传入的变量是一个指针，会直接去取指针指向的实际变量。
比如有下面的代码：
type XYZ struct {
}
type MyInt int
var mya MyInt = 1
agi.KindOf(&XYZ{}) // struct，用于程序等式判断的话，是reflect.Struct
agi.KindOf(mya) // int，用于程序等式判断的话，是reflect.Int
agi.ValueOf(v interface {}) reflect.Value
取得任意变量的实际值（值反射），和KindOf一样，如果是一个指针，会去取指针实际指向的变量。
agi.ValueOf、agi.KindOf、agi.CallAnyStructMethod是三个杀手级的方法，go的反射其实蛮完善的，就是……用起来比较费劲，有了这三个函数，能助你立刻去掉那些纷繁的东西，迅速掌握go的反射。让你用起Go语言，比用PHP还简单。
agi.AnyToInt64(v interface{}) int64
agi.AnyToInt(v interface{}) int
agi.AnyToInt8(v interface{}) int8
agi.AnyToInt16(v interface{}) int16
agi.AnyToUInt8(v interface{}) uint8
agi.AnyToUInt16(v interface{}) uint16
agi.AnyToUInt64(v interface{}) uint64
任意值类型，转为整型，目标就是要能涵盖目前go可能出现的变量类型。并且支持，如果是一个结构，尝试检索对象是否具有一个叫做Int的方法，并返回该函数的结果。
agi.AnyToBool(v interface{}) bool
任意值类型转布尔类型，如果传入的是数组、切片、map的话，会检查他们的长度是否大于0，大于0就返回true。
agi.AnyToStr(v interface{}) string
任意值类型转字符串类型，如果是一个结构，会尝试执行结构的String的方法。
agi.AnyToFloat(v interface{}) float64
任意值类型转float64类型，如果是一个结构，会尝试执行Float的方法。
agi.AnyToRound(v interface{}, places int) float64
任意值类型，Round方法，会先转浮点，而后执行Round。
agi.AnyToTime(v interface{}) time.Time
任意值类型，转时间类型，如果是一个结构，会先尝试执行结构的Time方法。
Documentation
¶
Index ¶
- Constants
- func AnyToBool(v interface{}) bool
- func AnyToFloat(v interface{}) float64
- func AnyToInt(v interface{}) int
- func AnyToInt16(v interface{}) int16
- func AnyToInt64(v interface{}) int64
- func AnyToInt8(v interface{}) int8
- func AnyToRound(v interface{}, places int) float64
- func AnyToStr(v interface{}) string
- func AnyToTime(v interface{}) time.Time
- func AnyToUInt16(v interface{}) uint16
- func AnyToUInt64(v interface{}) uint64
- func AnyToUInt8(v interface{}) uint8
- func AppDir() string
- func AppFile() string
- func AppPath() string
- func AppTimeLoc() *time.Location
- func AppTimeOffset() int
- func AppTimeZone() string
- func Args() []string
- func BytesToStrUnsafe(rawBytes []byte) string
- func CallAnyMethod(v interface{}, method string) interface{}
- func Exist(path string) bool
- func GetOsDirSpr() string
- func GetOsEndian() binary.ByteOrder
- func GetOsEof() string
- func GetOsFlag() int
- func Hours(hours int) time.Duration
- func IntToTime(value int64) time.Time
- func IsDir(path string) bool
- func IsFile(path string) bool
- func IsValidTime(t time.Time) bool
- func KindOf(v interface{}) reflect.Kind
- func KindToInt64(v interface{}) int64
- func Minutes(minutes int) time.Duration
- func OffsetIndex(index int, size int) int
- func ReadFileByte(path string) ([]byte, error)
- func ReadFileStr(path string) (string, error)
- func RealPathSplitDirFile(path string) (string, string, error)
- func Round(f float64, places int) float64
- func Seconds(seconds int) time.Duration
- func SplitDirFile(path string) (string, string)
- func StrToFInt(value string) int
- func StrToFInt64(value string) int64
- func StrToFloat(value string) float64
- func StrToInt(value string) int
- func StrToIntBool(value string) bool
- func StrToTime(value string, layout string) time.Time
- func TF(format string) string
- func TimesTest(times int, fn func(int)) time.Duration
- func ValueOf(v interface{}) reflect.Value
Constants ¶
const ( OS_LINUX = iota OS_MAC OS_WIN OS_OTHERS )
Variables ¶
This section is empty.
Functions ¶
func AnyToInt16 ¶
func AnyToInt16(v interface{}) int16
小位数的整型，还是经常会用到的 溢出值，以溢出的最大值处理，而不要作为负数处理 65536 / 2
func AnyToInt64 ¶
func AnyToInt64(v interface{}) int64
转型最好优先转型到最大的值，然后再往底缩进 更精确的做法，应该是根据位长，来做出适当的判断但过度优化，又不如直接用go提供一些方法 所以这个方法只是确保值的有效性转换，性能在能考虑的条件下，才考虑
func AnyToStr ¶
func AnyToStr(v interface{}) string
注意，所有其他的AnyTo转换，都不处理[]byte，因为实际上[]byte的情况会比较复杂，他可能包含了encode/gob的编码格式，也可能是json格式 也可能用户自己打包的，所以我们不做任何处理 但AnyToStr的话还是要处理，尝试最简单的转换
func AnyToUInt16 ¶
func AnyToUInt16(v interface{}) uint16
无负数的小位数整型，其实也是很常用到的，32的就自己手动转吧，uint32能表达的值意境非常大了
func BytesToStrUnsafe ¶
func IsValidTime ¶
go的时间 var t = time.Time {} => t.IsZero() => true var t = time.Unix(0, 0) => t.IsZero() => false
func Round ¶
func StrToTime ¶
将字符串的时间表示，转为时间，注意是类似2014-12-31，不是整型值 如果要指定时区解析，直接调用time.ParseInLocation吧
Types ¶
This section is empty.
Source Files
Directories