Java、巴拿马项目以及如何处理 Hunspell“建议”结果

我正在尝试Hunspell https://github.com/hunspell/hunspell以及如何使用它与之交互巴拿马 Java 项目 https://jdk.java.net/panama/（构建 19-巴拿马+1-13（2022 年 1 月 18 日））。我能够完成一些初步测试，例如创建一个handle to Hunspell然后用它来执行拼写检查。我现在正在尝试更复杂的事情，让 Hunspell 给我suggestions对于字典中没有的单词。这是我现在的代码：

public class HelloHun {
    public static void main(String[] args) {
        MemoryAddress hunspellHandle = null;
        try (ResourceScope scope = ResourceScope.newConfinedScope()) {
            var allocator = SegmentAllocator.nativeAllocator(scope);

            // Point it to US english dictionary and (so called) affix file
            // Note #1: it is possible to add words to the dictionary if you like
            // Note #2: it is possible to have separate/individual dictionaries and affix files (e.g. per user/doc type)
            var en_US_aff = allocator.allocateUtf8String("/usr/share/hunspell/en_US.aff");
            var en_US_dic = allocator.allocateUtf8String("/usr/share/hunspell/en_US.dic");

            // Get a handle to the Hunspell shared library and load up the dictionary and affix
            hunspellHandle = Hunspell_create(en_US_aff, en_US_dic);

            // Feed it a wrong word
            var javaWord = "koing";

            // Do a simple spell check of the word
            var word = allocator.allocateUtf8String(javaWord);
            var spellingResult = Hunspell_spell(hunspellHandle, word);
            System.out.println(String.format("%s is spelled %s", javaWord, (spellingResult == 0 ? "incorrect" : "correct")));

            // Hunspell also supports giving suggestions for a word - which is what we do next
            // Note #3: by testing this `koing` word in isolation - we know that there are 4 alternatives for this word
            // Note #4: I'm still investigating how to access individual suggestions

            var suggestions = allocator.allocate(10);
            var suggestionCount = Hunspell_suggest(hunspellHandle, suggestions, word);

            System.out.println(String.format("There are %d suggestions for %s", suggestionCount, javaWord));

            // `suggestions` - according to the hunspell API - is a `pointer to an array of strings pointer`
            // we know how many `strings` pointer there are, as that is the returned value from `suggest`
            // Question: how to process `suggestions` to get individual suggestions


        } finally {
            if (hunspellHandle != null) {
                Hunspell_destroy(hunspellHandle);
            }
        }
    }
}

我看到的是一个电话Hunspell_suggest（创建于jextract）成功并给我返回（4）条建议（我从命令行使用 Hunspell 进行了验证） - 所以没有问题。

现在对我来说更具挑战性的是如何拆包suggestions从这个调用返回的元素？我一直在查看各种示例，但它们似乎都没有深入到这种程度的细节（即使我找到了示例，它们似乎正在使用过时的巴拿马 API）。

所以本质上，这是我的问题：

我如何解压据报道由以下内容组成的结构指向字符串数组的指针使用巴拿马 JDK19 API 来获取各自的字符串集合？

看这里的标题：https://github.com/hunspell/hunspell/blob/master/src/hunspell/hunspell.h#L80 https://github.com/hunspell/hunspell/blob/master/src/hunspell/hunspell.h#L80

/* suggest(suggestions, word) - search suggestions
 * input: pointer to an array of strings pointer and the (bad) word
 *   array of strings pointer (here *slst) may not be initialized
 * output: number of suggestions in string array, and suggestions in
 *   a newly allocated array of strings (*slts will be NULL when number
 *   of suggestion equals 0.)
 */
LIBHUNSPELL_DLL_EXPORTED int Hunspell_suggest(Hunhandle* pHunspell,
                                              char*** slst,
                                              const char* word);

The slst是一个经典的“out”参数。即我们传递一个指向某个值的指针（在本例中是一个char**即字符串数组），并且该函数将为我们设置此指针，作为返回多个结果的一种方式。 （第一个结果是建议数）

在巴拿马中，您可以通过分配一个具有参数指针类型布局的段来使用“out”参数。在这种情况下char***是一个指向char**，所以布局是ADDRESS。然后，我们将创建的段传递给函数，最后在函数调用后检索/使用该段中的值，该值将填充段内容：

// char***
var suggestionsRef = allocator.allocate(ValueLayout.ADDRESS); // allocate space for an address
var suggestionCount = Hunspell_suggest(hunspellHandle, suggestionsRef, word);
// char** (the value set by the function)
MemoryAddress suggestions = suggestionsRef.get(ValueLayout.ADDRESS, 0);

之后，您可以迭代字符串数组：

for (int i = 0; i < suggestionCount; i++) {
    // char* (an element in the array)
    MemoryAddress suggestion = suggestions.getAtIndex(ValueLayout.ADDRESS, i);
    // read the string
    String javaSuggestion = suggestion.getUtf8String(suggestion, 0);
}