Home

Awesome

QwertySearchLibrary

The library of QwertySearch,a Java Library Which provide data analysis methods, 
data matching method and so on for Qwerty pinyin search.

QwertySearch = PinyinSearch - T9Search

If you're looking for other versions search project, you can find all of them at the following links:

Java(Android): PinyinSearch T9Search QwertySearch

c plus plus(Qt): PinyinSearch

Features

Depend

The library of pinyin4j:

Pinyin4j is a popular Java library supporting convertion between Chinese characters 
and most popular Pinyin systems. The output format of pinyin could be customized.

original pinyin4j or light pinyin4j

Renderings

<img src="https://github.com/handsomezhou/QwertySearchLibrary/blob/master/external_res/image/QwertySearch.gif"/>

API

Data structure:PinyinUnit

PinyinUnit as a base data structure to save the string that Chinese characters  
converted to Pinyin characters.

Function:

public static void parse(PinyinSearchUnit pinyinSearchUnit);
public static boolean match(PinyinSearchUnit pinyinSearchUnit,String search);
public static String getSortKey(PinyinSearchUnit pinyinSearchUnit);
public static String getFirstLetter(PinyinSearchUnit pinyinSearchUnit);
public static String getFirstCharacter(PinyinSearchUnit pinyinSearchUnit);
public static boolean isChineseCharacter(char chr);

Function call:

PinyinUtil.parse(...);
QwertyUtil.match(...);
PinyinUtil.getSortKey(...);
PinyinUtil.getFirstLetter(...);
PinyinUtil.getFirstCharacter(...);
PinyinUtil.isChineseCharacter(...);

Usage

Function call in detail:

Import packages when use qwertySearch Library(Dependent on pinyin4j-x.x.x.jar):
import com.qwertysearch.util.*;
import com.qwertysearch.model.*;

The first step:  Data parsing  (ps:Must init baseData of PinyinSearchUnit before parse)
    * (PinyinUtil.parse(...))
The second step: Data matching 
    * (QwertyUtil.match(...))

For details, please see project QwertySearchDemo.

JAR download

qwertysearch.jar

original pinyin4j-2.5.0.jar Or light pinyin4j.jar(recommend)

Demo Apk

QwertySearchDemo

Algorithm introduction

1.Pinyin search contacts analysis and implementation

2.T9 search contacts analysis and implementation

3.Qwerty search contacts analysis and implementation

License

Copyright [handsomezhou] Qwerty search library,for Qwerty pinyin search.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0
	
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.