IWordBreaker：：BreakText 方法 (indexsrv.h)

剖析文字以識別單字和片語，並將結果提供給 IWordSink 和 IPhraseSink 物件。

語法

HRESULT BreakText(
  [in] TEXT_SOURCE *pTextSource,
  [in] IWordSink   *pWordSink,
  [in] IPhraseSink *pPhraseSink
);

[in] pTextSource

包含 Unicode 文字之TEXT_SOURCE 結構的指標。

[in] pWordSink

類型： IWordSink*

IWordSink物件的指標，該物件會接收及處理這個方法所產生的單字。 Null 表示這個方法應該只識別片語。

[in] pPhraseSink

類型： IPhraseSink*

IPhraseSink物件的指標，該物件會接收及處理這個方法所產生的片語。 Null 表示這個方法應該識別個別字組，而不是片語。

類型： HRESULT

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	作業已順利完成。沒有其他文字可供重新填入 pTextSource 緩衝區。
E_INVALIDARG	無效引數。 pTextSource參數為Null。

因為斷詞工具較常剖析片語，所以您應該針對 pPhraseSink = 0 優化。 pWordSink或pPhraseSink可以是Null，但不能同時為兩者。

IWordSink物件會保存斷詞工具的文字及其替代形式。如果有的話，替代形式的文字會先放在 IWordSink 物件中，方法是使用 WordSink：:P utAltWord 方法，並使用 WordSink：:P utWord 方法新增根字。

使用 pfnFillTextBuffer，這是 TEXT_SOURCE 結構中的函式指標元素，以補充來源文字。 IWordBreaker：：BreakText方法必須處理所有pfnFillTextBuffer 傳回值。如果發生錯誤，請先完成處理緩衝區中的文字，再處理錯誤。