mirror
/
ants
mirror of https://github.com/panjf2000/ants.git
1
0
Fork 1
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'develop'

This commit is contained in:
andy pan 2018-05-21 12:45:26 +08:00
parent a6b0c47b0d 117d89e42b
commit 67b7e281dc
1 changed files with 12 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
README.md
View File

@ -32,7 +32,6 @@ glide get github.com/panjf2000/ants
``` ```
## How to use ## How to use
If your program will generate a massive number of goroutines and you don't want them to consume a vast amount of memory, with ants, all you need to do is to import ants package and submit all your tasks to the default limited pool created when ants was imported: If your program will generate a massive number of goroutines and you don't want them to consume a vast amount of memory, with ants, all you need to do is to import ants package and submit all your tasks to the default limited pool created when ants was imported:
``` go ``` go
@ -65,15 +64,23 @@ func main() {
``` ```
And ants also supports the custom limited pool. You can use the `NewPool` method to generate a pool with the given capacity, as following: ## Submit tasks
Tasks can be submitted by calling `ants.Push(func())`
```go
ants.Push(func() {})
```
## Custom limited pool
Ants also supports the custom limited pool. You can use the `NewPool` method to generate a pool with the given capacity, as following:
``` go ``` go
// set 10000 the size of goroutine pool // set 10000 the size of goroutine pool
p, _ := ants.NewPool(10000) p, _ := ants.NewPool(10000)
// submit a task
p.Push(func() {})
``` ```
## Readjusting pool capacity ## Readjusting pool capacity
You can change ants pool capacity at any time with `ReSize(int)`: You can change ants pool capacity at any time with `ReSize(int)`:
``` go ``` go
@ -84,11 +91,9 @@ pool.ReSize(100000) // Readjust its capacity to 100000
Don't worry about the synchronous problems in this case, this method is thread-safe. Don't worry about the synchronous problems in this case, this method is thread-safe.
## About sequence ## About sequence
All the tasks submitted to ants pool will not be guaranteed to be processed in order, because those tasks distribute among a series of concurrent workers, thus those tasks are processed concurrently. All the tasks submitted to ants pool will not be guaranteed to be processed in order, because those tasks distribute among a series of concurrent workers, thus those tasks are processed concurrently.
## Benchmarks ## Benchmarks
<div align="center"><img src="https://github.com/panjf2000/ants/blob/master/ants_benchmarks.png"/></div> <div align="center"><img src="https://github.com/panjf2000/ants/blob/master/ants_benchmarks.png"/></div>
In that benchmark-picture, the first and second benchmarks performed test with 100w tasks and the rest of benchmarks performed test with 1000w tasks, both unlimited goroutines and ants pool, and the capacity of this ants goroutine-pool was limited to 5w. In that benchmark-picture, the first and second benchmarks performed test with 100w tasks and the rest of benchmarks performed test with 1000w tasks, both unlimited goroutines and ants pool, and the capacity of this ants goroutine-pool was limited to 5w.