$Id: bindings.html 65 2007-01-30 00:52:53Z taku-ku $;
각종 스크립트 언어 (perl, ruby, python, Java) (으)로부터, MeCab 하지만 제공하는 형태소 해석의 기능을 이용 가능합니다. 각 바인딩은 SWIG 그렇다고 하는 프로그라 무를 이용해, 자동 생성되고 있습니다. SWIG 하지만 서포트하는 다른 언어도 생성 가능하다고 생각됩니다만, 현재는, 작자의 관리할 수 있는 범위내라고 하는 것으로, 상기의4 개의 언어만을 제공하고 있습니다.
각 언어 바이딘그의 인스톨 방법은, perl/README, ruby/README, python/README, java/README (을)를 봐 주세요.
MeCab::Tagger 그렇다고 하는 클래스의 인스턴스를 생성해, parse ( 혹은 parseToString) 그렇다고 하는 메소드를 부르는 것으로, 해석 결과가 문자열로서 취득할 수 있습니다. MeCab::Tagger 의 constructor 의 인수는, 기본적으로 mecab 의 실행 형식에게 주어 파라미터와 동일하고, 그것들을 문자열로서 줍니다.
use MeCab;
$m = new MeCab::Tagger ("-Ochasen");
print $m->parse ("
오늘도 하지 않으면");
require 'MeCab'
m = MeCab::Tagger.new ("-Ochasen")
print m.parse ("
오늘도 하지 않으면")
import sys
import MeCab
m = MeCab.Tagger ("-Ochasen")
print m.parse ("
오늘도 하지 않으면")
import org.chasen.mecab.Tagger;
import org.chasen.mecab.Node
public static void main(String[] argv) {
Tagger tagger = new Tagger ("-Ochasen");
System.out.println (tagger.parse ("
타로는 지로우에 이 책을 건네주었다."));
}
MeCab::Tagger 클래스의, parseToNode 그렇다고 한다 메소드를 부르는 것으로, 「문두」라고 하는 특별한 형태소가 MeCab::Node 클래스의 인스턴스로서 취득할 수 있습니다.
MeCab::Node 하, 쌍방향 리스트로서 표현되고 있어, next, prev 그렇다고 하는 멘 바 변수가 있습니다. 각각, 다음의 형태소, 전의 형태소를 MeCab::Node 클래스의 인스턴스로서 돌려줍니다. 전형태 순수하게는, next (을)를 차례차례 부르는 것으로 액세스 할 수 있습니다.
MeCab::Node 하 C 언어의 interface로 제공하고 있다 mecab_node_t (을)를 락 프 한 클래스입니다. mecab_node_t 하지만 가지는 거의 모든 멤버 변수에 액세스 일이 생깁니다. 다만, surface 마셔, 단어 그 자체가 돌아가도록(듯이) 변경해 있습니다.
이하에 perl 의 예를 나타냅니다. 이 예에서는, 각 형태소를 차례차례 액세스 해, 형태소의 표층 문자열, 품사, 그 형태소까지의 코스트를 표시합니다.
use MeCab;
my $m = new MeCab::Tagger ("");
for (my $n = $m->parseToNode ("
오늘도 하지 않으면"); $n ; $n = $n->{next}) {
printf ("%st%st%dn",
$n->{surface}, #
표층
$n->{feature}, #
현재의 품사
$n->{cost} #
그 형태소까지의 코스트
);
}
만약, constructor 이나, 해석 도중에 에러가 일어났을 경우는, RuntimeError 예외가 발생합니다. 예외의 핸들링의 방법은, 각 언어의 참조 설명서를 봐주세요. 이하는, python 의 예입니다
try:
m = MeCab.Tagger ("-d .")
print m.parse ("
오늘도 하지 않으면")
except RuntimeError, e:
print "RuntimeError:", e;
parseToNode 의 돌아가 값은, 「문두」라고 하는 특별한 형태소를 나타낸다 MeCab::Node 인탄스입니다. 한층 더, 「문말」이라고 하는 특별한 형태소도 존재하므로, 주의해 주세요. 만약, 이것들을 무시하고 싶은 경우는, 이하와 같이 next 그리고 각각을 읽어 날려 주세요.
my $n = $m->parseToNode ("
오늘도 하지 않으면");
$n = $n->{next}; #
「문두」를 무시
while ($n->{next}) { # next
(을)를 조사한다
printf ("%sn", $n->{surface});
$n = $n->{next}; #
다음에 이동
}
MeCab::Node 의 실체( 메모리상에 있는 형태소 정보) 하, MeCab::Tagger 인스턴스가 관리하고 있습니다. MeCab::Node 하, Node 의 실체를 가리키고 있다 참조 에 지나 선. 그 때문에(위해), parseToNode 하지만 불릴 때마다, 실체 그 자체가, 덧쓰기되어서 갑니다. 이하와 같은 예는 소스의 의도하는 대로는 움직이지 않습니다.
m = MeCab.Tagger ("")
n1 = m.parseToNode ("
오늘도 하지 않으면")
n2 = m.parseToNode ("
아삭아삭 벚꽃")
# n1
의 내용은 무효가 되어 있다
while (n1.hasNode () != 0):
print n1.getSurface ()
n1 = n1.next ()
상기의 예에서는, n1 (이)가 가리키는 내용이, 「아삭아삭 벚꽃」을 해석한 시점에서 덧쓰기되고 있어, 사용할 수 없게 되고 있습니다.
복수의 Node (을)를 동시에 액세스 하고 싶은 경우는, 복수의 MeCab::Tagger 인스턴스를 생성해 주세요.
이하에, SWIG 용무의 인터페이스 파일 의 일부를 나타냅니다. 바이딘그의 실장 언어의 형편상, C++ 의 문장구조법으로 표기되고 있습니다만, 적당 읽기나 라고 주세요. 또, 각 메소드의 동작도 더해져라 (이)라고 있기 때문에 참고로 해 주세요.
namespace MeCab {
class Tagger {
// str
(을)를 해석해 문자열로서 결과를 얻습니다. len
하 str
의 길이(
생략 가능)
string parse(string str, int len);
// parse
(와)과 같다
string parseToString(string str, int len);
// str
(을)를 해석해 MeCab::Node
형태의 형태소를 돌려줍니다.
//
이 형태소는 문두를 나타내는 것으로, next
(을)를 순서에 더듬는 것으로 전형태 순수하게 액세스 할 수 있습니다
Node parseToNode(string str, int len);
// parse
의 Nbest
판입니다. N
에 nbest
의 개수를 지정합니다.
//
이 기능을 사용하는 경우는,
기동시 옵션으로서 -l 1
(을)를 지정할 필요가 있습니다
string parseNBest(int N, string str, int len);
//
해석 결과를,
확실한 것 같은 것으로부터 차례로 취득하는 경우에 이 함수로 초기화를 실시합니다.
bool parseNBestInit(string str, int len);
// parseNbestInit()
의 후,
이 함수를 차례차례 부르는 것으로,
확실한 것 같은 해석 결과를,
차례로 취득할 수 있습니다.
string next();
// next()
(와)과 같습니다만, MeCab::Node
(을)를 돌려줍니다.
Node nextNode();
};
#define MECAB_NOR_NODE 0
#define MECAB_UNK_NODE 1
#define MECAB_BOS_NODE 2
#define MECAB_EOS_NODE 3
struct Node {
struct Node prev; //
하나전의 형태소에의 포인터
struct Node next; //
하나처의 형태소에의 포인터
struct Node enext; //
같은 위치에서 끝나는 형태소에의 포인터
struct Node bnext; //
같은 개시 위치에서 시작되는 형태소에의 포인터
string surface; //
형태소의 문자열 정보
string feature; // CSV
그리고 표기된 태생 정보
unsigned int length; //
형태소의 길이
unsigned int rlength; //
형태소의 길이(
선두의 스페이스를 포함한다)
unsigned int id; //
형태소에 부여된다
유니크ID
unsigned short rcAttr; //
우문맥 id
unsigned short lcAttr; //
왼쪽 문맥 id
unsigned short posid; //
형태소 ID (
미사용)
unsigned char char_type; //
문자종 정보
unsigned char stat; //
형태소의 종류:
이하의 매크로의 값
// #define MECAB_NOR_NODE 0
// #define MECAB_UNK_NODE 1
// #define MECAB_BOS_NODE 2
// #define MECAB_EOS_NODE 3
unsigned char isbest; //
베스트해의 경우 1,
그 이외 0
float alpha; // forward backward
의 foward log
확률
float beta; // forward backward
의 backward log
확률
float prob; //
주변 확률
// alpha, beta, prob
하 -l 2
옵션을 지정했을 때에 정의됩니다
short wcost; //
단어 발생 코스트
long cost; //
누적 코스트
};
}
perl/test.pl, ruby/test.rb, python/test.py, java/test.java 에 각각의 언어의 샘플이 있기 때문에, 참고로 해 주세요.
$Id: bindings.html 65 2007-01-30 00:52:53Z taku-ku $;