Git Product home page Git Product logo

localsystem's Introduction

module function version lastdatetime
github.com/tinybear1976/localsystem
简单封装本地文件系统操作、日志操作及其他扩展函数
0.14.0
2022-02-06

目录

[TOC]

引用

go.mod

go 1.15

日志

InitLogger

初始化日志文件。需引用包路径 "hhyt/localsystem/logger"

func NewLogger(tag string, logFilenameWithPath string, loglevel string)

入口参数：

参数名 类型 描述
tag string 日志文件的tag，可以指定多个标记以致可以同时存在多个日志logger
logFilenameWithPath string 日志文件的完整文件名（带路径）
loglevel string 日志等级，如果传入空字符串，则默认debug：
debug
info
error
warn

返回值：

无（通过 logger.LogContainer["标签名"] 访问）

示例：

package main

import (
	"hhyt/localsystem"
	"hhyt/localsystem/logger"
	"path"
)

func main() {
	println(localsystem.CurrentDirectory())
	testlog()
}

func testlog() {
	p, _ := localsystem.CurrentDirectory()
    //返回的日志可操作指针可以保存到临时变量，也可以不保存，
	logger.NewLogger("log1",path.Join(p, "test.log"), "")
    //因为包内的Log已经公开，初始化后，可以在需要操作日志的模块中，引用该包，直接调用Log即可
    logger.LogContainer["log1"].Info("test infomation")
}

文件目录类

CurrentDirectory

获取当前系统路径，字符串末尾不带 / 。

func CurrentDirectory() (currentpath string, err error)

入口参数：

无

返回值：

返回变量 类型 描述
currentpath string 返回当前路径
err error 如果操作失败，返回异常，一般不会产生错误，可以忽略

IsDir

测试路径是否为目录。

func IsDir(path string) bool

入口参数：

参数名 类型 描述
path string 需要进行测试的路径

返回值：

返回变量 类型 描述
bool 返回值，true表示为目录，false表示不是目录

IsFile

测试路径是否为文件。

func IsFile(path string) bool

入口参数：

参数名 类型 描述
path string 需要进行测试的路径

返回值：

返回变量 类型 描述
bool 返回值，true表示为文件，false表示不是文件

Exists

测试路径是否存在。

func Exists(path string) bool

入口参数：

参数名 类型 描述
path string 需要进行测试的路径

返回值：

返回变量 类型 描述
bool 返回值，true表示存在，false表示不存在

FileNameOnly

测试路径是否存在。

func FileNameOnly(fullFilename string) string

入口参数：

参数名 类型 描述
fullFilename string 原始文件名，可以携带路径

返回值：

返回变量 类型 描述
string 返回不带路径与扩展名的主文件名

示例：

	p, _ := localsystem.CurrentDirectory()
	filename := path.Join(p, "test.log")
	println(filename)
    //返回结果为： test
	println(localsystem.FileNameOnly(filename))

FileNameWithoutPath

返回文件名及扩展名，去除路径。

func FileNameWithoutPath(fullFilename string) string

入口参数：

参数名 类型 描述
fullFilename string 原始文件名，可以携带路径

返回值：

返回变量 类型 描述
string 返回不带路径的 文件名+扩展名

CopyFile

复制磁盘文件。

func CopyFile(src, dst string) (int64, error)

入口参数：

参数名 类型 描述
src string 源文件名。可以携带路径
dst string 目标文件。可以携带路径

返回值：

返回变量 类型 描述
int64 返回复制文件的字节数
error 如果操作没有发生错误，返回nil

CreateMutiDir

创建多级目录。该操作直接将希望存在的目录结果以路径字符串方式输入，如果操作成功，多级目录将会自动建立出来。对于输入路径中某些级别的目录是否存在，忽略不计。

func CreateMutiDir(filePath string) error

入口参数：

参数名 类型 描述
filePath string 希望存在的路径。

返回值：

返回变量 类型 描述
error 如果操作没有发生错误，返回nil

日期时间类

DiffSecByStr

计算时间差（单位秒）。 公式 t2 - t1 =时间差秒数（理论应该>0）。第一时间为字符串，第二时间为time，t2-t1=相差秒,第一个时间应该小于第二个时间

func DiffSecByStr(firsttime string, endtime time.Time) int

入口参数：

参数名 类型 描述
firsttime string 计算的第一个时间(t1)，即较早的时间。
endtime time.Time 计算的第二个时间(t2)，即较早的时间。

返回值：

返回变量 类型 描述
int 相差秒数

DiffSecByStrWithFormat

计算时间差（单位秒）。 公式 ts2 - ts1 =时间差秒数（理论应该>0），用户规定传入的时间格式。ts1与ts2格式应该相同。第一时间为字符串，第二时间为字符串，第三个为日期格式，t2-t1=相差秒,第一个时间应该小于第二个时间，如果出现错误返回-1

func DiffSecByStrWithFormat(ts1, ts2, formattemp string) int

入口参数：

参数名 类型 描述
ts1 string 计算的第一个时间(t1)，即较早的时间。
ts2 string 计算的第二个时间(t2)，即较早的时间。

返回值：

返回变量 类型 描述
int 相差秒数,如果错误返回-1

DiffSecByStrWithFormatErr

与DiffSecByStrWithFormat相似，增加返回错误信息

func DiffSecByStrWithFormatErr(ts1, ts2, formattemp string) (int, error)

入口参数：

参数名 类型 描述
ts1 string 计算的第一个时间(t1)，即较早的时间。
ts2 string 计算的第二个时间(t2)，即较早的时间。

返回值：

返回变量 类型 描述
int 相差秒数
error 错误信息

SecondsToString

seconds为需要计算的秒数,如果为负数，函数会自动现将其调整为正数。模板参数"d:hh:mm:ss"为全格式，可以逐级减项，"d:hh:mm" "hh:mm:ss" "hh:mm" "mm:ss"，最少两项。

**功能提示：**该函数只是先将时间计算成 "d:hh:mm:ss"格式，然后按照需要，进行局部格式的裁剪，并且d表示为天数，为该整体格式最高单位，所以只能写一个d，其余部分最宽两位

func SecondsToString(seconds int, template string) string

入口参数：

参数名 类型 描述
seconds int 需要计算的秒数
template string 返回字符串的格式模板。

返回值：

返回变量 类型 描述
string 格式化字符串

SecondsToStringTimelong

将秒数转换成字符串格式，指定返回模板的最高位为完整计算数，可能会超过2位，比如mm:ss则表示所有的描述最大单位以分钟计数。 seconds为计算秒数,如果为负数，函数会自动现将其调整为正数。

模板参数"d:hh:mm:ss"为全格式，可以逐级减项，"d:hh:mm" "h:mm:ss" "h:mm" "m:ss"，最少两项。

如果模板截断最低位ss，结果将忽略秒数部分。

func SecondsToStringTimelong(seconds int, template string) string

入口参数：

参数名 类型 描述
seconds int 需要计算的秒数
template string 返回字符串的格式模板。

返回值：

返回变量 类型 描述
string 格式化字符串

String2Timestamp

将字符串，按照指定布局转换为时间。

func String2Timestamp(layout, value string) (time.Time, error)

入口参数：

参数名 类型 描述
layout string 对应value的时间格式字符串模板
value string 待转换的时间字符串

返回值：

返回变量 类型 描述
time.Time 转换的时间
error 错误

字符串类

ConcatStrings

通过传入字符串数组，拼接类SQL IN 条件 字符串。例如：["a","b","c"] => " 'a','b','c' "

func ConcatStrings(data []string, separator string, delimiter string) string

入口参数：

参数名 类型 描述
data []string 字符串数组
separator string 指定间隔符，比如 ,
delimiter string 每个字符串的定界符，比如 '

返回值：

返回变量 类型 描述
string 拼接结果字符串

InStrings

检索字符串值（target）是否在字符串数组（str_array）中存在中存在

func InStrings(target string, str_array []string) bool

入口参数：

参数名 类型 描述
target string 被检索值
str_array []string 最大范围的字符串数组

返回值：

返回变量 类型 描述
string 拼接结果字符串

GetLastRune

获得指定数量的结尾字符

func GetLastRune(str string, amount int) string

入口参数：

参数名 类型 描述
str string 被检索字符串
amount int 需要从右边返回的字符数量

返回值：

返回变量 类型 描述
string 结果字符串

RemoveLastRune

获得指定数量的结尾字符

func RemoveLastRune(str string, amount int) string

入口参数：

参数名 类型 描述
str string 原始字符串
amount int 需要从右边删除的字符数量

返回值：

返回变量 类型 描述
string 结果字符串

Float64toString

float64转换成字符串

func Float64toString(f64 float64) string

算法

归并排序

int

// package:  localsystem.algorithm
data := IntSlice_MergeSort([]int{2, 3, 1})
// Sort方法传入true 升序排列，如果传入false降序排列
got := data.Sort(true)

float64

// package:  localsystem.algorithm
data := Float64Slice_MergeSort([]float64{2.2, 30.3, 1})
// Sort方法传入true 升序排列，如果传入false降序排列
got := data.Sort(true)

数据结构

Set4String

为字符串设计的集合

包路径：localsystem/datastructure/set

New_SetString

根据一个字符串切片创建一个字符串集合

func New(strSlice []string) Set4String

Intersection

求两（或多个）个字符串集合的交集。字符串集合方法

func (set1 Set4String) Intersection(sets ...Set4String) Set4String

Compare

比较两个集合是否所有元素一致

func (set1 Set4String) Compare(set2 Set4String) bool

Union

多个集合合并（并集）

func (set1 Set4String) Union(sets ...Set4String) (Set4String, error)

IsExist

检查1个或多个字符串在集合中是否存。有一个不存在就返回false，全部存在返回true。如果入参没有传入任何内容，返回false。如果指定的集合没有任何内容返回false。

func (set1 Set4String) IsExist(keys ...string) bool

Categorizing

将给定的字符串按照在集合中出现、未出现进行分检返回。如果被检索集合（set1）不包含任何元素，则传入检索项全部返回non_exist。如果没有传入参数，则返回的 exist, non_exist分别都为空集合

func (set1 Set4String) Categorizing(keys ...string) (exist, non_exist Set4String)

ToStringSlice

将集合转为字符串切片

func (set1 Set4String) ToStringSlice() []string

Add

增加元素到集合

func (set1 Set4String) Add(keys ...string)

Remove

从集合中移除指定key

func (set1 Set4String) Remove(keys ...string)

Set4Int

为字符串设计的集合

包路径：localsystem/datastructure/set

New_SetInt

根据一个字符串切片创建一个字符串集合

func New(strSlice []string) Set4String

Intersection

求两（或多个）个字符串集合的交集。字符串集合方法

func (set1 Set4String) Intersection(sets ...Set4String) Set4String

Compare

比较两个集合是否所有元素一致

func (set1 Set4String) Compare(set2 Set4String) bool

Union

多个集合合并（并集）

func (set1 Set4String) Union(sets ...Set4String) (Set4String, error)

IsExist

检查1个或多个字符串在集合中是否存。有一个不存在就返回false，全部存在返回true。如果入参没有传入任何内容，返回false。如果指定的集合没有任何内容返回false。

func (set1 Set4String) IsExist(keys ...string) bool

Categorizing

将给定的字符串按照在集合中出现、未出现进行分检返回。如果被检索集合（set1）不包含任何元素，则传入检索项全部返回non_exist。如果没有传入参数，则返回的 exist, non_exist分别都为空集合

func (set1 Set4String) Categorizing(keys ...string) (exist, non_exist Set4String)

ToStringSlice

将集合转为字符串切片

func (set1 Set4String) ToStringSlice() []string

Add

增加元素到集合

func (set1 Set4String) Add(keys ...string)

Remove

从集合中移除指定key

func (set1 Set4String) Remove(keys ...string)

localsystem's People

Contributors

tinybear1976 avatar

Watchers

avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.