The biggest difficulty I see is that neither the purpose of the function nor the behavior of its parameters is explained. As someone who has used Calc for a long time I can imagine how the function probably works, though I'd need to examine the program or run tests to know for sure. Many people will not be interested in or capable of doing that.Now I'm requesting your comments on the code (calcTextsplit only) and the explanations contained in the attachment together with a few usage examples.
Just as an example let's consider the first parameter pColDelim:
• Is this parameter a delimiter string or a set of single delimiter characters?
• Does it accept an array of delimiters?
• Is it affected by option Calc → Calculate → Enable regular expressions in formulas?
• If the parameter is the empty string, does that mean function will separate each letter in the row?
I'm not looking for answers, just suggesting a few of the details that your function documentation should cover. I think people won't be much interested in an undocumented function, even though it's useful. You do provide examples, but I would want actual documentation, since it is difficult to get that information just from examples. I am happy to offer to review English-language documentation, as I know that English is not your first language (though most people would not suspect that).
Statistics: Posted by MrProgrammer — Tue Oct 08, 2024 6:39 pm