1
0
mirror of https://github.com/duke-git/lancet.git synced 2026-03-01 00:35:28 +08:00

Compare commits

...

12 Commits

Author SHA1 Message Date
dudaodong
5b6def5ff0 doc: update style link 2023-08-27 11:50:44 +08:00
dudaodong
33d99ad7d4 doc: add demo 2023-08-27 11:43:48 +08:00
dudaodong
8bd31d39c3 docs: update doc 2023-08-27 11:41:29 +08:00
dudaodong
a418549525 doc: update meta url 2023-08-25 17:43:10 +08:00
dudaodong
1f849efe1c doc: update doc for datetime fileutil formatter function package 2023-08-25 14:31:49 +08:00
dudaodong
8ad374bb21 doc: update doc for datastructure package 2023-08-25 11:05:33 +08:00
dudaodong
a69d886565 doc: add go playground demo 2023-08-25 10:49:16 +08:00
dudaodong
cf58542b4a doc: add new doc for convertor and cryptor 2023-08-25 10:47:16 +08:00
dudaodong
51f166d1d9 doc: update doc styles 2023-08-24 19:27:47 +08:00
dudaodong
fbeb031b40 doc: update doc 2023-08-24 19:07:24 +08:00
dudaodong
095cfc0aab doc: add new site for doc 2023-08-24 17:47:03 +08:00
ggymm
e66ab154bc fix: 覆盖写入字符串到文件问题 (#128) 2023-08-24 16:36:44 +08:00
93 changed files with 2660 additions and 615 deletions

4
.gitignore vendored
View File

@@ -9,4 +9,6 @@ fileutil/unzip/*
fileutil/tempdir/*
slice/testdata/*
cryptor/*.pem
test
test
docs/node_modules
docs/.vitepress/cache

View File

@@ -101,7 +101,6 @@ func main() {
- [Validator](#user-content-validator)
- [Xerror](#user-content-xerror)
<h3 id="algorithm">1. Algorithm package implements some basic algorithm. eg. sort, search. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>
```go
@@ -587,7 +586,6 @@ import "github.com/duke-git/lancet/v2/datetime"
[[doc](https://github.com/duke-git/lancet/blob/main/docs/datetime.md#TimestampNano)]
[[play](https://go.dev/play/p/A9Oq_COrcCF)]
<h3 id="datastructure"> 8. Datastructure package constains some common data structure. eg. list, linklist, stack, queue, set, tree, graph. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>
```go
@@ -843,7 +841,7 @@ import "github.com/duke-git/lancet/v2/maputil"
- **<big>IsDisjoint</big>** : check two map are disjoint if they have no keys in common.
[[doc](https://github.com/duke-git/lancet/blob/main/docs/maputil.md#IsDisjoint)]
[[play](https://go.dev/play/p/N9qgYg_Ho6f)]
- **<big>HasKey</big>** : checks if map has key or not.
- **<big>HasKey</big>** : checks if map has key or not.
[[doc](https://github.com/duke-git/lancet/blob/main/docs/maputil.md#HasKey)]
[[play](https://go.dev/play/p/isZZHOsDhFc)]
- **<big>NewConcurrentMap</big>** : creates a ConcurrentMap with specific shard count.
@@ -861,7 +859,7 @@ import "github.com/duke-git/lancet/v2/maputil"
- **<big>ConcurrentMap_Delete</big>** : delete the value for a key.
[[doc](https://github.com/duke-git/lancet/blob/main/docs/maputil.md#ConcurrentMap_Delete)]
[[play](https://go.dev/play/p/uTIJZYhpVMS)]
- **<big>ConcurrentMap_GetAndDelete</big>** :returns the existing value for the key if present and then delete the value for the key.
- **<big>ConcurrentMap_GetAndDelete</big>** :returns the existing value for the key if present and then delete the value for the key.
[[doc](https://github.com/duke-git/lancet/blob/main/docs/maputil.md#ConcurrentMap_GetAndDelete)]
[[play](https://go.dev/play/p/ZyxeIXSZUiM)]
- **<big>ConcurrentMap_Has</big>** : checks if map has the value for a key.
@@ -871,7 +869,6 @@ import "github.com/duke-git/lancet/v2/maputil"
[[doc](https://github.com/duke-git/lancet/blob/main/docs/maputil.md#ConcurrentMap_Range)]
[[play](https://go.dev/play/p/iqcy7P8P0Pr)]
<h3 id="mathutil"> 13. Mathutil package implements some functions for math calculation. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>
```go
@@ -952,6 +949,9 @@ import "github.com/duke-git/lancet/v2/mathutil"
- **<big>Sum</big>** : return sum of passed numbers.
[[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#Sum)]
[[play](https://go.dev/play/p/1To2ImAMJA7)]
- **<big>Abs</big>** : returns the absolute value of param nubmer.
[[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#Sum)]
[[play](https://go.dev/play/p/fsyBh1Os-1d)]
<h3 id="netutil"> 14. Netutil package contains functions to get net information and send http request. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>
@@ -1326,7 +1326,6 @@ import "github.com/duke-git/lancet/v2/slice"
[[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#Join)]
[[play](https://go.dev/play/p/huKzqwNDD7V)]
<h3 id="stream"> 19. Stream package implements a sequence of elements supporting sequential and operations. this package is an experiment to explore if stream in go can work as the way java does. its function is very limited. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>
```go

View File

@@ -953,6 +953,9 @@ import "github.com/duke-git/lancet/v2/mathutil"
- **<big>Sum</big>** : 求传入参数之和。
[[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#Sum)]
[[play](https://go.dev/play/p/1To2ImAMJA7)]
- **<big>Abs</big>** : 求绝对值。
[[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#Sum)]
[[play](https://go.dev/play/p/fsyBh1Os-1d)]
<h3 id="netutil"> 14. netutil 网络包支持获取 ip 地址,发送 http 请求。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

View File

@@ -66,6 +66,7 @@ func GreaterOrEqual(left, right any) bool {
}
// InDelta checks if two values are equal or not within a delta.
// Play: https://go.dev/play/p/TuDdcNtMkjo
func InDelta[T constraints.Integer | constraints.Float](left, right T, delta float64) bool {
return float64(mathutil.Abs(left-right)) <= delta
}

View File

@@ -105,7 +105,7 @@ func HmacMd5(str, key string) string {
}
// HmacMd5WithBase64 return the hmac hash of string use md5 with base64.
// todo
// https://go.dev/play/p/UY0ng2AefFC
func HmacMd5WithBase64(data, key string) string {
h := hmac.New(md5.New, []byte(key))
h.Write([]byte(data))

89
docs/.vitepress/common.ts Normal file
View File

@@ -0,0 +1,89 @@
import { defineConfig, HeadConfig } from 'vitepress'
export const META_IMAGE = '/lancet_logo.png'
export const isProduction = process.env.NETLIFY && process.env.CONTEXT === 'production'
if (process.env.NETLIFY) {
console.log('Netlify build', process.env.CONTEXT)
}
const productionHead: HeadConfig[] = [
[
'script',
{
src: 'https://unpkg.com/thesemetrics@latest',
async: '',
type: 'text/javascript',
},
],
]
const rControl = /[\u0000-\u001f]/g
const rSpecial = /[\s~`!@#$%^&*()\-_+=[\]{}|\\;:"'“”‘’<>,.?/]+/g
const rCombining = /[\u0300-\u036F]/g
/**
* Default slugification function
*/
export const slugify = (str: string): string =>
str
.normalize('NFKD')
// Remove accents
.replace(rCombining, '')
// Remove control characters
.replace(rControl, '')
// Replace special characters
.replace(rSpecial, '-')
// ensure it doesn't start with a number
.replace(/^(\d)/, '_$1')
export const commonConfig = defineConfig({
title: 'Lancet',
appearance: 'dark',
markdown: {
theme: {
dark: 'dracula-soft',
light: 'vitesse-light',
},
attrs: {
leftDelimiter: '%{',
rightDelimiter: '}%',
},
anchor: {
slugify,
},
},
head: [
// ['link', { rel: 'icon', type: 'image/svg+xml', href: '/logo.svg' }],
['link', { rel: 'icon', type: 'image/png', href: '/lancet_logo_mini.png' }],
['meta', { name: 'theme-color', content: '#5f67ee' }],
['meta', { name: 'og:type', content: 'website' }],
['meta', { name: 'og:locale', content: 'zh' }],
...(isProduction ? productionHead : []),
],
themeConfig: {
logo: { src: '/lancet_logo_mini.png', width: 24, height: 24 },
outline: [2, 3],
search: {
provider: 'local',
},
socialLinks: [
{
icon: 'github',
link: 'https://github.com/duke-git/lancet',
},
],
footer: {
copyright: 'Copyright © 2023-present Duke Du',
message: 'Released under the MIT License.',
},
},
})

View File

@@ -0,0 +1,14 @@
import { defineConfig } from 'vitepress'
import { commonConfig } from './common'
import { zhConfig } from './zh'
import { enConfig } from './en'
// https://vitepress.dev/reference/site-config
export default defineConfig({
...commonConfig,
locales: {
root: { label: '简体中文', lang: 'zh-CN', link: '/', ...zhConfig },
en: { label: 'English', lang: 'en-US', link: '/en/', ...enConfig },
},
})

102
docs/.vitepress/en.ts Normal file
View File

@@ -0,0 +1,102 @@
import type { DefaultTheme, LocaleSpecificConfig } from 'vitepress'
export const META_URL = 'https://golancet.dev'
export const META_TITLE = 'Lancet'
export const META_DESCRIPTION = 'A powerful util function library of Go'
export const enConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
description: META_DESCRIPTION,
head: [
['meta', { property: 'og:url', content: META_URL }],
['meta', { property: 'og:description', content: META_DESCRIPTION }],
['meta', { property: 'twitter:url', content: META_URL }],
['meta', { property: 'twitter:title', content: META_TITLE }],
['meta', { property: 'twitter:description', content: META_DESCRIPTION }],
],
themeConfig: {
nav: [
{
text: 'Home',
link: '/en/',
activeMatch: '^/en/',
},
{
text: 'Guide',
link: '/en/guide/introduction',
activeMatch: '^/en/guide/',
},
{ text: 'API', link: '/en/api/overview', activeMatch: '^/en/api/' },
{
text: 'Links',
items: [
{
text: 'Releaselog',
link: 'https://github.com/duke-git/lancet/releases',
},
],
},
],
sidebar: {
'/en/': [
{
text: 'Introduction',
collapsed: false,
items: [
{
text: 'What is Lancet',
link: '/en/guide/introduction',
},
{
text: 'getting started',
link: '/en/guide/getting_started',
},
],
},
],
'/en/api/': [
{
text: 'overview',
items: [{ text: 'overview of API', link: '/en/api/overview' }],
},
{
text: 'packages',
collapsed: false,
items: [
{ text: 'algorithm', link: '/en/api/packages/algorithm' },
{ text: 'compare', link: '/en/api/packages/compare' },
{ text: 'concurrency', link: '/en/api/packages/concurrency' },
{ text: 'condition', link: '/en/api/packages/condition' },
{ text: 'convertor', link: '/en/api/packages/convertor' },
{ text: 'cryptor', link: '/en/api/packages/cryptor' },
{
text: 'datastructure',
collapsed: true,
items: [
{ text: 'list', link: '/en/api/packages/datastructure/list' },
{ text: 'safelist', link: '/en/api/packages/datastructure/copyonwritelist' },
{ text: 'link', link: '/en/api/packages/datastructure/link' },
{ text: 'stack', link: '/en/api/packages/datastructure/stack' },
{ text: 'queue', link: '/en/api/packages/datastructure/queue' },
{ text: 'heap', link: '/en/api/packages/datastructure/heap' },
{ text: 'tree', link: '/en/api/packages/datastructure/tree' },
{ text: 'set', link: '/en/api/packages/datastructure/set' },
{ text: 'hashmap', link: '/en/api/packages/datastructure/hashmap' },
],
},
{ text: 'datetime', link: '/en/api/packages/datetime' },
{ text: 'fileutil', link: '/en/api/packages/fileutil' },
{ text: 'formatter', link: '/en/api/packages/formatter' },
{ text: 'function', link: '/en/api/packages/function' },
{ text: 'mathutil', link: '/en/api/packages/mathutil' },
{ text: 'maputil', link: '/en/api/packages/maputil' },
{ text: 'netutil', link: '/en/api/packages/netutil' },
{ text: 'pointer', link: '/en/api/packages/pointer' },
],
},
],
},
},
}

115
docs/.vitepress/zh.ts Normal file
View File

@@ -0,0 +1,115 @@
import type { DefaultTheme, LocaleSpecificConfig } from 'vitepress'
export const META_URL = 'https://lancet.dev'
export const META_TITLE = 'Lancet'
export const META_DESCRIPTION = '一个强大的Go语言工具函数库'
export const zhConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
description: META_DESCRIPTION,
head: [
['meta', { property: 'og:url', content: META_URL }],
['meta', { property: 'og:description', content: META_DESCRIPTION }],
['meta', { property: 'twitter:url', content: META_URL }],
['meta', { property: 'twitter:title', content: META_TITLE }],
['meta', { property: 'twitter:description', content: META_DESCRIPTION }],
],
themeConfig: {
outline: {
label: '本页内容',
},
docFooter: {
prev: '上一页',
next: '下一页',
},
nav: [
{
text: '首页',
link: '/',
activeMatch: '^/',
},
{
text: '指南',
link: '/guide/introduction',
activeMatch: '^/guide/',
},
{ text: 'API', link: '/api/overview', activeMatch: '^/api/' },
{
text: '相关链接',
items: [
{
text: '更新日志',
link: 'https://github.com/duke-git/lancet/releases',
},
],
},
],
sidebar: {
'/': [
{
text: '介绍',
collapsed: true,
items: [
{
text: 'Lancet是什么',
link: '/guide/introduction',
},
{
text: '开始',
link: '/guide/getting_started',
},
],
},
],
'/api/': [
{
text: '概览',
items: [{ text: 'API概述', link: '/api/overview' }],
},
{
text: 'API文档',
collapsed: false,
items: [
{ text: '算法', link: '/api/packages/algorithm' },
{ text: '比较器', link: '/api/packages/compare' },
{ text: '并发处理', link: '/api/packages/concurrency' },
{ text: '条件判断', link: '/api/packages/condition' },
{ text: '类型转换', link: '/api/packages/convertor' },
{ text: '加密&解密', link: '/api/packages/cryptor' },
{
text: '数据结构',
collapsed: true,
items: [
{ text: '线性表', link: '/api/packages/datastructure/list' },
{
text: '线性表(线程安全)',
link: '/api/packages/datastructure/copyonwritelist',
},
{ text: '链表', link: '/api/packages/datastructure/link' },
{ text: '栈', link: '/api/packages/datastructure/stack' },
{ text: '队列', link: '/api/packages/datastructure/queue' },
{ text: '堆', link: '/api/packages/datastructure/heap' },
{ text: '树', link: '/api/packages/datastructure/tree' },
{ text: '集合', link: '/api/packages/datastructure/set' },
{ text: 'HashMap', link: '/api/packages/datastructure/hashmap' },
],
},
{ text: '日期&时间', link: '/api/packages/datetime' },
{ text: '文件', link: '/api/packages/fileutil' },
{ text: '格式化工具', link: '/api/packages/formatter' },
{ text: '函数', link: '/api/packages/function' },
{ text: '数学工具', link: '/api/packages/mathutil' },
{ text: 'Map', link: '/api/packages/maputil' },
{ text: '网络', link: '/api/packages/netutil' },
{ text: '指针', link: '/api/packages/pointer' },
],
},
],
},
},
}

69
docs/api/overview.md Normal file
View File

@@ -0,0 +1,69 @@
---
outline: deep
---
# API概述
<b>lancet柳叶刀是一个强大、全面、高效、可复用的go语言工具函数库。包含25个包超过600个工具函数。功能涵盖字符串处理、切片处理、网络、并发、加解密、文件处理、时间/日期、流处理、迭代器等等。</b>
<style>
.package-title {
color: black;
font-size: 18px;
text-align: center;
font-weight: bold;
}
.package-container {
font-size: 16px;
border: 1px dashed;
padding: 10px;
text-align: center;
}
.package-cell {
height: 40px;
width: 140px;
display: inline-block;
vertical-align: middle;
line-height: 40px;
background: #ecefff;
border: 1px solid;
margin-right: 10px;
margin-bottom: 10px;
border-radius: 6px;
font-weight: bold;
}
</style>
<div>
<p class="package-title">lancet功能模块</p>
<div class="package-container">
<div class="package-cell">algorithm</div>
<div class="package-cell">compare</div>
<div class="package-cell">concurrency</div>
<div class="package-cell">condition</div>
<div class="package-cell">convertor</div>
<div class="package-cell">cryptor</div>
<div class="package-cell">datastructure</div>
<div class="package-cell">datetime</div>
<div class="package-cell">fileutil</div>
<div class="package-cell">formatter</div>
<div class="package-cell">function</div>
<div class="package-cell">iterator</div>
<div class="package-cell">maputil</div>
<div class="package-cell">mathutil</div>
<div class="package-cell">netutil</div>
<div class="package-cell">pointer</div>
<div class="package-cell">random</div>
<div class="package-cell">retry</div>
<div class="package-cell">slice</div>
<div class="package-cell">stream</div>
<div class="package-cell">structs</div>
<div class="package-cell">strutil</div>
<div class="package-cell">system</div>
<div class="package-cell">tuple</div>
<div class="package-cell">validator</div>
<div class="package-cell">xerror</div>
</div>
</div>

View File

@@ -39,6 +39,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="BubbleSort">BubbleSort</span>
@@ -51,7 +53,7 @@ import (
func BubbleSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/GNdv7Jg2Taj)</span></b>
```go
package main
@@ -99,7 +101,7 @@ func main() {
func InsertionSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/G5LJiWgJJW6)</span></b>
```go
package main
@@ -162,7 +164,7 @@ func main() {
func SelectionSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/oXovbkekayS)</span></b>
```go
package main
@@ -210,7 +212,7 @@ func main() {
func ShellSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/3ibkszpJEu3)</span></b>
```go
package main
@@ -258,7 +260,7 @@ func main() {
func QuickSort[T any](slice []T comparator lancetconstraints.Comparator)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/7Y7c1Elk3ax)</span></b>
```go
package main
@@ -306,7 +308,7 @@ func main() {
func HeapSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/u6Iwa1VZS_f)</span></b>
```go
package main
@@ -354,7 +356,7 @@ func main() {
func MergeSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ydinn9YzUJn)</span></b>
```go
package main
@@ -402,7 +404,7 @@ func main() {
func CountSort[T any](slice []T, comparator lancetconstraints.Comparator) []T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/tB-Umgm0DrP)</span></b>
```go
package main
@@ -451,7 +453,7 @@ func main() {
func BinarySearch[T any](sortedSlice []T, target T, lowIndex, highIndex int, comparator lancetconstraints.Comparator) int
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/t6MeGiUSN47)</span></b>
```go
package main
@@ -502,7 +504,7 @@ func main() {
func BinaryIterativeSearch[T any](sortedSlice []T, target T, lowIndex, highIndex int, comparator lancetconstraints.Comparator) int
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/Anozfr8ZLH3)</span></b>
```go
package main
@@ -553,7 +555,7 @@ func main() {
func LinearSearch[T any](slice []T, target T, equal func(a, b T) bool) int
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/IsS7rgn5s3x)</span></b>
```go
package main
@@ -596,7 +598,7 @@ func (l *LRUCache[K, V]) Delete(key K) bool
func (l *LRUCache[K, V]) Len() int
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/-EZjgOURufP)</span></b>
```go
package main

View File

@@ -35,7 +35,9 @@ import (
<div STYLE="page-break-after: always;"></div>
## Documentation
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="Equal">Equal</span>
@@ -47,7 +49,7 @@ import (
func Equal(left, right any) bool
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/wmVxR-to4lz)</span></b>
```go
package main
@@ -96,7 +98,7 @@ func main() {
func EqualValue(left, right any) bool
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/fxnna_LLD9u)</span></b>
```go
package main
@@ -135,7 +137,7 @@ func main() {
func LessThan(left, right any) bool
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/cYh7FQQj0ne)</span></b>
```go
package main
@@ -184,7 +186,7 @@ func main() {
func GreaterThan(left, right any) bool
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/9-NYDFZmIMp)</span></b>
```go
package main
@@ -236,7 +238,7 @@ func main() {
func LessOrEqual(left, right any) bool
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/e4T_scwoQzp)</span></b>
```go
package main
@@ -285,7 +287,7 @@ func main() {
func GreaterOrEqual(left, right any) bool
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/vx8mP0U8DFk)</span></b>
```go
package main
@@ -337,7 +339,7 @@ func main() {
func InDelta[T constraints.Integer | constraints.Float](left, right T, delta float64) bool
```
<b>示例:</b>
<b>示例: <span class="run-container">[运行](https://go.dev/play/p/TuDdcNtMkjo)</span></b>
```go
package main

View File

@@ -33,11 +33,15 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### Channel
### <span id="NewChannel">NewChannel</span>
<p>返回一个Channel指针实例</p>
<b>函数签名:</b>
@@ -46,7 +50,7 @@ import (
type Channel[T any] struct
func NewChannel[T any]() *Channel[T]
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/7aB4KyMMp9A)</span></b>
```go
package main
@@ -70,7 +74,7 @@ func main() {
```go
func (c *Channel[T]) Bridge(ctx context.Context, chanStream <-chan <-chan T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/qmWSy1NVF-Y)</span></b>
```go
package main
@@ -122,7 +126,7 @@ func main() {
```go
func (c *Channel[T]) FanIn(ctx context.Context, channels ...<-chan T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/2VYFMexEvTm)</span></b>
```go
package main
@@ -161,7 +165,7 @@ func main() {
```go
func (c *Channel[T]) Generate(ctx context.Context, values ...T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/7aB4KyMMp9A)</span></b>
```go
package main
@@ -199,7 +203,7 @@ func main() {
```go
func (c *Channel[T]) Repeat(ctx context.Context, values ...T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/k5N_ALVmYjE)</span></b>
```go
package main
@@ -238,7 +242,7 @@ func main() {
```go
func (c *Channel[T]) RepeatFn(ctx context.Context, fn func() T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/4J1zAWttP85)</span></b>
```go
package main
@@ -279,7 +283,7 @@ func main() {
```go
func (c *Channel[T]) Or(channels ...<-chan T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Wqz9rwioPww)</span></b>
```go
package main
@@ -322,7 +326,7 @@ func main() {
```go
func (c *Channel[T]) OrDone(ctx context.Context, channel <-chan T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/lm_GoS6aDjo)</span></b>
```go
package main
@@ -360,7 +364,7 @@ func main() {
```go
func (c *Channel[T]) Take(ctx context.Context, valueStream <-chan T, number int) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/9Utt-1pDr2J)</span></b>
```go
package main
@@ -406,7 +410,7 @@ func main() {
```go
func (c *Channel[T]) Tee(ctx context.Context, in <-chan T) (<-chan T, <-chan T)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/3TQPKnCirrP)</span></b>
```go
package main

View File

@@ -18,7 +18,7 @@ import (
<div STYLE="page-break-after: always;"></div>
## Index
## 目录
- [Bool](#Bool)
- [And](#And)
@@ -31,7 +31,9 @@ import (
<div STYLE="page-break-after: always;"></div>
## 目录
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="Bool">Bool</span>
<p>返回传入参数的bool值.<br/>
@@ -45,7 +47,7 @@ slices和map的length大于0时返回true否则返回false<br/>
```go
func Bool[T any](value T) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ETzeDJRSvhm)</span></b>
```go
package main
@@ -109,7 +111,7 @@ func main() {
```go
func And[T, U any](a T, b U) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/W1SSUmt6pvr)</span></b>
```go
package main
@@ -135,7 +137,7 @@ func main() {
```go
func Or[T, U any](a T, b U) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/UlQTxHaeEkq)</span></b>
```go
package main
@@ -161,7 +163,7 @@ func main() {
```go
func Xor[T, U any](a T, b U) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/gObZrW7ZbG8)</span></b>
```go
package main
@@ -187,7 +189,7 @@ func main() {
```go
func Nor[T, U any](a T, b U) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/g2j08F_zZky)</span></b>
```go
package main
@@ -213,7 +215,7 @@ func main() {
```go
func Xnor[T, U any](a T, b U) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/OuDB9g51643)</span></b>
```go
package main
@@ -239,7 +241,7 @@ func main() {
```go
func Nand[T, U any](a T, b U) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/vSRMLxLIbq8)</span></b>
```go
package main
@@ -265,7 +267,7 @@ func main() {
```go
func TernaryOperator[T, U any](isTrue T, ifValue U, elseValue U) U
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ElllPZY0guT)</span></b>
```go
package main

View File

@@ -46,6 +46,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="ColorHexToRGB">ColorHexToRGB</span>
@@ -58,7 +60,7 @@ import (
func ColorHexToRGB(colorHex string) (red, green, blue int)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/o7_ft-JCJBV)</span></b>
```go
package main
@@ -89,7 +91,7 @@ func main() {
func ColorRGBToHex(red, green, blue int) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/nzKS2Ro87J1)</span></b>
```go
package main
@@ -122,7 +124,7 @@ func main() {
func ToBool(s string) (bool, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ARht2WnGdIN)</span></b>
```go
package main
@@ -163,7 +165,7 @@ func main() {
func ToBytes(data any) ([]byte, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/fAMXYFDvOvr)</span></b>
```go
package main
@@ -196,7 +198,7 @@ func main() {
func ToChar(s string) []string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/JJ1SvbFkVdM)</span></b>
```go
package main
@@ -232,7 +234,7 @@ func main() {
func ToChannel[T any](array []T) <-chan T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/hOx_oYZbAnL)</span></b>
```go
package main
@@ -269,7 +271,7 @@ func main() {
func ToFloat(value any) (float64, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/4YTmPCibqHJ)</span></b>
```go
package main
@@ -314,7 +316,7 @@ func main() {
func ToInt(value any) (int64, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/9_h9vIt-QZ_b)</span></b>
```go
package main
@@ -356,7 +358,7 @@ func main() {
func ToJson(value any) (string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/2rLIkMmXWvR)</span></b>
```go
package main
@@ -391,7 +393,7 @@ func main() {
func ToMap[T any, K comparable, V any](array []T, iteratee func(T) (K, V)) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/tVFy7E-t24l)</span></b>
```go
package main
@@ -432,7 +434,7 @@ func main() {
func ToPointer[T any](value T) *T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ASf_etHNlw1)</span></b>
```go
package main
@@ -461,7 +463,7 @@ func main() {
func ToString(value any) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/nF1zOOslpQq)</span></b>
```go
package main
@@ -509,7 +511,7 @@ func main() {
func StructToMap(value any) (map[string]any, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/KYGYJqNUBOI)</span></b>
```go
package main
@@ -547,7 +549,7 @@ func main() {
func MapToSlice[T any, K comparable, V any](aMap map[K]V, iteratee func(K, V) T) []T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/dmX4Ix5V6Wl)</span></b>
```go
package main
@@ -577,7 +579,7 @@ func main() {
func EncodeByte(data any) ([]byte, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/DVmM1G5JfuP)</span></b>
```go
package main
@@ -606,7 +608,7 @@ func main() {
func DecodeByte(data []byte, target any) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/zI6xsmuQRbn)</span></b>
```go
package main
@@ -642,7 +644,7 @@ func main() {
func DeepClone[T any](src T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/j4DP5dquxnk)</span></b>
```go
package main
@@ -706,7 +708,7 @@ func main() {
func CopyProperties[T, U any](dst T, src U) (err error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/oZujoB5Sgg5)</span></b>
```go
package main
@@ -785,7 +787,7 @@ func main() {
func ToInterface(v reflect.Value) (value interface{}, ok bool)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/syqw0-WG7Xd)</span></b>
```go
package main
@@ -820,7 +822,7 @@ func main() {
func Utf8ToGbk(bs []byte) ([]byte, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/9FlIaFLArIL)</span></b>
```go
package main
@@ -854,7 +856,7 @@ func main() {
func GbkToUtf8(bs []byte) ([]byte, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/OphmHCN_9u8)</span></b>
```go
package main

View File

@@ -1,16 +1,18 @@
# Cryptor
cryptor加密包支持数据加密和解密获取md5hash值。支持base64, md5, hmac, aes, des, rsa。
cryptor包包含数据加密和解密功能。支持 base64, md5, hmac, hash, aes, des, rsa。
<div STYLE="page-break-after: always;"></div>
## 源码:
- [https://github.com/duke-git/lancet/blob/main/cryptor/basic.go](https://github.com/duke-git/lancet/blob/main/cryptor/basic.go)
- [https://github.com/duke-git/lancet/blob/main/cryptor/crypto.go](https://github.com/duke-git/lancet/blob/main/cryptor/crypto.go)
- [https://github.com/duke-git/lancet/blob/main/cryptor/basic.go](https://github.com/duke-git/lancet/blob/main/cryptor/basic.go)
- [https://github.com/duke-git/lancet/blob/main/cryptor/crypto.go](https://github.com/duke-git/lancet/blob/main/cryptor/crypto.go)
<div STYLE="page-break-after: always;"></div>
## 用法:
```go
import (
"github.com/duke-git/lancet/v2/cryptor"
@@ -20,56 +22,56 @@ import (
<div STYLE="page-break-after: always;"></div>
## 目录
- [AesEcbEncrypt](#AesEcbEncrypt)
- [AesEcbDecrypt](#AesEcbDecrypt)
- [AesCbcEncrypt](#AesCbcEncrypt)
- [AesCbcDecrypt](#AesCbcDecrypt)
- [AesCtrCrypt](#AesCtrCrypt)
- [AesCfbEncrypt](#AesCfbEncrypt)
- [AesCfbDecrypt](#AesCfbDecrypt)
- [AesOfbEncrypt](#AesOfbEncrypt)
- [AesOfbDecrypt](#AesOfbDecrypt)
- [Base64StdEncode](#Base64StdEncode)
- [Base64StdDecode](#Base64StdDecode)
- [DesEcbEncrypt](#DesEcbEncrypt)
- [DesEcbDecrypt](#DesEcbDecrypt)
- [DesCbcEncrypt](#DesCbcEncrypt)
- [DesCbcDecrypt](#DesCbcDecrypt)
- [DesCtrCrypt](#DesCtrCrypt)
- [DesCfbEncrypt](#DesCfbEncrypt)
- [DesCfbDecrypt](#DesCfbDecrypt)
- [DesOfbEncrypt](#DesOfbEncrypt)
- [DesOfbDecrypt](#DesOfbDecrypt)
- [HmacMd5](#HmacMd5)
- [HmacMd5WithBase64](#HmacMd5WithBase64)
- [HmacSha1](#HmacSha1)
- [HmacSha1WithBase64](#HmacSha1WithBase64)
- [HmacSha256](#HmacSha256)
- [HmacSha256WithBase64](#HmacSha256WithBase64)
- [HmacSha512](#HmacSha512)
- [HmacSha512WithBase64](#HmacSha512WithBase64)
- [Md5String](#Md5String)
- [Md5StringWithBase64](#Md5StringWithBase64)
- [Md5Byte](#Md5Byte)
- [Md5ByteWithBase64](#Md5ByteWithBase64)
- [Md5File](#Md5File)
- [Sha1](#Sha1)
- [Sha1WithBase64](#Sha1WithBase64)
- [Sha256](#Sha256)
- [Sha256WithBase64](#Sha256WithBase64)
- [Sha512](#Sha512)
- [Sha512WithBase64](#Sha512WithBase64)
- [GenerateRsaKey](#GenerateRsaKey)
- [RsaEncrypt](#RsaEncrypt)
- [RsaDecrypt](#RsaDecrypt)
- [AesEcbEncrypt](#AesEcbEncrypt)
- [AesEcbDecrypt](#AesEcbDecrypt)
- [AesCbcEncrypt](#AesCbcEncrypt)
- [AesCbcDecrypt](#AesCbcDecrypt)
- [AesCtrCrypt](#AesCtrCrypt)
- [AesCfbEncrypt](#AesCfbEncrypt)
- [AesCfbDecrypt](#AesCfbDecrypt)
- [AesOfbEncrypt](#AesOfbEncrypt)
- [AesOfbDecrypt](#AesOfbDecrypt)
- [Base64StdEncode](#Base64StdEncode)
- [Base64StdDecode](#Base64StdDecode)
- [DesEcbEncrypt](#DesEcbEncrypt)
- [DesEcbDecrypt](#DesEcbDecrypt)
- [DesCbcEncrypt](#DesCbcEncrypt)
- [DesCbcDecrypt](#DesCbcDecrypt)
- [DesCtrCrypt](#DesCtrCrypt)
- [DesCfbEncrypt](#DesCfbEncrypt)
- [DesCfbDecrypt](#DesCfbDecrypt)
- [DesOfbEncrypt](#DesOfbEncrypt)
- [DesOfbDecrypt](#DesOfbDecrypt)
- [HmacMd5](#HmacMd5)
- [HmacMd5WithBase64](#HmacMd5WithBase64)
- [HmacSha1](#HmacSha1)
- [HmacSha1WithBase64](#HmacSha1WithBase64)
- [HmacSha256](#HmacSha256)
- [HmacSha256WithBase64](#HmacSha256WithBase64)
- [HmacSha512](#HmacSha512)
- [HmacSha512WithBase64](#HmacSha512WithBase64)
- [Md5String](#Md5String)
- [Md5StringWithBase64](#Md5StringWithBase64)
- [Md5Byte](#Md5Byte)
- [Md5ByteWithBase64](#Md5ByteWithBase64)
- [Md5File](#Md5File)
- [Sha1](#Sha1)
- [Sha1WithBase64](#Sha1WithBase64)
- [Sha256](#Sha256)
- [Sha256WithBase64](#Sha256WithBase64)
- [Sha512](#Sha512)
- [Sha512WithBase64](#Sha512WithBase64)
- [GenerateRsaKey](#GenerateRsaKey)
- [RsaEncrypt](#RsaEncrypt)
- [RsaDecrypt](#RsaDecrypt)
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="AesEcbEncrypt">AesEcbEncrypt</span>
<p>使用AES ECB算法模式加密数据. 参数`key`的长度是16, 24 or 32。</p>
@@ -79,7 +81,8 @@ import (
```go
func AesEcbEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/zI6xsmuQRbn)</span></b>
```go
package main
@@ -112,7 +115,8 @@ func main() {
```go
func AesEcbDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/zI6xsmuQRbn)</span></b>
```go
package main
@@ -145,7 +149,8 @@ func main() {
```go
func AesCbcEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/IOq_g8_lKZD)</span></b>
```go
package main
@@ -179,7 +184,7 @@ func main() {
func AesCbcDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/IOq_g8_lKZD)</span></b>
```go
package main
@@ -213,7 +218,7 @@ func main() {
func AesCtrCrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/SpaZO0-5Nsp)</span></b>
```go
package main
@@ -247,7 +252,7 @@ func main() {
func AesCfbEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/tfkF10B13kH)</span></b>
```go
package main
@@ -281,7 +286,7 @@ func main() {
func AesCfbDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/tfkF10B13kH)</span></b>
```go
package main
@@ -315,7 +320,7 @@ func main() {
func AesOfbEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/VtHxtkUj-3F)</span></b>
```go
package main
@@ -338,6 +343,7 @@ func main() {
// hello
}
```
### <span id="AesCfbDecrypt">AesOfbDecrypt</span>
<p>使用AES OFB算法模式解密数据参数`key`的长度是16, 24 or 32。</p>
@@ -348,7 +354,7 @@ func main() {
func AesOfbDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/VtHxtkUj-3F)</span></b>
```go
package main
@@ -381,7 +387,8 @@ func main() {
```go
func Base64StdEncode(s string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/VOaUyQUreoK)</span></b>
```go
package main
@@ -399,6 +406,7 @@ func main() {
// aGVsbG8=
}
```
### <span id="Base64StdDecode">Base64StdDecode</span>
<p>解码base64字符串。</p>
@@ -409,7 +417,7 @@ func main() {
func Base64StdDecode(s string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/RWQylnJVgIe)</span></b>
```go
package main
@@ -438,7 +446,7 @@ func main() {
func DesEcbEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/8qivmPeZy4P)</span></b>
```go
package main
@@ -462,6 +470,7 @@ func main() {
// hello
}
```
### <span id="DesEcbDecrypt">DesEcbDecrypt</span>
<p>使用DES ECB算法模式解决密数据参数`key`的长度是8。</p>
@@ -472,7 +481,7 @@ func main() {
func DesEcbDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/8qivmPeZy4P)</span></b>
```go
package main
@@ -507,7 +516,7 @@ func main() {
func DesCbcEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/4cC4QvWfe3_1)</span></b>
```go
package main
@@ -541,7 +550,7 @@ func main() {
func DesCbcDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/4cC4QvWfe3_1)</span></b>
```go
package main
@@ -564,6 +573,7 @@ func main() {
// hello
}
```
### <span id="DesCtrCrypt">DesCtrCrypt</span>
<p>使用DES CTR算法模式加密/解密数据,参数`key`的长度是8</p>
@@ -574,7 +584,7 @@ func main() {
func DesCtrCrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/9-T6OjKpcdw)</span></b>
```go
package main
@@ -608,7 +618,7 @@ func main() {
func DesCfbEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/y-eNxcFBlxL)</span></b>
```go
package main
@@ -631,6 +641,7 @@ func main() {
// hello
}
```
### <span id="DesCfbDecrypt">DesCfbDecrypt</span>
<p>使用DES CFB算法模式解决密数据参数`key`的长度是8。</p>
@@ -641,7 +652,7 @@ func main() {
func DesCfbDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/y-eNxcFBlxL)</span></b>
```go
package main
@@ -664,6 +675,7 @@ func main() {
// hello
}
```
### <span id="DesOfbEncrypt">DesOfbEncrypt</span>
<p>使用DES OFB算法模式加密数据参数`key`的长度是8。</p>
@@ -674,7 +686,7 @@ func main() {
func DesOfbEncrypt(data, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/74KmNadjN1J)</span></b>
```go
package main
@@ -697,6 +709,7 @@ func main() {
// hello
}
```
### <span id="DesOfbDecrypt">DesOfbDecrypt</span>
<p>使用DES OFB算法模式解密数据参数`key`的长度是8。</p>
@@ -707,7 +720,7 @@ func main() {
func DesOfbDecrypt(encrypted, key []byte) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/74KmNadjN1J)</span></b>
```go
package main
@@ -741,7 +754,7 @@ func main() {
func HmacMd5(str, key string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/uef0q1fz53I)</span></b>
```go
package main
@@ -773,7 +786,7 @@ func main() {
func HmacMd5WithBase64(str, key string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/UY0ng2AefFC)</span></b>
```go
package main
@@ -794,6 +807,7 @@ func main() {
// 6DQwbquJLYclJdSRinpjmg==
}
```
### <span id="HmacSha1">HmacSha1</span>
<p>获取字符串的sha1 hmac值。</p>
@@ -804,7 +818,7 @@ func main() {
func HmacSha1(str, key string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/1UI4oQ4WXKM)</span></b>
```go
package main
@@ -836,7 +850,7 @@ func main() {
func HmacSha1WithBase64(str, key string) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/47JmmGrnF7B)</span></b>
```go
package main
@@ -858,7 +872,6 @@ func main() {
}
```
### <span id="HmacSha256">HmacSha256</span>
<p>获取字符串sha256 hmac值。</p>
@@ -869,7 +882,7 @@ func main() {
func HmacSha256(str, key string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/HhpwXxFhhC0)</span></b>
```go
package main
@@ -901,7 +914,7 @@ func main() {
func HmacSha256WithBase64(str, key string) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/EKbkUvPTLwO)</span></b>
```go
package main
@@ -933,7 +946,7 @@ func main() {
func HmacSha512(str, key string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/59Od6m4A0Ud)</span></b>
```go
package main
@@ -965,7 +978,7 @@ func main() {
func HmacSha512WithBase64(str, key string) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/c6dSe3E2ydU)</span></b>
```go
package main
@@ -987,7 +1000,6 @@ func main() {
}
```
### <span id="Md5String">Md5String</span>
<p>获取字符串md5值。</p>
@@ -998,7 +1010,7 @@ func main() {
func Md5String(str string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/1bLcVetbTOI)</span></b>
```go
package main
@@ -1029,7 +1041,7 @@ func main() {
func Md5StringWithBase64(s string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Tcb-Z7LN2ax)</span></b>
```go
package main
@@ -1058,7 +1070,7 @@ func main() {
func Md5Byte(data []byte) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/suraalH8lyC)</span></b>
```go
package main
@@ -1087,7 +1099,7 @@ func main() {
func Md5ByteWithBase64(data []byte) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/Lx4gH7Vdr5_y)</span></b>
```go
package main
@@ -1142,7 +1154,7 @@ func main() {
func Sha1(str string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/_m_uoD1deMT)</span></b>
```go
package main
@@ -1173,7 +1185,7 @@ func main() {
func Sha1WithBase64(str string) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/fSyx-Gl2l2-)</span></b>
```go
package main
@@ -1202,7 +1214,7 @@ func main() {
func Sha256(str string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/tU9tfBMIAr1)</span></b>
```go
package main
@@ -1233,7 +1245,7 @@ func main() {
func Sha256WithBase64(str string) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/85IXJHIal1k)</span></b>
```go
package main
@@ -1262,7 +1274,7 @@ func main() {
func Sha512(str string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/3WsvLYZxsHa)</span></b>
```go
package main
@@ -1293,7 +1305,7 @@ func main() {
func Sha512WithBase64(str string) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/q_fY2rA-k5I)</span></b>
```go
package main
@@ -1322,7 +1334,7 @@ func main() {
func GenerateRsaKey(keySize int, priKeyFile, pubKeyFile string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/zutRHrDqs0X)</span></b>
```go
package main
@@ -1350,7 +1362,7 @@ func main() {
func RsaEncrypt(data []byte, pubKeyFileName string) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/uef0q1fz53I)</span></b>
```go
package main
@@ -1365,11 +1377,11 @@ func main() {
if err != nil {
return
}
data := []byte("hello")
encrypted := cryptor.RsaEncrypt(data, "rsa_public.pem")
decrypted := cryptor.RsaDecrypt(encrypted, "rsa_private.pem")
fmt.Println(string(decrypted))
// Output:
@@ -1377,7 +1389,6 @@ func main() {
}
```
### <span id="RsaDecrypt">RsaDecrypt</span>
<p>用私钥文件rsa解密数据。</p>
@@ -1388,7 +1399,7 @@ func main() {
func RsaDecrypt(data []byte, privateKeyFileName string) []byte
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/uef0q1fz53I)</span></b>
```go
package main
@@ -1403,14 +1414,14 @@ func main() {
if err != nil {
return
}
data := []byte("hello")
encrypted := cryptor.RsaEncrypt(data, "rsa_public.pem")
decrypted := cryptor.RsaDecrypt(encrypted, "rsa_private.pem")
fmt.Println(string(decrypted))
// Output:
// hello
}
```
```

View File

@@ -67,6 +67,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
## 注:
@@ -106,7 +108,7 @@ import (
func AddDay(t time.Time, day int64) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/dIGbs_uTdFa)</span></b>
```go
package main
@@ -145,7 +147,7 @@ func main() {
func AddHour(t time.Time, hour int64) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/rcMjd7OCsi5)</span></b>
```go
package main
@@ -184,7 +186,7 @@ func main() {
func AddMinute(t time.Time, minute int64) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/nT1heB1KUUK)</span></b>
```go
package main
@@ -223,7 +225,7 @@ func main() {
func AddYear(t time.Time, year int64) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/MqW2ujnBx10)</span></b>
```go
package main
@@ -262,7 +264,7 @@ func main() {
func BeginOfMinute(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ieOLVJ9CiFT)</span></b>
```go
package main
@@ -294,7 +296,7 @@ func main() {
func BeginOfHour(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/GhdGFnDWpYs)</span></b>
```go
package main
@@ -326,7 +328,7 @@ func main() {
func BeginOfDay(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/94m_UT6cWs9)</span></b>
```go
package main
@@ -358,7 +360,7 @@ func main() {
func BeginOfWeek(t time.Time, beginFrom ...time.Weekday) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ynjoJPz7VNV)</span></b>
```go
package main
@@ -390,7 +392,7 @@ func main() {
func BeginOfMonth(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/bWXVFsmmzwL)</span></b>
```go
package main
@@ -422,7 +424,7 @@ func main() {
func BeginOfYear(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/i326DSwLnV8)</span></b>
```go
package main
@@ -454,7 +456,7 @@ func main() {
func EndOfMinute(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/yrL5wGzPj4z)</span></b>
```go
package main
@@ -486,7 +488,7 @@ func main() {
func EndOfHour(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/6ce3j_6cVqN)</span></b>
```go
package main
@@ -518,7 +520,7 @@ func main() {
func EndOfDay(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/eMBOvmq5Ih1)</span></b>
```go
package main
@@ -550,7 +552,7 @@ func main() {
func EndOfWeek(t time.Time, endWith ...time.Weekday) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/i08qKXD9flf)</span></b>
```go
package main
@@ -582,7 +584,7 @@ func main() {
func EndOfMonth(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/_GWh10B3Nqi)</span></b>
```go
package main
@@ -614,7 +616,7 @@ func main() {
func EndOfYear(t time.Time) time.Time
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/G01cKlMCvNm)</span></b>
```go
package main
@@ -646,7 +648,7 @@ func main() {
func GetNowDate() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/PvfkPpcpBBf)</span></b>
```go
package main
@@ -675,7 +677,7 @@ func main() {
func GetNowTime() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/l7BNxCkTmJS)</span></b>
```go
package main
@@ -704,7 +706,7 @@ func main() {
func GetNowDateTime() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/pI4AqngD0al)</span></b>
```go
package main
@@ -733,7 +735,7 @@ func main() {
func GetTodayStartTime() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/84siyYF7t99)</span></b>
```go
package main
@@ -762,7 +764,7 @@ func main() {
func GetTodayEndTime() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/jjrLnfoqgn3)</span></b>
```go
package main
@@ -791,7 +793,7 @@ func main() {
func GetZeroHourTimestamp() int64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/QmL2oIaGE3q)</span></b>
```go
package main
@@ -820,7 +822,7 @@ func main() {
func GetNightTimestamp() int64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/UolysR3MYP1)</span></b>
```go
package main
@@ -849,7 +851,7 @@ func main() {
func FormatTimeToStr(t time.Time, format string, timezone ...string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/_Ia7M8H_OvE)</span></b>
```go
package main
@@ -888,7 +890,7 @@ func main() {
func FormatStrToTime(str, format string, timezone ...string) (time.Time, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/1h9FwdU8ql4)</span></b>
```go
package main
@@ -927,7 +929,7 @@ type theTime struct {
func NewUnixNow() *theTime
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/U4PPx-9D0oz)</span></b>
```go
package main
@@ -959,7 +961,7 @@ type theTime struct {
func NewUnix(unix int64) *theTime
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/psoSuh_kLRt)</span></b>
```go
package main
@@ -991,7 +993,7 @@ type theTime struct {
func NewFormat(t string) (*theTime, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/VkW08ZOaXPZ)</span></b>
```go
package main
@@ -1023,7 +1025,7 @@ type theTime struct {
func NewISO8601(iso8601 string) (*theTime, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/mkhOHQkdeA2)</span></b>
```go
package main
@@ -1052,7 +1054,7 @@ func main() {
func (t *theTime) ToUnix() int64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/_LUiwAdocjy)</span></b>
```go
package main
@@ -1081,7 +1083,7 @@ func main() {
func (t *theTime) ToFormat() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/VkW08ZOaXPZ)</span></b>
```go
package main
@@ -1110,7 +1112,7 @@ func main() {
func (t *theTime) ToFormatForTpl(tpl string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/nyXxXcQJ8L5)</span></b>
```go
package main
@@ -1140,7 +1142,7 @@ func main() {
func (t *theTime) ToIso8601() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/mkhOHQkdeA2)</span></b>
```go
package main
@@ -1170,7 +1172,7 @@ func main() {
func IsLeapYear(year int) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/xS1eS2ejGew)</span></b>
```go
package main
@@ -1203,7 +1205,7 @@ func main() {
func BetweenSeconds(t1 time.Time, t2 time.Time) int64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/n3YDRyfyXJu)</span></b>
```go
package main
@@ -1240,7 +1242,7 @@ func main() {
func DayOfYear(t time.Time) int
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/0hjqhTwFNlH)</span></b>
```go
package main
@@ -1281,7 +1283,7 @@ func main() {
func IsWeekend(t time.Time) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/cupRM5aZOIY)</span></b>
```go
package main
@@ -1321,7 +1323,7 @@ func main() {
func NowDateOrTime(format string, timezone ...string) string
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/EZ-begEjtT0)</span></b>
```go
package main
@@ -1355,7 +1357,7 @@ func main() {
func Timestamp(timezone ...string) int64
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/iU5b7Vvjx6x)</span></b>
```go
package main
@@ -1386,7 +1388,7 @@ func main() {
func TimestampMilli(timezone ...string) int64
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/4gvEusOTu1T)</span></b>
```go
package main
@@ -1416,7 +1418,7 @@ func main() {
func TimestampMicro(timezone ...string) int64
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/2maANglKHQE)</span></b>
```go
package main
@@ -1446,7 +1448,7 @@ func main() {
func TimestampNano(timezone ...string) int64
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/A9Oq_COrcCF)</span></b>
```go
package main

View File

@@ -50,6 +50,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="ClearFile">ClearFile</span>
@@ -62,7 +64,7 @@ import (
func ClearFile(path string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/NRZ0ZT-G94H)</span></b>
```go
package main
@@ -90,7 +92,7 @@ func main() {
func CreateFile(path string) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/lDt8PEsTNKI)</span></b>
```go
package main
@@ -116,7 +118,7 @@ func main() {
func CreateDir(absPath string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/qUuCe1OGQnM)</span></b>
```go
package main
@@ -142,7 +144,7 @@ func main() {
func CopyFile(srcPath string, dstPath string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Jg9AMJMLrJi)</span></b>
```go
package main
@@ -170,7 +172,7 @@ func main() {
func CurrentPath() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/s74a9iBGcSw)</span></b>
```go
package main
@@ -196,7 +198,7 @@ func main() {
func FileMode(path string) (fs.FileMode, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/2l2hI42fA3p)</span></b>
```go
package main
@@ -225,7 +227,7 @@ func main() {
func MiMeType(file any) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/bd5sevSUZNu)</span></b>
```go
package main
@@ -256,7 +258,7 @@ func main() {
func IsExist(path string) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/nKKXt8ZQbmh)</span></b>
```go
package main
@@ -283,7 +285,7 @@ func main() {
func IsLink(path string) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/TL-b-Kzvf44)</span></b>
```go
package main
@@ -309,7 +311,7 @@ func main() {
func IsDir(path string) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/WkVwEKqtOWk)</span></b>
```go
package main
@@ -338,7 +340,7 @@ func main() {
func ListFileNames(path string) ([]string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Tjd7Y07rejl)</span></b>
```go
package main
@@ -364,7 +366,7 @@ func main() {
func RemoveFile(path string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/P2y0XW8a1SH)</span></b>
```go
package main
@@ -392,7 +394,7 @@ func main() {
func ReadFileToString(path string) (string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/cmfwp_5SQTp)</span></b>
```go
package main
@@ -425,7 +427,7 @@ func main() {
func ReadFileByLine(path string)([]string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/svJP_7ZrBrD)</span></b>
```go
package main
@@ -459,7 +461,7 @@ func main() {
func Zip(fpath string, destPath string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/j-3sWBp8ik_P)</span></b>
```go
package main
@@ -487,7 +489,7 @@ func main() {
func ZipAppendEntry(fpath string, destPath string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/cxvaT8TRNQp)</span></b>
```go
package main
@@ -515,7 +517,7 @@ func main() {
func UnZip(zipFile string, destPath string) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/g0w34kS7B8m)</span></b>
```go
package main
@@ -543,7 +545,7 @@ func main() {
func IsZipFile(filepath string) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/9M0g2j_uF_e)</span></b>
```go
package main
@@ -569,7 +571,7 @@ func main() {
func FileSize(path string) (int64, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/H9Z05uD-Jjc)</span></b>
```go
package main
@@ -601,7 +603,7 @@ func main() {
func MTime(filepath string) (int64, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/s_Tl7lZoAaY)</span></b>
```go
package main
@@ -633,7 +635,7 @@ func main() {
func Sha(filepath string, shaType ...int) (string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/VfEEcO2MJYf)</span></b>
```go
package main
@@ -671,7 +673,7 @@ func main() {
func ReadCsvFile(filepath string) ([][]string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/OExTkhGEd3_u)</span></b>
```go
package main
@@ -703,7 +705,7 @@ func main() {
func WriteCsvFile(filepath string, records [][]string, append bool) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/dAXm58Q5U1o)</span></b>
```go
package main
@@ -752,7 +754,7 @@ func main() {
func WriteBytesToFile(filepath string, content []byte) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/s7QlDxMj3P8)</span></b>
```go
package main
@@ -801,7 +803,7 @@ func main() {
func WriteStringToFile(filepath string, content string, append bool) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/GhLS6d8lH_g)</span></b>
```go
package main

View File

@@ -33,6 +33,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="Comma">Comma</span>
@@ -45,7 +47,7 @@ import (
func Comma[T constraints.Float | constraints.Integer | string](value T, symbol string) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/eRD5k2vzUVX)</span></b>
```go
package main
@@ -81,7 +83,7 @@ func main() {
func Pretty(v any) (string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/YsciGj3FH2x)</span></b>
```go
package main
@@ -120,7 +122,7 @@ func main() {
func PrettyToWriter(v any, out io.Writer) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/LPLZ3lDi5ma)</span></b>
```go
package main
@@ -163,7 +165,7 @@ func main() {
func DecimalBytes(size float64, precision ...int) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/FPXs1suwRcs)</span></b>
```go
package main
@@ -202,7 +204,7 @@ func main() {
func BinaryBytes(size float64, precision ...int) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/G9oHHMCAZxP)</span></b>
```go
package main
@@ -241,7 +243,7 @@ func main() {
func ParseDecimalBytes(size string) (uint64, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Am98ybWjvjj)</span></b>
```go
package main
@@ -280,7 +282,7 @@ func main() {
func ParseBinaryBytes(size string) (uint64, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/69v1tTT62x8)</span></b>
```go
package main

View File

@@ -37,6 +37,8 @@ import (
## 文档
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
### <span id="After">After</span>
<p>创建一个函数当他被调用n或更多次之后将马上触发fn</p>
@@ -47,7 +49,7 @@ import (
func After(n int, fn any) func(args ...any) []reflect.Value
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/eRD5k2vzUVX)</span></b>
```go
package main
@@ -80,7 +82,7 @@ func main() {
func Before(n int, fn any) func(args ...any) []reflect.Value
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/0HqUDIFZ3IL)</span></b>
```go
package main
@@ -88,7 +90,6 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/function"
"github.com/duke-git/lancet/v2/internal"
)
func main() {
@@ -118,7 +119,7 @@ type CurryFn[T any] func(...T) T
func (cf CurryFn[T]) New(val T) func(...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/5HopfDwANKX)</span></b>
```go
package main
@@ -157,7 +158,7 @@ func main() {
func Compose[T any](fnList ...func(...T) T) func(...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/KKfugD4PKYF)</span></b>
```go
package main
@@ -195,7 +196,7 @@ func main() {
func Debounced(fn func(), duration time.Duration) func()
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/absuEGB_GN7)</span></b>
```go
package main
@@ -245,7 +246,7 @@ func main() {
func Delay(delay time.Duration, fn any, args ...any)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Ivtc2ZE-Tye)</span></b>
```go
package main
@@ -277,7 +278,7 @@ func main() {
func Schedule(d time.Duration, fn any, args ...any) chan bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/hbON-Xeyn5N)</span></b>
```go
package main
@@ -316,7 +317,7 @@ func main() {
func Pipeline[T any](funcs ...func(T) T) func(T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/mPdUVvj6HD6)</span></b>
```go
package main
@@ -361,13 +362,14 @@ type Watcher struct {
excuting bool
}
func NewWatcher() *Watcher
func (w *Watcher) Start() //start the watcher
func (w *Watcher) Stop() //stop the watcher
func (w *Watcher) Reset() //reset the watcher
func (w *Watcher) GetElapsedTime() time.Duration //get the elapsed time of function execution
func (w *Watcher) Start()
func (w *Watcher) Stop()
func (w *Watcher) Reset()
func (w *Watcher) GetElapsedTime() time.Duration
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/l2yrOpCLd1I)</span></b>
```go
package main

View File

@@ -53,9 +53,10 @@ import (
- [ConcurrentMap_Has](#ConcurrentMap_Has)
- [ConcurrentMap_Range](#ConcurrentMap_Range)
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## API 文档:
### <span id="MapTo">MapTo</span>
@@ -68,7 +69,7 @@ import (
func MapTo(src any, dst any) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/4K7KBEPgS5M)</span></b>
```go
package main
@@ -125,7 +126,7 @@ func main() {
func ForEach[K comparable, V any](m map[K]V, iteratee func(key K, value V))
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/OaThj6iNVXK)</span></b>
```go
package main
@@ -166,7 +167,7 @@ func main() {
func Filter[K comparable, V any](m map[K]V, predicate func(key K, value V) bool) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/fSvF3wxuNG7)</span></b>
```go
package main
@@ -211,7 +212,7 @@ func main() {
func FilterByKeys[K comparable, V any](m map[K]V, keys []K) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/7ov6BJHbVqh)</span></b>
```go
package main
@@ -249,7 +250,7 @@ func main() {
func FilterByValues[K comparable, V comparable](m map[K]V, values []V) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/P3-9MdcXegR)</span></b>
```go
package main
@@ -287,7 +288,7 @@ func main() {
func OmitBy[K comparable, V any](m map[K]V, predicate func(key K, value V) bool) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/YJM4Hj5hNwm)</span></b>
```go
package main
@@ -328,7 +329,7 @@ func main() {
func OmitByKeys[K comparable, V any](m map[K]V, keys []K) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/jXGrWDBfSRp)</span></b>
```go
package main
@@ -366,7 +367,7 @@ func main() {
func OmitByValues[K comparable, V comparable](m map[K]V, values []V) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/XB7Y10uw20_U)</span></b>
```go
package main
@@ -404,7 +405,7 @@ func main() {
func Intersect[K comparable, V any](maps ...map[K]V) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Zld0oj3sjcC)</span></b>
```go
package main
@@ -459,7 +460,7 @@ func main() {
func Keys[K comparable, V any](m map[K]V) []K
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/xNB5bTb97Wd)</span></b>
```go
package main
@@ -498,7 +499,7 @@ func main() {
func Merge[K comparable, V any](maps ...map[K]V) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/H95LENF1uB-)</span></b>
```go
package main
@@ -537,7 +538,7 @@ func main() {
func Minus[K comparable, V any](mapA, mapB map[K]V) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/3u5U9K7YZ9m)</span></b>
```go
package main
@@ -579,7 +580,7 @@ func main() {
func Values[K comparable, V any](m map[K]V) []V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/CBKdUc5FTW6)</span></b>
```go
package main
@@ -616,7 +617,7 @@ func main() {
func KeysBy[K comparable, V any, T any](m map[K]V, mapper func(item K) T) []T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/hI371iB8Up8)</span></b>
```go
package main
@@ -657,7 +658,7 @@ func main() {
func ValuesBy[K comparable, V any, T any](m map[K]V, mapper func(item V) T) []T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/sg9-oRidh8f)</span></b>
```go
package main
@@ -706,7 +707,7 @@ func main() {
func MapKeys[K comparable, V any, T comparable](m map[K]V, iteratee func(key K, value V) T) map[T]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/8scDxWeBDKd)</span></b>
```go
package main
@@ -745,7 +746,7 @@ func main() {
func MapValues[K comparable, V any, T any](m map[K]V, iteratee func(key K, value V) T) map[K]T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/g92aY3fc7Iw)</span></b>
```go
package main
@@ -788,7 +789,7 @@ type Entry[K comparable, V any] struct {
func Entries[K comparable, V any](m map[K]V) []Entry[K, V]
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Ltb11LNcElY)</span></b>
```go
package main
@@ -833,7 +834,7 @@ type Entry[K comparable, V any] struct {
func FromEntries[K comparable, V any](entries []Entry[K, V]) map[K]V
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/C8L4ul9TVwf)</span></b>
```go
package main
@@ -867,7 +868,7 @@ func main() {
func Transform[K1 comparable, V1 any, K2 comparable, V2 any](m map[K1]V1, iteratee func(key K1, value V1) (K2, V2)) map[K2]V2
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/P6ovfToM3zj)</span></b>
```go
package main
@@ -906,7 +907,7 @@ func main() {
func IsDisjoint[K comparable, V any](mapA, mapB map[K]V) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/N9qgYg_Ho6f)</span></b>
```go
package main
@@ -961,7 +962,7 @@ if haskey {
func HasKey[K comparable, V any](m map[K]V, key K) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/isZZHOsDhFc)</span></b>
```go
package main
@@ -1000,7 +1001,7 @@ func main() {
func NewConcurrentMap[K comparable, V any](shardCount int) *ConcurrentMap[K, V]
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/3PenTPETJT0)</span></b>
```go
package main
@@ -1026,7 +1027,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Set(key K, value V)
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/3PenTPETJT0)</span></b>
```go
package main
@@ -1080,7 +1081,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Get(key K) (V, bool)
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/3PenTPETJT0)</span></b>
```go
package main
@@ -1134,7 +1135,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) GetOrSet(key K, value V) (actual V, ok bool)
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/aDcDApOK01a)</span></b>
```go
package main
@@ -1178,7 +1179,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Delete(key K)
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/uTIJZYhpVMS)</span></b>
```go
package main
@@ -1214,7 +1215,6 @@ func main() {
}
```
### <span id="ConcurrentMap_GetAndDelete">ConcurrentMap_GetAndDelete</span>
<p>获取key然后删除。</p>
@@ -1225,7 +1225,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) GetAndDelete(key K) (actual V, ok bool)
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/ZyxeIXSZUiM)</span></b>
```go
package main
@@ -1266,7 +1266,6 @@ func main() {
}
```
### <span id="ConcurrentMap_Has">ConcurrentMap_Has</span>
<p>验证是否包含key。</p>
@@ -1277,7 +1276,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Has(key K) bool
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/C8L4ul9TVwf)</span></b>
```go
package main
@@ -1315,7 +1314,6 @@ func main() {
}
```
### <span id="ConcurrentMap_Range">ConcurrentMap_Range</span>
<p>为map中每个键和值顺序调用迭代器。 如果iterator返回false则停止迭代。</p>
@@ -1326,7 +1324,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Range(iterator func(key K, value V) bool)
```
<b>例:</b>
<b>例:<span class="run-container">[运行](https://go.dev/play/p/iqcy7P8P0Pr)</span></b>
```go
package main
@@ -1357,4 +1355,3 @@ func main() {
})
}
```

View File

@@ -50,7 +50,9 @@ import (
<div STYLE="page-break-after: always;"></div>
## Documentation
<link rel="stylesheet" type="text/css" href="../../styles/api_doc.css">
## 文档
### <span id="Average">Average</span>
@@ -62,7 +64,7 @@ import (
func Average[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/HFd70x4DrMj)</span></b>
```go
package main
@@ -97,7 +99,7 @@ func main() {
func Exponent(x, n int64) int64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Vv7LBwER-pz)</span></b>
```go
package main
@@ -133,7 +135,7 @@ func main() {
func Fibonacci(first, second, n int) int
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/IscseUNMuUc)</span></b>
```go
package main
@@ -169,7 +171,7 @@ func main() {
func Factorial(x uint) uint
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/tt6LdOK67Nx)</span></b>
```go
package main
@@ -205,7 +207,7 @@ func main() {
func Max[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/cN8DHI0rTkH)</span></b>
```go
package main
@@ -238,7 +240,7 @@ func main() {
func MaxBy[T any](slice []T, comparator func(T, T) bool) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/pbe2MT-7DV2)</span></b>
```go
package main
@@ -282,7 +284,7 @@ func main() {
func Min[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/pbe2MT-7DV2)</span></b>
```go
package main
@@ -315,7 +317,7 @@ func main() {
func MinBy[T any](slice []T, comparator func(T, T) bool) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/N9qgYg_Ho6f)</span></b>
```go
package main
@@ -359,7 +361,7 @@ func main() {
func Percent(val, total float64, n int) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/s0NdFCtwuyd)</span></b>
```go
package main
@@ -395,7 +397,7 @@ func main() {
func RoundToFloat(x float64, n int) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ghyb528JRJL)</span></b>
```go
package main
@@ -431,7 +433,7 @@ func main() {
func RoundToString(x float64, n int) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/kZwpBRAcllO)</span></b>
```go
package main
@@ -467,7 +469,7 @@ func main() {
func TruncRound(x float64, n int) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/aumarSHIGzP)</span></b>
```go
package main
@@ -503,7 +505,7 @@ func main() {
func Range[T constraints.Integer | constraints.Float](start T, count int) []T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/9ke2opxa8ZP)</span></b>
```go
package main
@@ -542,7 +544,7 @@ func main() {
func RangeWithStep[T constraints.Integer | constraints.Float](start, end, step T) []T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/akLWz0EqOSM)</span></b>
```go
package main
@@ -581,7 +583,7 @@ func main() {
func AngleToRadian(angle float64) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/CIvlICqrHql)</span></b>
```go
package main
@@ -617,7 +619,7 @@ func main() {
func RadianToAngle(radian float64) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/dQtmOTUOMgi)</span></b>
```go
package main
@@ -653,7 +655,7 @@ func main() {
func PointDistance(x1, y1, x2, y2 float64) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/RrG4JIaziM8)</span></b>
```go
package main
@@ -683,7 +685,7 @@ func main() {
func IsPrime(n int) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Rdd8UTHZJ7u)</span></b>
```go
package main
@@ -722,7 +724,7 @@ func main() {
func GCD[T constraints.Integer](integers ...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/CiEceLSoAKB)</span></b>
```go
package main
@@ -764,7 +766,7 @@ func main() {
func LCM[T constraints.Integer](integers ...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/EjcZxfY7G_g)</span></b>
```go
package main
@@ -800,7 +802,7 @@ func main() {
func Cos(radian float64, precision ...int) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Sm89LoIfvFq)</span></b>
```go
package main
@@ -842,7 +844,7 @@ func main() {
func Sin(radian float64, precision ...int) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/TWMQlMywDsP)</span></b>
```go
package main
@@ -884,7 +886,7 @@ func main() {
func Log(n, base float64) float64
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/_d4bi8oyhat)</span></b>
```go
package main
@@ -920,7 +922,7 @@ func main() {
func Sum[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/1To2ImAMJA7)</span></b>
```go
package main
@@ -953,7 +955,7 @@ func main() {
func Abs[T constraints.Integer | constraints.Float](x T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/fsyBh1Os-1d)</span></b>
```go
package main

View File

@@ -51,6 +51,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="ConvertMapToQueryString">ConvertMapToQueryString</span>
@@ -63,7 +65,7 @@ import (
func ConvertMapToQueryString(param map[string]any) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/jnNt_qoSnRi)</span></b>
```go
package main
@@ -98,7 +100,7 @@ func main() {
func EncodeUrl(urlStr string) (string, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/bsZ6BRC4uKI)</span></b>
```go
package main
@@ -133,7 +135,7 @@ func main() {
func GetInternalIp() string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/fxnna_LLD9u)</span></b>
```go
package main
@@ -165,7 +167,7 @@ func main() {
func GetIps() []string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/NUFfcEmukx1)</span></b>
```go
package main
@@ -195,7 +197,7 @@ func main() {
func GetMacAddrs() []string {
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/Rq9UUBS_Xp1)</span></b>
```go
package main
@@ -239,7 +241,7 @@ type PublicIpInfo struct {
}
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/YDxIfozsRHR)</span></b>
```go
package main
@@ -269,7 +271,7 @@ func main() {
func GetRequestPublicIp(req *http.Request) string
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/kxU-YDc_eBo)</span></b>
```go
package main
@@ -307,7 +309,7 @@ func main() {
func IsPublicIP(IP net.IP) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/nmktSQpJZnn)</span></b>
```go
package main
@@ -344,7 +346,7 @@ func main() {
func IsInternalIP(IP net.IP) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/sYGhXbgO4Cb)</span></b>
```go
package main
@@ -388,7 +390,7 @@ type HttpRequest struct {
}
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -445,7 +447,7 @@ func NewHttpClientWithConfig(config *HttpClientConfig) *HttpClient
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -476,7 +478,7 @@ func main() {
func (client *HttpClient) SendRequest(request *HttpRequest) (*http.Response, error)
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -530,7 +532,7 @@ func main() {
func (client *HttpClient) DecodeResponse(resp *http.Response, target any) error
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -584,7 +586,7 @@ func main() {
func StructToUrlValues(targetStruct any) url.Values
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/pFqMkM40w9z)</span></b>
```go
package main
@@ -966,7 +968,7 @@ func main() {
func IsPingConnected(host string) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/q8OzTijsA87)</span></b>
```go
package main
@@ -999,7 +1001,7 @@ func main() {
func IsTelnetConnected(host string, port string) bool
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/yiLCGtQv_ZG)</span></b>
```go
package main

View File

@@ -30,6 +30,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## 文档
### <span id="Of">Of</span>
@@ -42,7 +44,7 @@ import (
func Of[T any](v T) *T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/HFd70x4DrMj)</span></b>
```go
package main
@@ -75,7 +77,7 @@ func main() {
func Unwrap[T any](p *T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/cgeu3g7cjWb)</span></b>
```go
package main
@@ -111,7 +113,7 @@ func main() {
func ExtractPointer(value any) any
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/D7HFjeWU2ZP)</span></b>
```go
package main
@@ -146,7 +148,7 @@ func main() {
UnwarpOr[T any](p *T, fallback T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/mmNaLC38W8C)</span></b>
```go
package main
@@ -191,7 +193,7 @@ func main() {
UnwarpOrDefault[T any](p *T) T
```
<b>示例:</b>
<b>示例:<span class="run-container">[运行](https://go.dev/play/p/ZnGIHf8_o4E)</span></b>
```go
package main

70
docs/en/api/overview.md Normal file
View File

@@ -0,0 +1,70 @@
---
outline: deep
---
# API Overview
<b>Lancet (Lancet) is a powerful, comprehensive, efficient and reusable go language tool function library. Contains 25 packages, more than 600 utility functions. Functions cover string processing, slice processing, network, concurrency, encryption and decryption, file processing, time/date, stream processing, iterators, and more.</b>
<style>
.package-title {
color: black;
font-size: 18px;
text-align: center;
font-weight: bold;
}
.package-container {
font-size: 16px;
border: 1px dashed;
padding: 10px;
text-align: center;
}
.package-cell {
height: 40px;
width: 140px;
display: inline-block;
vertical-align: middle;
line-height: 40px;
background: #ecefff;
border: 1px solid;
margin-right: 10px;
margin-bottom: 10px;
border-radius: 6px;
font-weight: bold;
}
</style>
<div>
<p class="package-title">lancet function module</p>
<div class="package-container">
<div class="package-cell">algorithm</div>
<div class="package-cell">compare</div>
<div class="package-cell">concurrency</div>
<div class="package-cell">condition</div>
<div class="package-cell">convertor</div>
<div class="package-cell">cryptor</div>
<div class="package-cell">datastructure</div>
<div class="package-cell">datetime</div>
<div class="package-cell">fileutil</div>
<div class="package-cell">formatter</div>
<div class="package-cell">function</div>
<div class="package-cell">iterator</div>
<div class="package-cell">maputil</div>
<div class="package-cell">mathutil</div>
<div class="package-cell">netutil</div>
<div class="package-cell">pointer</div>
<div class="package-cell">random</div>
<div class="package-cell">retry</div>
<div class="package-cell">slice</div>
<div class="package-cell">stream</div>
<div class="package-cell">structs</div>
<div class="package-cell">strutil</div>
<div class="package-cell">system</div>
<div class="package-cell">tuple</div>
<div class="package-cell">validator</div>
<div class="package-cell">xerror</div>
</div>
</div>

View File

@@ -12,6 +12,8 @@ Package algorithm implements some basic algorithm. eg. sort, search.
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Usage
```go
@@ -51,7 +53,7 @@ import (
func BubbleSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/GNdv7Jg2Taj)</span></b>
```go
package main
@@ -99,7 +101,7 @@ func main() {
func InsertionSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/G5LJiWgJJW6)</span></b>
```go
package main
@@ -162,7 +164,7 @@ func main() {
func SelectionSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/oXovbkekayS)</span></b>
```go
package main
@@ -210,7 +212,7 @@ func main() {
func ShellSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/3ibkszpJEu3)</span></b>
```go
package main
@@ -258,7 +260,7 @@ func main() {
func QuickSort[T any](slice []T comparator lancetconstraints.Comparator)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/7Y7c1Elk3ax)</span></b>
```go
package main
@@ -306,7 +308,7 @@ func main() {
func HeapSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/u6Iwa1VZS_f)</span></b>
```go
package main
@@ -354,7 +356,7 @@ func main() {
func MergeSort[T any](slice []T, comparator lancetconstraints.Comparator)
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/ydinn9YzUJn)</span></b>
```go
package main
@@ -402,7 +404,7 @@ func main() {
func CountSort[T any](slice []T, comparator lancetconstraints.Comparator) []T
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/tB-Umgm0DrP)</span></b>
```go
package main
@@ -451,7 +453,7 @@ func main() {
func BinarySearch[T any](sortedSlice []T, target T, lowIndex, highIndex int, comparator lancetconstraints.Comparator) int
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/t6MeGiUSN47)</span></b>
```go
package main
@@ -502,7 +504,7 @@ func main() {
func BinaryIterativeSearch[T any](sortedSlice []T, target T, lowIndex, highIndex int, comparator lancetconstraints.Comparator) int
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/Anozfr8ZLH3)</span></b>
```go
package main
@@ -553,7 +555,7 @@ func main() {
func LinearSearch[T any](slice []T, target T, equal func(a, b T) bool) int
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/IsS7rgn5s3x)</span></b>
```go
package main
@@ -596,7 +598,7 @@ func (l *LRUCache[K, V]) Delete(key K) bool
func (l *LRUCache[K, V]) Len() int
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/IsS7rgn5s3x)</span></b>
```go
package main

View File

@@ -34,13 +34,15 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="Equal">Equal</span>
<p>Checks if two values are equal or not. (check both type and value)</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/wmVxR-to4lz)</span></b>
```go
func Equal(left, right any) bool
@@ -89,7 +91,7 @@ func main() {
<p>Checks if two values are equal or not. (check value only)</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/fxnna_LLD9u)</span></b>
```go
func EqualValue(left, right any) bool
@@ -128,7 +130,7 @@ func main() {
<p>Checks if value `left` less than value `right`.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/cYh7FQQj0ne)</span></b>
```go
func LessThan(left, right any) bool
@@ -183,7 +185,7 @@ func main() {
func GreaterThan(left, right any) bool
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/9-NYDFZmIMp)</span></b>
```go
package main
@@ -235,7 +237,7 @@ func main() {
func LessOrEqual(left, right any) bool
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/e4T_scwoQzp)</span></b>
```go
package main
@@ -278,7 +280,7 @@ func main() {
<p>Checks if value `left` less greater or equal than value `right`.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/vx8mP0U8DFk)</span></b>
```go
func GreaterOrEqual(left, right any) bool
@@ -330,7 +332,7 @@ func main() {
<p>Checks if two values are equal or not within a delta.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/TuDdcNtMkjo)</span></b>
```go
func InDelta[T constraints.Integer | constraints.Float](left, right T, delta float64) bool

View File

@@ -33,8 +33,9 @@ import (
<div STYLE="page-break-after: always;"></div>
## Documentation
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
## Channel
### <span id="NewChannel">NewChannel</span>
@@ -46,7 +47,7 @@ import (
type Channel[T any] struct
func NewChannel[T any]() *Channel[T]
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/7aB4KyMMp9A)</span></b>
```go
package main
@@ -70,7 +71,7 @@ func main() {
```go
func (c *Channel[T]) Bridge(ctx context.Context, chanStream <-chan <-chan T) <-chan T
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/qmWSy1NVF-Y)</span></b>
```go
package main
@@ -122,7 +123,7 @@ func main() {
```go
func (c *Channel[T]) FanIn(ctx context.Context, channels ...<-chan T) <-chan T
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/2VYFMexEvTm)</span></b>
```go
package main
@@ -156,7 +157,7 @@ func main() {
<p>Create channel, put values into the channel repeatly until cancel the context.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/k5N_ALVmYjE)</span></b>
```go
func (c *Channel[T]) Repeat(ctx context.Context, values ...T) <-chan T
@@ -200,7 +201,7 @@ func main() {
```go
func (c *Channel[T]) Generate(ctx context.Context, values ...T) <-chan T
```
<b>Example:</b>
<b>Example: <span class="run-container">[Run](https://go.dev/play/p/7aB4KyMMp9A)</span></b>
```go
package main
@@ -233,7 +234,7 @@ func main() {
<p>Create a channel, excutes fn repeatly, and put the result into the channel, until close context.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/4J1zAWttP85)</span></b>
```go
func (c *Channel[T]) RepeatFn(ctx context.Context, fn func() T) <-chan T
@@ -275,7 +276,7 @@ func main() {
<p>Read one or more channels into one channel, will close when any readin channel is closed.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/Wqz9rwioPww)</span></b>
```go
func (c *Channel[T]) Or(channels ...<-chan T) <-chan T
@@ -318,7 +319,7 @@ func main() {
<p>Read a channel into another channel, will close until cancel context.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/lm_GoS6aDjo)</span></b>
```go
func (c *Channel[T]) OrDone(ctx context.Context, channel <-chan T) <-chan T
@@ -356,7 +357,7 @@ func main() {
<p>Create a channel whose values are taken from another channel with limit number.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/9Utt-1pDr2J)</span></b>
```go
func (c *Channel[T]) Take(ctx context.Context, valueStream <-chan T, number int) <-chan T
@@ -402,7 +403,7 @@ func main() {
<p>Split one chanel into two channels, until cancel the context.</p>
<b>Signature:</b>
<b>Signature: <span class="run-container">[Run](https://go.dev/play/p/3TQPKnCirrP)</span></b>
```go
func (c *Channel[T]) Tee(ctx context.Context, in <-chan T) (<-chan T, <-chan T)

View File

@@ -31,6 +31,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
@@ -46,7 +48,7 @@ All other types are truthy if they are not their zero value.</p>
```go
func Bool[T any](value T) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/ETzeDJRSvhm)</span></b>
```go
package main
@@ -111,7 +113,7 @@ func main() {
```go
func And[T, U any](a T, b U) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/W1SSUmt6pvr)</span></b>
```go
package main
@@ -139,7 +141,7 @@ func main() {
```go
func Or[T, U any](a T, b U) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/UlQTxHaeEkq)</span></b>
```go
package main
@@ -167,7 +169,7 @@ func main() {
```go
func Xor[T, U any](a T, b U) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/gObZrW7ZbG8)</span></b>
```go
package main
@@ -195,7 +197,7 @@ func main() {
```go
func Nor[T, U any](a T, b U) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/g2j08F_zZky)</span></b>
```go
package main
@@ -222,7 +224,7 @@ func main() {
```go
func Xnor[T, U any](a T, b U) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/OuDB9g51643)</span></b>
```go
package main
@@ -249,7 +251,7 @@ func main() {
```go
func Nand[T, U any](a T, b U) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/vSRMLxLIbq8)</span></b>
```go
package main
@@ -277,7 +279,7 @@ func main() {
```go
func TernaryOperator[T, U any](isTrue T, ifValue U, elseValue U) U
```
<b>Example:</b>
<b>Example:<span class="run-container">[运行](https://go.dev/play/p/ElllPZY0guT)</span></b>
```go
package main

View File

@@ -46,6 +46,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="ColorHexToRGB">ColorHexToRGB</span>
@@ -58,7 +60,7 @@ import (
func ColorHexToRGB(colorHex string) (red, green, blue int)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/o7_ft-JCJBV)</span></b>
```go
package main
@@ -89,7 +91,7 @@ func main() {
func ColorRGBToHex(red, green, blue int) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/nzKS2Ro87J1)</span></b>
```go
package main
@@ -122,7 +124,7 @@ func main() {
func ToBool(s string) (bool, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/ARht2WnGdIN)</span></b>
```go
package main
@@ -163,7 +165,7 @@ func main() {
func ToBytes(data any) ([]byte, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/fAMXYFDvOvr)</span></b>
```go
package main
@@ -196,7 +198,7 @@ func main() {
func ToChar(s string) []string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/JJ1SvbFkVdM)</span></b>
```go
package main
@@ -232,7 +234,7 @@ func main() {
func ToChannel[T any](array []T) <-chan T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/hOx_oYZbAnL)</span></b>
```go
package main
@@ -269,7 +271,7 @@ func main() {
func ToFloat(value any) (float64, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/4YTmPCibqHJ)</span></b>
```go
package main
@@ -314,7 +316,7 @@ func main() {
func ToInt(value any) (int64, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/9_h9vIt-QZ_b)</span></b>
```go
package main
@@ -356,7 +358,7 @@ func main() {
func ToJson(value any) (string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/2rLIkMmXWvR)</span></b>
```go
package main
@@ -391,7 +393,7 @@ func main() {
func ToMap[T any, K comparable, V any](array []T, iteratee func(T) (K, V)) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/tVFy7E-t24l)</span></b>
```go
package main
@@ -432,7 +434,7 @@ func main() {
func ToPointer[T any](value T) *T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/ASf_etHNlw1)</span></b>
```go
package main
@@ -461,7 +463,7 @@ func main() {
func ToString(value any) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/nF1zOOslpQq)</span></b>
```go
package main
@@ -509,7 +511,7 @@ func main() {
func StructToMap(value any) (map[string]any, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/KYGYJqNUBOI)</span></b>
```go
package main
@@ -547,7 +549,7 @@ func main() {
func MapToSlice[T any, K comparable, V any](aMap map[K]V, iteratee func(K, V) T) []T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/dmX4Ix5V6Wl)</span></b>
```go
package main
@@ -577,7 +579,7 @@ func main() {
func EncodeByte(data any) ([]byte, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/DVmM1G5JfuP)</span></b>
```go
package main
@@ -606,7 +608,7 @@ func main() {
func DecodeByte(data []byte, target any) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/zI6xsmuQRbn)</span></b>
```go
package main
@@ -642,7 +644,7 @@ func main() {
func DeepClone[T any](src T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/j4DP5dquxnk)</span></b>
```go
package main
@@ -706,7 +708,7 @@ func main() {
func CopyProperties[T, U any](dst T, src U) (err error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/oZujoB5Sgg5)</span></b>
```go
package main
@@ -785,7 +787,7 @@ func main() {
func ToInterface(v reflect.Value) (value interface{}, ok bool)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/syqw0-WG7Xd)</span></b>
```go
package main
@@ -820,7 +822,7 @@ func main() {
func Utf8ToGbk(bs []byte) ([]byte, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/9FlIaFLArIL)</span></b>
```go
package main
@@ -854,7 +856,7 @@ func main() {
func GbkToUtf8(bs []byte) ([]byte, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/OphmHCN_9u8)</span></b>
```go
package main

View File

@@ -69,6 +69,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="AesEcbEncrypt">AesEcbEncrypt</span>
@@ -80,7 +82,7 @@ import (
```go
func AesEcbEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/zI6xsmuQRbn)</span></b>
```go
package main
@@ -113,7 +115,7 @@ func main() {
```go
func AesEcbDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/zI6xsmuQRbn)</span></b>
```go
package main
@@ -146,7 +148,7 @@ func main() {
```go
func AesCbcEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/IOq_g8_lKZD)</span></b>
```go
package main
@@ -180,7 +182,7 @@ func main() {
func AesCbcDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/IOq_g8_lKZD)</span></b>
```go
package main
@@ -214,7 +216,7 @@ func main() {
func AesCtrCrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/SpaZO0-5Nsp)</span></b>
```go
package main
@@ -248,7 +250,7 @@ func main() {
func AesCfbEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/tfkF10B13kH)</span></b>
```go
package main
@@ -282,7 +284,7 @@ func main() {
func AesCfbDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/tfkF10B13kH)</span></b>
```go
package main
@@ -316,7 +318,7 @@ func main() {
func AesOfbEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/VtHxtkUj-3F)</span></b>
```go
package main
@@ -349,7 +351,7 @@ func main() {
func AesOfbDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/VtHxtkUj-3F)</span></b>
```go
package main
@@ -382,7 +384,7 @@ func main() {
```go
func Base64StdEncode(s string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/VOaUyQUreoK)</span></b>
```go
package main
@@ -410,7 +412,7 @@ func main() {
func Base64StdDecode(s string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/RWQylnJVgIe)</span></b>
```go
package main
@@ -439,7 +441,7 @@ func main() {
func DesEcbEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/8qivmPeZy4P)</span></b>
```go
package main
@@ -473,7 +475,7 @@ func main() {
func DesEcbDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/8qivmPeZy4P)</span></b>
```go
package main
@@ -508,7 +510,7 @@ func main() {
func DesCbcEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/4cC4QvWfe3_1)</span></b>
```go
package main
@@ -542,7 +544,7 @@ func main() {
func DesCbcDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/4cC4QvWfe3_1)</span></b>
```go
package main
@@ -575,7 +577,7 @@ func main() {
func DesCtrCrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/9-T6OjKpcdw)</span></b>
```go
package main
@@ -609,7 +611,7 @@ func main() {
func DesCfbEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/y-eNxcFBlxL)</span></b>
```go
package main
@@ -642,7 +644,7 @@ func main() {
func DesCfbDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/y-eNxcFBlxL)</span></b>
```go
package main
@@ -675,7 +677,7 @@ func main() {
func DesOfbEncrypt(data, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/74KmNadjN1J)</span></b>
```go
package main
@@ -708,7 +710,7 @@ func main() {
func DesOfbDecrypt(encrypted, key []byte) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/74KmNadjN1J)</span></b>
```go
package main
@@ -742,7 +744,7 @@ func main() {
func HmacMd5(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/uef0q1fz53I)</span></b>
```go
package main
@@ -774,7 +776,7 @@ func main() {
func HmacMd5WithBase64(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/UY0ng2AefFC)</span></b>
```go
package main
@@ -806,7 +808,7 @@ func main() {
func HmacSha1(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/1UI4oQ4WXKM)</span></b>
```go
package main
@@ -838,7 +840,7 @@ func main() {
func HmacSha1WithBase64(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/47JmmGrnF7B)</span></b>
```go
package main
@@ -870,7 +872,7 @@ func main() {
func HmacSha256(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/HhpwXxFhhC0)</span></b>
```go
package main
@@ -902,7 +904,7 @@ func main() {
func HmacSha256WithBase64(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/EKbkUvPTLwO)</span></b>
```go
package main
@@ -934,7 +936,7 @@ func main() {
func HmacSha512(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/59Od6m4A0Ud)</span></b>
```go
package main
@@ -966,7 +968,7 @@ func main() {
func HmacSha512WithBase64(str, key string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/c6dSe3E2ydU)</span></b>
```go
package main
@@ -999,7 +1001,7 @@ func main() {
func Md5String(s string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/1bLcVetbTOI)</span></b>
```go
package main
@@ -1030,7 +1032,7 @@ func main() {
func Md5StringWithBase64(s string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Tcb-Z7LN2ax)</span></b>
```go
package main
@@ -1059,7 +1061,7 @@ func main() {
func Md5Byte(data []byte) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/suraalH8lyC)</span></b>
```go
package main
@@ -1088,7 +1090,7 @@ func main() {
func Md5ByteWithBase64(data []byte) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Lx4gH7Vdr5_y)</span></b>
```go
package main
@@ -1143,7 +1145,7 @@ func main() {
func Sha1(str string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/_m_uoD1deMT)</span></b>
```go
package main
@@ -1174,7 +1176,7 @@ func main() {
func Sha1WithBase64(str string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/fSyx-Gl2l2-)</span></b>
```go
package main
@@ -1203,7 +1205,7 @@ func main() {
func Sha256(str string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/tU9tfBMIAr1)</span></b>
```go
package main
@@ -1234,7 +1236,7 @@ func main() {
func Sha256WithBase64(str string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/85IXJHIal1k)</span></b>
```go
package main
@@ -1263,7 +1265,7 @@ func main() {
func Sha512(str string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/3WsvLYZxsHa)</span></b>
```go
package main
@@ -1294,7 +1296,7 @@ func main() {
func Sha512WithBase64(str string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/q_fY2rA-k5I)</span></b>
```go
package main
@@ -1323,7 +1325,7 @@ func main() {
func GenerateRsaKey(keySize int, priKeyFile, pubKeyFile string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/zutRHrDqs0X)</span></b>
```go
package main
@@ -1351,7 +1353,7 @@ func main() {
func RsaEncrypt(data []byte, pubKeyFileName string) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/uef0q1fz53I)</span></b>
```go
package main
@@ -1389,7 +1391,7 @@ func main() {
func RsaDecrypt(data []byte, privateKeyFileName string) []byte
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/uef0q1fz53I)</span></b>
```go
package main

View File

@@ -68,6 +68,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
## Note:
@@ -107,7 +109,7 @@ import (
func AddDay(t time.Time, day int64) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/dIGbs_uTdFa)</span></b>
```go
package main
@@ -146,7 +148,7 @@ func main() {
func AddHour(t time.Time, hour int64) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/rcMjd7OCsi5)</span></b>
```go
package main
@@ -185,7 +187,7 @@ func main() {
func AddMinute(t time.Time, minute int64) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/nT1heB1KUUK)</span></b>
```go
package main
@@ -224,7 +226,7 @@ func main() {
func AddYear(t time.Time, year int64) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/MqW2ujnBx10)</span></b>
```go
package main
@@ -263,7 +265,7 @@ func main() {
func BeginOfMinute(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/ieOLVJ9CiFT)</span></b>
```go
package main
@@ -295,7 +297,7 @@ func main() {
func BeginOfHour(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/GhdGFnDWpYs)</span></b>
```go
package main
@@ -327,7 +329,7 @@ func main() {
func BeginOfDay(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/94m_UT6cWs9)</span></b>
```go
package main
@@ -359,7 +361,7 @@ func main() {
func BeginOfWeek(t time.Time, beginFrom ...time.Weekday) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/ynjoJPz7VNV)</span></b>
```go
package main
@@ -391,7 +393,7 @@ func main() {
func BeginOfMonth(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/bWXVFsmmzwL)</span></b>
```go
package main
@@ -423,7 +425,7 @@ func main() {
func BeginOfYear(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/i326DSwLnV8)</span></b>
```go
package main
@@ -455,7 +457,7 @@ func main() {
func EndOfMinute(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/yrL5wGzPj4z)</span></b>
```go
package main
@@ -487,7 +489,7 @@ func main() {
func EndOfHour(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/6ce3j_6cVqN)</span></b>
```go
package main
@@ -519,7 +521,7 @@ func main() {
func EndOfDay(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/eMBOvmq5Ih1)</span></b>
```go
package main
@@ -551,7 +553,7 @@ func main() {
func EndOfWeek(t time.Time, endWith ...time.Weekday) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/i08qKXD9flf)</span></b>
```go
package main
@@ -583,7 +585,7 @@ func main() {
func EndOfMonth(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/_GWh10B3Nqi)</span></b>
```go
package main
@@ -615,7 +617,7 @@ func main() {
func EndOfYear(t time.Time) time.Time
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/G01cKlMCvNm)</span></b>
```go
package main
@@ -647,7 +649,7 @@ func main() {
func GetNowDate() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/PvfkPpcpBBf)</span></b>
```go
package main
@@ -676,7 +678,7 @@ func main() {
func GetNowTime() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/l7BNxCkTmJS)</span></b>
```go
package main
@@ -705,7 +707,7 @@ func main() {
func GetNowDateTime() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/pI4AqngD0al)</span></b>
```go
package main
@@ -734,7 +736,7 @@ func main() {
func GetTodayStartTime() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/84siyYF7t99)</span></b>
```go
package main
@@ -763,7 +765,7 @@ func main() {
func GetTodayEndTime() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/jjrLnfoqgn3)</span></b>
```go
package main
@@ -792,7 +794,7 @@ func main() {
func GetZeroHourTimestamp() int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/QmL2oIaGE3q)</span></b>
```go
package main
@@ -821,7 +823,7 @@ func main() {
func GetNightTimestamp() int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/UolysR3MYP1)</span></b>
```go
package main
@@ -850,7 +852,7 @@ func main() {
func FormatTimeToStr(t time.Time, format string, timezone ...string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/_Ia7M8H_OvE)</span></b>
```go
package main
@@ -889,7 +891,7 @@ func main() {
func FormatStrToTime(str, format string, timezone ...string) (time.Time, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/1h9FwdU8ql4)</span></b>
```go
package main
@@ -928,7 +930,7 @@ type theTime struct {
func NewUnixNow() *theTime
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/U4PPx-9D0oz)</span></b>
```go
package main
@@ -960,7 +962,7 @@ type theTime struct {
func NewUnix(unix int64) *theTime
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/psoSuh_kLRt)</span></b>
```go
package main
@@ -992,7 +994,7 @@ type theTime struct {
func NewFormat(t string) (*theTime, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/VkW08ZOaXPZ)</span></b>
```go
package main
@@ -1024,7 +1026,7 @@ type theTime struct {
func NewISO8601(iso8601 string) (*theTime, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/mkhOHQkdeA2)</span></b>
```go
package main
@@ -1053,7 +1055,7 @@ func main() {
func (t *theTime) ToUnix() int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/_LUiwAdocjy)</span></b>
```go
package main
@@ -1082,7 +1084,7 @@ func main() {
func (t *theTime) ToFormat() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/VkW08ZOaXPZ)</span></b>
```go
package main
@@ -1111,7 +1113,7 @@ func main() {
func (t *theTime) ToFormatForTpl(tpl string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/nyXxXcQJ8L5)</span></b>
```go
package main
@@ -1141,7 +1143,7 @@ func main() {
func (t *theTime) ToIso8601() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/mkhOHQkdeA2)</span></b>
```go
package main
@@ -1171,7 +1173,7 @@ func main() {
func IsLeapYear(year int) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/xS1eS2ejGew)</span></b>
```go
package main
@@ -1204,7 +1206,7 @@ func main() {
func BetweenSeconds(t1 time.Time, t2 time.Time) int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/n3YDRyfyXJu)</span></b>
```go
package main
@@ -1241,7 +1243,7 @@ func main() {
func DayOfYear(t time.Time) int
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/0hjqhTwFNlH)</span></b>
```go
package main
@@ -1282,7 +1284,7 @@ func main() {
func IsWeekend(t time.Time) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/cupRM5aZOIY)</span></b>
```go
package main
@@ -1322,7 +1324,7 @@ func main() {
func NowDateOrTime(format string, timezone ...string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/EZ-begEjtT0)</span></b>
```go
package main
@@ -1356,7 +1358,7 @@ func main() {
func Timestamp(timezone ...string) int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/iU5b7Vvjx6x)</span></b>
```go
package main
@@ -1387,7 +1389,7 @@ func main() {
func TimestampMilli(timezone ...string) int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/4gvEusOTu1T)</span></b>
```go
package main
@@ -1417,7 +1419,7 @@ func main() {
func TimestampMicro(timezone ...string) int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/2maANglKHQE)</span></b>
```go
package main
@@ -1447,7 +1449,7 @@ func main() {
func TimestampNano(timezone ...string) int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/A9Oq_COrcCF)</span></b>
```go
package main

View File

@@ -50,6 +50,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="ClearFile">ClearFile</span>
@@ -62,7 +64,7 @@ import (
func ClearFile(path string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/NRZ0ZT-G94H)</span></b>
```go
package main
@@ -90,7 +92,7 @@ func main() {
func CreateFile(path string) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/lDt8PEsTNKI)</span></b>
```go
package main
@@ -116,7 +118,7 @@ func main() {
func CreateDir(absPath string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/qUuCe1OGQnM)</span></b>
```go
package main
@@ -142,7 +144,7 @@ func main() {
func CopyFile(srcPath string, dstPath string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Jg9AMJMLrJi)</span></b>
```go
package main
@@ -170,7 +172,7 @@ func main() {
func CurrentPath() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/s74a9iBGcSw)</span></b>
```go
package main
@@ -196,7 +198,7 @@ func main() {
func FileMode(path string) (fs.FileMode, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/2l2hI42fA3p)</span></b>
```go
package main
@@ -225,7 +227,7 @@ func main() {
func MiMeType(file any) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/bd5sevSUZNu)</span></b>
```go
package main
@@ -256,7 +258,7 @@ func main() {
func IsExist(path string) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/nKKXt8ZQbmh)</span></b>
```go
package main
@@ -283,7 +285,7 @@ func main() {
func IsLink(path string) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/TL-b-Kzvf44)</span></b>
```go
package main
@@ -309,7 +311,7 @@ func main() {
func IsDir(path string) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/WkVwEKqtOWk)</span></b>
```go
package main
@@ -338,7 +340,7 @@ func main() {
func ListFileNames(path string) ([]string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Tjd7Y07rejl)</span></b>
```go
package main
@@ -364,7 +366,7 @@ func main() {
func RemoveFile(path string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/P2y0XW8a1SH)</span></b>
```go
package main
@@ -392,7 +394,7 @@ func main() {
func ReadFileToString(path string) (string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/cmfwp_5SQTp)</span></b>
```go
package main
@@ -425,7 +427,7 @@ func main() {
func ReadFileByLine(path string)([]string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/svJP_7ZrBrD)</span></b>
```go
package main
@@ -459,7 +461,7 @@ func main() {
func Zip(fpath string, destPath string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/j-3sWBp8ik_P)</span></b>
```go
package main
@@ -487,7 +489,7 @@ func main() {
func ZipAppendEntry(fpath string, destPath string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/cxvaT8TRNQp)</span></b>
```go
package main
@@ -515,7 +517,7 @@ func main() {
func UnZip(zipFile string, destPath string) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/g0w34kS7B8m)</span></b>
```go
package main
@@ -543,7 +545,7 @@ func main() {
func IsZipFile(filepath string) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/9M0g2j_uF_e)</span></b>
```go
package main
@@ -569,7 +571,7 @@ func main() {
func FileSize(path string) (int64, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/H9Z05uD-Jjc)</span></b>
```go
package main
@@ -601,7 +603,7 @@ func main() {
func MTime(filepath string) (int64, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/s_Tl7lZoAaY)</span></b>
```go
package main
@@ -633,7 +635,7 @@ func main() {
func Sha(filepath string, shaType ...int) (string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/VfEEcO2MJYf)</span></b>
```go
package main
@@ -671,7 +673,7 @@ func main() {
func ReadCsvFile(filepath string) ([][]string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/OExTkhGEd3_u)</span></b>
```go
package main
@@ -703,7 +705,7 @@ func main() {
func WriteCsvFile(filepath string, records [][]string, append bool) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/dAXm58Q5U1o)</span></b>
```go
package main
@@ -752,7 +754,7 @@ func main() {
func WriteBytesToFile(filepath string, content []byte) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/s7QlDxMj3P8)</span></b>
```go
package main
@@ -801,7 +803,7 @@ func main() {
func WriteStringToFile(filepath string, content string, append bool) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/GhLS6d8lH_g)</span></b>
```go
package main

View File

@@ -33,6 +33,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="Comma">Comma</span>
@@ -45,7 +47,7 @@ import (
func Comma[T constraints.Float | constraints.Integer | string](value T, symbol string) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/eRD5k2vzUVX)</span></b>
```go
package main
@@ -81,7 +83,7 @@ func main() {
func Pretty(v any) (string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/YsciGj3FH2x)</span></b>
```go
package main
@@ -120,7 +122,7 @@ func main() {
func PrettyToWriter(v any, out io.Writer) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/LPLZ3lDi5ma)</span></b>
```go
package main
@@ -163,7 +165,7 @@ func main() {
func DecimalBytes(size float64, precision ...int) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/FPXs1suwRcs)</span></b>
```go
package main
@@ -202,7 +204,7 @@ func main() {
func BinaryBytes(size float64, precision ...int) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/G9oHHMCAZxP)</span></b>
```go
package main
@@ -241,7 +243,7 @@ func main() {
func ParseDecimalBytes(size string) (uint64, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Am98ybWjvjj)</span></b>
```go
package main
@@ -280,7 +282,7 @@ func main() {
func ParseBinaryBytes(size string) (uint64, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/69v1tTT62x8)</span></b>
```go
package main

View File

@@ -35,6 +35,7 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="After">After</span>
@@ -47,7 +48,7 @@ import (
func After(n int, fn any) func(args ...any) []reflect.Value
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/eRD5k2vzUVX)</span></b>
```go
package main
@@ -80,7 +81,7 @@ func main() {
func Before(n int, fn any) func(args ...any) []reflect.Value
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/0HqUDIFZ3IL)</span></b>
```go
package main
@@ -88,7 +89,6 @@ package main
import (
"fmt"
"github.com/duke-git/lancet/v2/function"
"github.com/duke-git/lancet/v2/internal"
)
func main() {
@@ -118,7 +118,7 @@ type CurryFn[T any] func(...T) T
func (cf CurryFn[T]) New(val T) func(...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/5HopfDwANKX)</span></b>
```go
package main
@@ -157,7 +157,7 @@ func main() {
func Compose[T any](fnList ...func(...T) T) func(...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/KKfugD4PKYF)</span></b>
```go
package main
@@ -195,7 +195,7 @@ func main() {
func Debounced(fn func(), duration time.Duration) func()
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/absuEGB_GN7)</span></b>
```go
package main
@@ -245,7 +245,7 @@ func main() {
func Delay(delay time.Duration, fn any, args ...any)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Ivtc2ZE-Tye)</span></b>
```go
package main
@@ -277,7 +277,7 @@ func main() {
func Schedule(d time.Duration, fn any, args ...any) chan bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/hbON-Xeyn5N)</span></b>
```go
package main
@@ -317,7 +317,7 @@ the functions one by one.</p>
func Pipeline[T any](funcs ...func(T) T) func(T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/mPdUVvj6HD6)</span></b>
```go
package main
@@ -368,7 +368,7 @@ func (w *Watcher) Reset() //reset the watcher
func (w *Watcher) GetElapsedTime() time.Duration //get the elapsed time of function execution
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/l2yrOpCLd1I)</span></b>
```go
package main
@@ -379,7 +379,7 @@ import (
)
func main() {
w := function.NewWatcher()
w := function.NewWatcher()
w.Start()

View File

@@ -55,6 +55,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="MapTo">MapTo</span>
@@ -67,7 +69,7 @@ import (
func MapTo(src any, dst any) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/4K7KBEPgS5M)</span></b>
```go
package main
@@ -124,7 +126,7 @@ func main() {
func ForEach[K comparable, V any](m map[K]V, iteratee func(key K, value V))
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/OaThj6iNVXK)</span></b>
```go
package main
@@ -165,7 +167,7 @@ func main() {
func Filter[K comparable, V any](m map[K]V, predicate func(key K, value V) bool) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/fSvF3wxuNG7)</span></b>
```go
package main
@@ -210,7 +212,7 @@ func main() {
func FilterByKeys[K comparable, V any](m map[K]V, keys []K) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/7ov6BJHbVqh)</span></b>
```go
package main
@@ -248,7 +250,7 @@ func main() {
func FilterByValues[K comparable, V comparable](m map[K]V, values []V) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/P3-9MdcXegR)</span></b>
```go
package main
@@ -286,7 +288,7 @@ func main() {
func OmitBy[K comparable, V any](m map[K]V, predicate func(key K, value V) bool) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/YJM4Hj5hNwm)</span></b>
```go
package main
@@ -327,7 +329,7 @@ func main() {
func OmitByKeys[K comparable, V any](m map[K]V, keys []K) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/jXGrWDBfSRp)</span></b>
```go
package main
@@ -365,7 +367,7 @@ func main() {
func OmitByValues[K comparable, V comparable](m map[K]V, values []V) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/XB7Y10uw20_U)</span></b>
```go
package main
@@ -403,7 +405,7 @@ func main() {
func Intersect[K comparable, V any](maps ...map[K]V) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Zld0oj3sjcC)</span></b>
```go
package main
@@ -458,7 +460,7 @@ func main() {
func Keys[K comparable, V any](m map[K]V) []K
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/xNB5bTb97Wd)</span></b>
```go
package main
@@ -498,7 +500,7 @@ func main() {
func Merge[K comparable, V any](maps ...map[K]V) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/H95LENF1uB-)</span></b>
```go
package main
@@ -537,7 +539,7 @@ func main() {
func Minus[K comparable, V any](mapA, mapB map[K]V) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/3u5U9K7YZ9m)</span></b>
```go
package main
@@ -579,7 +581,7 @@ func main() {
func Values[K comparable, V any](m map[K]V) []V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/CBKdUc5FTW6)</span></b>
```go
package main
@@ -619,7 +621,7 @@ func main() {
func KeysBy[K comparable, V any, T any](m map[K]V, mapper func(item K) T) []T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/hI371iB8Up8)</span></b>
```go
package main
@@ -660,7 +662,7 @@ func main() {
func ValuesBy[K comparable, V any, T any](m map[K]V, mapper func(item V) T) []T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/sg9-oRidh8f)</span></b>
```go
package main
@@ -709,7 +711,7 @@ func main() {
func MapKeys[K comparable, V any, T comparable](m map[K]V, iteratee func(key K, value V) T) map[T]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/8scDxWeBDKd)</span></b>
```go
package main
@@ -748,7 +750,7 @@ func main() {
func MapValues[K comparable, V any, T any](m map[K]V, iteratee func(key K, value V) T) map[K]T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/g92aY3fc7Iw)</span></b>
```go
package main
@@ -791,7 +793,7 @@ type Entry[K comparable, V any] struct {
func Entries[K comparable, V any](m map[K]V) []Entry[K, V]
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Ltb11LNcElY)</span></b>
```go
package main
@@ -836,7 +838,7 @@ type Entry[K comparable, V any] struct {
func FromEntries[K comparable, V any](entries []Entry[K, V]) map[K]V
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/fTdu4sCNjQO)</span></b>
```go
package main
@@ -870,7 +872,7 @@ func main() {
func Transform[K1 comparable, V1 any, K2 comparable, V2 any](m map[K1]V1, iteratee func(key K1, value V1) (K2, V2)) map[K2]V2
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/P6ovfToM3zj)</span></b>
```go
package main
@@ -909,7 +911,7 @@ func main() {
func IsDisjoint[K comparable, V any](mapA, mapB map[K]V) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/N9qgYg_Ho6f)</span></b>
```go
package main
@@ -964,7 +966,7 @@ if haskey {
func HasKey[K comparable, V any](m map[K]V, key K) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/isZZHOsDhFc)</span></b>
```go
package main
@@ -1003,7 +1005,7 @@ func main() {
func NewConcurrentMap[K comparable, V any](shardCount int) *ConcurrentMap[K, V]
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/3PenTPETJT0)</span></b>
```go
package main
@@ -1029,7 +1031,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Set(key K, value V)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/3PenTPETJT0)</span></b>
```go
package main
@@ -1084,7 +1086,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Get(key K) (V, bool)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/3PenTPETJT0)</span></b>
```go
package main
@@ -1139,7 +1141,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) GetOrSet(key K, value V) (actual V, ok bool)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/aDcDApOK01a)</span></b>
```go
package main
@@ -1183,7 +1185,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Delete(key K)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/uTIJZYhpVMS)</span></b>
```go
package main
@@ -1220,7 +1222,6 @@ func main() {
}
```
### <span id="ConcurrentMap_GetAndDelete">ConcurrentMap_GetAndDelete</span>
<p>Returns the existing value for the key if present and then delete the value for the key. Otherwise, do nothing, just return false.</p>
@@ -1231,7 +1232,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) GetAndDelete(key K) (actual V, ok bool)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/ZyxeIXSZUiM)</span></b>
```go
package main
@@ -1264,7 +1265,7 @@ func main() {
_, ok = cm.Get(fmt.Sprintf("%d", n))
fmt.Println(val, ok) //false
wg2.Done()
}(j)
}
@@ -1273,7 +1274,6 @@ func main() {
}
```
### <span id="ConcurrentMap_Has">ConcurrentMap_Has</span>
<p>Checks if map has the value for a key.</p>
@@ -1284,7 +1284,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Has(key K) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/C8L4ul9TVwf)</span></b>
```go
package main
@@ -1321,7 +1321,6 @@ func main() {
}
```
### <span id="ConcurrentMap_Range">ConcurrentMap_Range</span>
<p>Calls iterator sequentially for each key and value present in each of the shards in the map. If iterator returns false, range stops the iteration.</p>
@@ -1332,7 +1331,7 @@ func main() {
func (cm *ConcurrentMap[K, V]) Range(iterator func(key K, value V) bool)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/iqcy7P8P0Pr)</span></b>
```go
package main
@@ -1356,7 +1355,7 @@ func main() {
}
wg1.Wait()
cm.Range(func(key string, value int) bool {
fmt.Println(value)
return true

View File

@@ -48,9 +48,10 @@ import (
- [Sum](#Sum)
- [Abs](#Abs)
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="Average">Average</span>
@@ -63,7 +64,7 @@ import (
func Average[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Vv7LBwER-pz)</span></b>
```go
package main
@@ -98,7 +99,7 @@ func main() {
func Exponent(x, n int64) int64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/uF3HGNPk8wr)</span></b>
```go
package main
@@ -134,7 +135,7 @@ func main() {
func Fibonacci(first, second, n int) int
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/IscseUNMuUc)</span></b>
```go
package main
@@ -170,7 +171,7 @@ func main() {
func Factorial(x uint) uint
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/tt6LdOK67Nx)</span></b>
```go
package main
@@ -206,7 +207,7 @@ func main() {
func Max[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/cN8DHI0rTkH)</span></b>
```go
package main
@@ -239,7 +240,7 @@ func main() {
func MaxBy[T any](slice []T, comparator func(T, T) bool) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/pbe2MT-7DV2)</span></b>
```go
package main
@@ -283,7 +284,7 @@ func main() {
func Min[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/21BER_mlGUj)</span></b>
```go
package main
@@ -316,7 +317,7 @@ func main() {
func MinBy[T any](slice []T, comparator func(T, T) bool) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/N9qgYg_Ho6f)</span></b>
```go
package main
@@ -360,7 +361,7 @@ func main() {
func Percent(val, total float64, n int) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/s0NdFCtwuyd)</span></b>
```go
package main
@@ -396,7 +397,7 @@ func main() {
func RoundToFloat(x float64, n int) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/ghyb528JRJL)</span></b>
```go
package main
@@ -432,7 +433,7 @@ func main() {
func RoundToString(x float64, n int) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/kZwpBRAcllO)</span></b>
```go
package main
@@ -468,7 +469,7 @@ func main() {
func TruncRound(x float64, n int) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/aumarSHIGzP)</span></b>
```go
package main
@@ -504,7 +505,7 @@ func main() {
func Range[T constraints.Integer | constraints.Float](start T, count int) []T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/9ke2opxa8ZP)</span></b>
```go
package main
@@ -543,7 +544,7 @@ func main() {
func RangeWithStep[T constraints.Integer | constraints.Float](start, end, step T) []T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/akLWz0EqOSM)</span></b>
```go
package main
@@ -582,7 +583,7 @@ func main() {
func AngleToRadian(angle float64) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/CIvlICqrHql)</span></b>
```go
package main
@@ -618,7 +619,7 @@ func main() {
func RadianToAngle(radian float64) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/dQtmOTUOMgi)</span></b>
```go
package main
@@ -654,7 +655,7 @@ func main() {
func PointDistance(x1, y1, x2, y2 float64) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/RrG4JIaziM8)</span></b>
```go
package main
@@ -684,7 +685,7 @@ func main() {
func IsPrime(n int) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Rdd8UTHZJ7u)</span></b>
```go
package main
@@ -723,7 +724,7 @@ func main() {
func GCD[T constraints.Integer](integers ...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/CiEceLSoAKB)</span></b>
```go
package main
@@ -765,7 +766,7 @@ func main() {
func LCM[T constraints.Integer](integers ...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/EjcZxfY7G_g)</span></b>
```go
package main
@@ -791,7 +792,6 @@ func main() {
}
```
### <span id="Cos">Cos</span>
<p>Returns the cosine of the radian argument.</p>
@@ -802,7 +802,7 @@ func main() {
func Cos(radian float64, precision ...int) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Sm89LoIfvFq)</span></b>
```go
package main
@@ -834,7 +834,6 @@ func main() {
}
```
### <span id="Sin">Sin</span>
<p>Returns the sine of the radian argument.</p>
@@ -845,7 +844,7 @@ func main() {
func Sin(radian float64, precision ...int) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/TWMQlMywDsP)</span></b>
```go
package main
@@ -887,7 +886,7 @@ func main() {
func Log(n, base float64) float64
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/_d4bi8oyhat)</span></b>
```go
package main
@@ -923,7 +922,7 @@ func main() {
func Sum[T constraints.Integer | constraints.Float](numbers ...T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/1To2ImAMJA7)</span></b>
```go
package main
@@ -956,7 +955,7 @@ func main() {
func Abs[T constraints.Integer | constraints.Float](x T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/fsyBh1Os-1d)</span></b>
```go
package main
@@ -980,4 +979,4 @@ func main() {
// 0.1
// 0.2
}
```
```

View File

@@ -51,6 +51,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="ConvertMapToQueryString">ConvertMapToQueryString</span>
@@ -63,7 +65,7 @@ import (
func ConvertMapToQueryString(param map[string]any) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/jnNt_qoSnRi)</span></b>
```go
package main
@@ -96,7 +98,7 @@ func main() {
func EncodeUrl(urlStr string) (string, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/bsZ6BRC4uKI)</span></b>
```go
package main
@@ -131,7 +133,7 @@ func main() {
func GetInternalIp() string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/5mbu-gFp7ei)</span></b>
```go
package main
@@ -163,7 +165,7 @@ func main() {
func GetIps() []string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/NUFfcEmukx1)</span></b>
```go
package main
@@ -193,7 +195,7 @@ func main() {
func GetMacAddrs() []string {
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/Rq9UUBS_Xp1)</span></b>
```go
package main
@@ -237,7 +239,7 @@ type PublicIpInfo struct {
}
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/YDxIfozsRHR)</span></b>
```go
package main
@@ -267,7 +269,7 @@ func main() {
func GetRequestPublicIp(req *http.Request) string
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/kxU-YDc_eBo)</span></b>
```go
package main
@@ -305,7 +307,7 @@ func main() {
func IsPublicIP(IP net.IP) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/nmktSQpJZnn)</span></b>
```go
package main
@@ -342,7 +344,7 @@ func main() {
func IsInternalIP(IP net.IP) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/sYGhXbgO4Cb)</span></b>
```go
package main
@@ -386,7 +388,7 @@ type HttpRequest struct {
}
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -443,7 +445,7 @@ func NewHttpClientWithConfig(config *HttpClientConfig) *HttpClient
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -474,7 +476,7 @@ func main() {
func (client *HttpClient) SendRequest(request *HttpRequest) (*http.Response, error)
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -528,7 +530,7 @@ func main() {
func (client *HttpClient) DecodeResponse(resp *http.Response, target any) error
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/jUSgynekH7G)</span></b>
```go
package main
@@ -582,7 +584,7 @@ func main() {
func StructToUrlValues(targetStruct any) url.Values
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/pFqMkM40w9z)</span></b>
```go
package main
@@ -964,7 +966,7 @@ func main() {
func IsPingConnected(host string) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/q8OzTijsA87)</span></b>
```go
package main
@@ -997,7 +999,7 @@ func main() {
func IsTelnetConnected(host string, port string) bool
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/yiLCGtQv_ZG)</span></b>
```go
package main

View File

@@ -30,6 +30,8 @@ import (
<div STYLE="page-break-after: always;"></div>
<link rel="stylesheet" type="text/css" href="/styles/api_doc.css">
## Documentation
### <span id="Of">Of</span>
@@ -42,7 +44,7 @@ import (
func Of[T any](v T) *T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/HFd70x4DrMj)</span></b>
```go
package main
@@ -76,7 +78,7 @@ func main() {
func Unwrap[T any](p *T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/cgeu3g7cjWb)</span></b>
```go
package main
@@ -112,7 +114,7 @@ func main() {
UnwarpOr[T any](p *T, fallback T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/mmNaLC38W8C)</span></b>
```go
package main
@@ -157,7 +159,7 @@ func main() {
UnwarpOrDefault[T any](p *T) T
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/ZnGIHf8_o4E)</span></b>
```go
package main
@@ -203,7 +205,7 @@ func main() {
func ExtractPointer(value any) any
```
<b>Example:</b>
<b>Example:<span class="run-container">[Run](https://go.dev/play/p/D7HFjeWU2ZP)</span></b>
```go
package main

View File

@@ -0,0 +1,50 @@
---
outline: deep
---
# Installation
1. <b>For users who use go1.18 and above, it is recommended to install lancet v2.x.x. Cause in v2.x.x all functions was rewriten with generics of go1.18.</b>
```go
go get github.com/duke-git/lancet/v2 // will install latest version of v2.x.x
```
2. <b>For users who use version below go1.18, you should install v1.x.x. The latest of v1.x.x is v1.4.1. </b>
```go
go get github.com/duke-git/lancet // below go1.18, install latest version of v1.x.x
```
## Usage
Lancet organizes the code into package structure, and you need to import the corresponding package name when use it. For example, if you use string-related functions, just import the strutil package like below:
```go
import "github.com/duke-git/lancet/v2/strutil"
```
## Example
Here takes the string function `Reverse` (reverse order string) as an example, and the strutil package needs to be imported.
```go
package main
import (
"fmt"
"github.com/duke-git/lancet/v2/strutil"
)
func main() {
s := "hello"
rs := strutil.Reverse(s)
fmt.Println(rs) //olleh
}
```
## More
Check out the [APIs]([API](https://lancet.go.dev/api/overview.html)) for details.

View File

@@ -0,0 +1,18 @@
---
outline: deep
---
# What is lancet?
<b>Lancet is a powerful, efficient, and reusable util function library of go. Inspired by the java apache common package and lodash.js. </b>
## Why lancet?
Lancet makes Go dev easier by taking the hassle out of working with concurrency, net, math, slice, string, etc.
Lancet's utility methods are great for:
- Iterating slice and array.
- Manipulating strings.
- Work with net and http.
- Other tools, eg. random, crypto, stream, retry, etc.

43
docs/en/index.md Normal file
View File

@@ -0,0 +1,43 @@
---
# https://vitepress.dev/reference/default-theme-home-page
layout: home
hero:
name: "Lancet"
text: "A powerful util function library of Go"
tagline: Simple, powerful, and efficient.
actions:
- theme: brand
text: Get Started
link: /en/guide/getting_started
- theme: alt
text: View on GitHub
link: https://github.com/duke-git/lancet
# - theme: alt
# text: API Examples
# link: /api-examples
image:
src: /lancet_logo.png
alt: lancet
features:
- title: Powerful
icon: 💪
details: support 600+ go util functions. inclueds string, slice, datetime, net, crypto, concurrency, etc.
- title: Modular by design
icon: 🏗
details: Each module is designed as a package with no coupling between modules.
- title: Pure
icon: 💅
details: Only depends on two kinds of libraries, go standard library and golang.org/x.
- title: Simple
icon: 👏
details: Well structure, test for every exported function.
---
<p style="position:relative; top: -316px;left: 560px;">
<img style="display: inline-block;margin-right:10px;" src="https://img.shields.io/github/stars/duke-git/lancet?style=social" alt="">
<img style="display: inline-block" src="https://img.shields.io/github/forks/duke-git/lancet?style=social" alt="">
</p>

View File

@@ -0,0 +1,48 @@
---
outline: deep
---
# 安装
1. <b>使用 go1.18 及以上版本的用户,建议安装 v2.x.x。 因为 v2.x.x 应用 go1.18 的泛型重写了大部分函数。</b>
```go
go get github.com/duke-git/lancet/v2 // will install latest version of v2.x.x
```
2. <b>使用 go1.18 以下版本的用户,必须安装 v1.x.x。目前最新的 v1 版本是 v1.4.1。</b>
```go
go get github.com/duke-git/lancet // below go1.18, install latest version of v1.x.x
```
## 用法
lancet 是以包的结构组织代码的,使用时需要导入相应的包名。例如:如果使用字符串相关函数,需要导入 strutil 包:
```go
import "github.com/duke-git/lancet/v2/strutil"
```
## 示例
此处以字符串工具函数 Reverse逆序字符串为例需要导入 strutil 包:
```go
package main
import (
"fmt"
"github.com/duke-git/lancet/v2/strutil"
)
func main() {
s := "hello"
rs := strutil.Reverse(s)
fmt.Println(rs) //olleh
}
```
## More
其他特性请参考[API](https://lancet.go.dev/api/overview.html).

View File

@@ -0,0 +1,18 @@
---
outline: deep
---
# lancet是什么?
<b>lancet柳叶刀是一个强大、全面、高效、可复用的go语言工具函数库。lancet受到了java apache common包和lodash.js的启发。 </b>
## 为什么选择lancet?
Lancet 消除了处理并发、网络、数学、切片、字符串等的麻烦,使 Go 开发变得更容易。
Lancet 的实用方法非常适合:
- 迭代切片和数组。
- 操作字符串。
- 处理网络和http请求。
- 其他工具,例如。 随机、加密、流、重试等。

45
docs/index.md Normal file
View File

@@ -0,0 +1,45 @@
---
# https://vitepress.dev/reference/default-theme-home-page
layout: home
hero:
name: 'Lancet'
text: '一个强大的Go语言工具函数库'
tagline: '简洁, 强大, 高效'
actions:
- theme: brand
text: 开始使用
link: /guide/getting_started
- theme: alt
text: 在GitHub中查看
link: https://github.com/duke-git/lancet
image:
src: /lancet_logo.png
alt: lancet
features:
- title: 全面
icon: 💪
details: 特性丰富支持600+ go util函数。字符串、切片、日期时间、网络、加密、并发...
- title: 模块化设计
icon: 🏗
details: 每个模块设计成一个包,模块之间无耦合。
- title: 纯净
icon: 💅
details: 只依赖go标准库和golang.org/x。
- title: 简洁
icon: 👏
details: 结构良好,测试每个导出的函数。
---
<p style="position:relative; top: -316px;left: 540px;">
<img style="display: inline-block;margin-right:10px;" src="https://img.shields.io/github/stars/duke-git/lancet?style=social" alt="">
<img style="display: inline-block" src="https://img.shields.io/github/forks/duke-git/lancet?style=social" alt="">
<!-- [![](https://img.shields.io/github/stars/duke-git/lancet?style=social)](https://github.com/duke-git/lancet)
[![](https://img.shields.io/github/forks/duke-git/lancet?style=social)](https://github.com/duke-git/lancet) -->
</p>

BIN
docs/lancet_logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

BIN
docs/lancet_logo_mini.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.3 KiB

1277
docs/package-lock.json generated Normal file

File diff suppressed because it is too large Load Diff

13
docs/package.json Normal file
View File

@@ -0,0 +1,13 @@
{
"name": "lancet-docs",
"private": true,
"type": "module",
"scripts": {
"docs:dev": "vitepress dev",
"docs:build": "vitepress build",
"docs:preview": "vitepress preview"
},
"devDependencies": {
"vitepress": "^1.0.0-rc.4"
}
}

4
docs/styles/api_doc.css Normal file
View File

@@ -0,0 +1,4 @@
.run-container {
float: right;
display: inline-block;
}

View File

@@ -594,9 +594,11 @@ func WriteCsvFile(filepath string, records [][]string, append bool) error {
// WriteStringToFile write string to target file.
// Play: https://go.dev/play/p/GhLS6d8lH_g
func WriteStringToFile(filepath string, content string, append bool) error {
flag := os.O_RDWR | os.O_CREATE
var flag int
if append {
flag = flag | os.O_APPEND
flag = os.O_RDWR | os.O_CREATE | os.O_APPEND
} else {
flag = os.O_RDWR | os.O_CREATE | os.O_TRUNC
}
f, err := os.OpenFile(filepath, flag, 0644)

View File

@@ -393,9 +393,7 @@ func TestWriteStringToFile(t *testing.T) {
t.Fail()
}
defer file.Close()
err = WriteStringToFile(filepath, "hello", false)
err = WriteStringToFile(filepath, "hello world", false)
if err != nil {
t.Fail()
}
@@ -405,20 +403,32 @@ func TestWriteStringToFile(t *testing.T) {
t.Fail()
}
err = WriteStringToFile(filepath, "hello", false)
if err != nil {
t.Fail()
}
content2, err := ReadFileToString(filepath)
if err != nil {
t.Fail()
}
err = WriteStringToFile(filepath, " world", true)
if err != nil {
t.Fail()
}
content2, err := os.ReadFile(filepath)
content3, err := os.ReadFile(filepath)
if err != nil {
t.Fail()
}
assert.Equal("hello", content1)
assert.Equal("hello world", string(content2))
assert.Equal("hello world", content1)
assert.Equal("hello", content2)
assert.Equal("hello world", string(content3))
os.Remove(filepath)
_ = file.Close()
_ = os.Remove(filepath)
}
func TestWriteBytesToFile(t *testing.T) {

View File

@@ -343,7 +343,7 @@ func Log(n, base float64) float64 {
}
// Abs returns the absolute value of x.
// Play: todo
// Play: https://go.dev/play/p/fsyBh1Os-1d
func Abs[T constraints.Integer | constraints.Float](x T) T {
if x < 0 {
return (-x)