docs: bulk api docs (#5).

README.md

@@ -107,6 +107,25 @@ assert bloom3.contains('hello')
 
 ```
 
+there are some bulk api for python to reduce ffi cost between python and rust
+
+```python
+bloom = BloomFilter(100_000_000, 0.01)
+inserts = [1, 2, 3, 4, 5, 6, 7, 9, 18, 68, 90, 100]
+checks = [1, 2, 3, 4, 5, 6, 7, 9, 18, 68, 90, 100, 190, 290, 390]
+results = [True, True, True, True, True, True, True, True, True, True, True, True, False, False, False]
+
+bloom.add_int_batch(inserts)
+contains = bloom.contains_int_batch(checks)
+assert contains == results
+
+bloom.add_str_batch(list(map(lambda x: str(x), inserts)))
+assert bloom.contains_str_batch(list(map(lambda x: str(x), checks))) == results
+
+bloom.add_bytes_batch(list(map(lambda x: bytes(x), inserts)))
+assert bloom.contains_bytes_batch(list(map(lambda x: bytes(x), checks))) == results
+```
+
 more examples at [py_tests](py_tests/test_bloom.py).
 
 ### Rust

docs/README.zh_cn.md

@@ -104,6 +104,25 @@ assert bloom3.contains('hello')
 
 ```
 
+由于python与rust之间的数据转换有一定的性能开销，所以`fastbloom`提供了一些批量操作api用于减少ffi开销
+
+```python
+bloom = BloomFilter(100_000_000, 0.01)
+inserts = [1, 2, 3, 4, 5, 6, 7, 9, 18, 68, 90, 100]
+checks = [1, 2, 3, 4, 5, 6, 7, 9, 18, 68, 90, 100, 190, 290, 390]
+results = [True, True, True, True, True, True, True, True, True, True, True, True, False, False, False]
+
+bloom.add_int_batch(inserts)
+contains = bloom.contains_int_batch(checks)
+assert contains == results
+
+bloom.add_str_batch(list(map(lambda x: str(x), inserts)))
+assert bloom.contains_str_batch(list(map(lambda x: str(x), checks))) == results
+
+bloom.add_bytes_batch(list(map(lambda x: bytes(x), inserts)))
+assert bloom.contains_bytes_batch(list(map(lambda x: bytes(x), checks))) == results
+```
+
 更多例子参考 [py_tests](py_tests/test_bloom.py).
 
 ### Rust