diff --git a/docs/mathutil.md b/docs/mathutil.md index 5d44837..89fac08 100644 --- a/docs/mathutil.md +++ b/docs/mathutil.md @@ -33,6 +33,10 @@ import ( - [RadianToAngle](#RadianToAngle) - [PointDistance](#PointDistance) - [IsPrime](#IsPrime) +- [GCD](#GCD) +- [LCM](#LCM) +- [Cos](#Cos) +- [Sin](#Sin)
@@ -375,3 +379,167 @@ func main() { // true } ``` + +### GCD + +Return greatest common divisor (GCD) of integers.
+ +Signature: + +```go +func GCD(integers ...int) int +``` + +Example: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.GCD(1, 1) + result2 := mathutil.GCD(1, -1) + result3 := mathutil.GCD(-1, 1) + result4 := mathutil.GCD(-1, -1) + result5 := mathutil.GCD(3, 6, 9) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + + // Output: + // 1 + // 1 + // -1 + // -1 + // 3 +} +``` + +### LCM + +Return Least Common Multiple (LCM) of integers.
+ +Signature: + +```go +func LCM(integers ...int) int +``` + +Example: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.LCM(1, 1) + result2 := mathutil.LCM(1, 2) + result3 := mathutil.LCM(3, 6, 9) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + + // Output: + // 1 + // 2 + // 18 +} +``` + + +### Cos + +Returns the cosine of the radian argument.
+ +Signature: + +```go +func Cos(radian float64, precision ...int) float64 +``` + +Example: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.Cos(0) + result2 := mathutil.Cos(90) + result3 := mathutil.Cos(180) + result4 := mathutil.Cos(math.Pi) + result5 := mathutil.Cos(math.Pi / 2) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + + // Output: + // 1 + // -0.447 + // -0.598 + // -1 + // 0 +} +``` + + +### Sin + +Returns the sine of the radian argument.
+ +Signature: + +```go +func Sin(radian float64, precision ...int) float64 +``` + +Example: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.Sin(0) + result2 := mathutil.Sin(90) + result3 := mathutil.Sin(180) + result4 := mathutil.Sin(math.Pi) + result5 := mathutil.Sin(math.Pi / 2) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + + // Output: + // 0 + // 0.894 + // -0.801 + // 0 + // 1 +} +``` \ No newline at end of file diff --git a/docs/mathutil_zh-CN.md b/docs/mathutil_zh-CN.md index 7414a30..5c8800e 100644 --- a/docs/mathutil_zh-CN.md +++ b/docs/mathutil_zh-CN.md @@ -33,6 +33,10 @@ import ( - [RadianToAngle](#RadianToAngle) - [PointDistance](#PointDistance) - [IsPrime](#IsPrime) +- [GCD](#GCD) +- [LCM](#LCM) +- [Cos](#Cos) +- [Sin](#Sin) @@ -375,3 +379,168 @@ func main() { // true } ``` + + +### GCD + +计算整数最大公约数。
+ +函数签名: + +```go +func GCD(integers ...int) int +``` + +示例: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.GCD(1, 1) + result2 := mathutil.GCD(1, -1) + result3 := mathutil.GCD(-1, 1) + result4 := mathutil.GCD(-1, -1) + result5 := mathutil.GCD(3, 6, 9) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + + // Output: + // 1 + // 1 + // -1 + // -1 + // 3 +} +``` + +### LCM + +计算整数最小公倍数。
+ +函数签名: + +```go +func LCM(integers ...int) int +``` + +示例: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.LCM(1, 1) + result2 := mathutil.LCM(1, 2) + result3 := mathutil.LCM(3, 6, 9) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + + // Output: + // 1 + // 2 + // 18 +} +``` + + +### Cos + +计算弧度的余弦值。
+ +函数签名: + +```go +func Cos(radian float64, precision ...int) float64 +``` + +示例: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.Cos(0) + result2 := mathutil.Cos(90) + result3 := mathutil.Cos(180) + result4 := mathutil.Cos(math.Pi) + result5 := mathutil.Cos(math.Pi / 2) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + + // Output: + // 1 + // -0.447 + // -0.598 + // -1 + // 0 +} +``` + + +### Sin + +计算弧度的正弦值。
+ +函数签名: + +```go +func Sin(radian float64, precision ...int) float64 +``` + +示例: + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/mathutil" +) + +func main() { + result1 := mathutil.Sin(0) + result2 := mathutil.Sin(90) + result3 := mathutil.Sin(180) + result4 := mathutil.Sin(math.Pi) + result5 := mathutil.Sin(math.Pi / 2) + + fmt.Println(result1) + fmt.Println(result2) + fmt.Println(result3) + fmt.Println(result4) + fmt.Println(result5) + + // Output: + // 0 + // 0.894 + // -0.801 + // 0 + // 1 +} +``` \ No newline at end of file