1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
# Overview
'finbin' is a java library for finding the specified sequence of bytes from the big-size sequence of bytes.
You can find out quickly from the big size (like mega-bytes binary) of the binary data.
It is licensed under [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0).
[](https://maven-badges.herokuapp.com/maven-central/org.riversun/finbin)
## you want to search byte[] from a BIG file?
Check this.You can search sequence of bytes from gigabyte-order file with low memory consumption.
https://github.com/riversun/bigdoc
# classes & methods
## BigBinarySearcher class
- public List<Integer> searchBigBytes(byte[] srcBytes, byte[] searchBytes)
- For big byte array binary data, search bytes faster in a concurrent processing.
- and derivation of the method
## Example for big bytes(Multi-Threaded)
### search for a sequence of bytes by using *searchBigBytes*
If you want to search an array of bytes of mega-bytes order of size,try to use *searchBigBytes*.
```java
package org.example;
import java.util.List;
import org.riversun.finbin.BigBinarySearcher;
public class Example {
public static void main(String[] args) throws Exception {
BigBinarySearcher bbs = new BigBinarySearcher();
// UTF-8 without BOM
byte[] iamBigSrcBytes = "Hello world.It's a small world.".getBytes("utf-8");
byte[] searchBytes = "world".getBytes("utf-8");
List<Integer> indexList = bbs.searchBigBytes(iamBigSrcBytes, searchBytes);
System.out.println("indexList=" + indexList);
}
}
```
## BinarySearcher class
- public int indexOf(byte[] srcBytes, byte[] searchBytes)
- For small byte array binary data, Returns the index within this byte-array of the first occurrence of the specified(search bytes) byte array.
- public List searchBytes(byte[] srcBytes, byte[] searchBytes)
- For small byte array binary data, Search bytes in byte array returns indexes within this byte-array of all occurrences of the specified(search bytes) byte array.
- and derivation of the method
-----
## Examples for small bytes(Single-Threaded)
### search for a sequence of bytes by using *indexOf*
```java
package org.example;
import org.riversun.finbin.BinarySearcher;
public class Example1 {
public static void main(String[] args) throws Exception {
BinarySearcher bs = new BinarySearcher();
// UTF-8 without BOM
byte[] srcBytes = "Hello world.It's a small world.".getBytes("utf-8");
byte[] searchBytes = "world".getBytes("utf-8");
int index = bs.indexOf(srcBytes, searchBytes);
System.out.println("index=" + index);
}
}
```
1. srcBytes is
```
0x48,0x65,0x6C,0x6C,0x6F,0x20,0x77,0x6F,0x72,0x6C,0x64,0x2E,0x49,0x74,0x27,0x73,0x20,0x61,0x20,0x73,0x6D,0x61,0x6C,0x6C,0x20,0x77,0x6F,0x72,0x6C,0x64,0x2E
```
2. searchBytes is
```
0x77,0x6F,0x72,0x6C,0x64
```
so it results in
```
index=6
```
### search for a sequence of bytes by using *searchBytes*
```java
package org.example;
import java.util.List;
import org.riversun.finbin.BinarySearcher;
public class Example2 {
public static void main(String[] args) throws Exception {
BinarySearcher bs = new BinarySearcher();
// UTF-8 without BOM
byte[] srcBytes = "Hello world.It's a small world.".getBytes("utf-8");
byte[] searchBytes = "world".getBytes("utf-8");
List<Integer> indexList = bs.searchBytes(srcBytes, searchBytes);
System.out.println("indexList=" + indexList);
}
}
```
so it results in
```
indexList=[6, 25]
```
- Please note
The result is different depending on the environment of the Java ,Java version and compiler or runtime optimization.
# More Details
See javadoc as follows.
https://riversun.github.io/javadoc/finbin/
#Downloads
## maven
- You can add dependencies to maven pom.xml file.
```xml
<dependency>
<groupId>org.riversun</groupId>
<artifactId>finbin</artifactId>
<version>0.6.2</version>
</dependency>
```
|
