HotXLS ドキュメント

テキストと統計の配列引数

テキスト系と統計系のコレクタは、型付き行優先オペランド ウォーカーを通じて、対応する計算配列、通常の参照、定義名を受け付けます。スカラー引数は各関数のネイティブ型変換規則を保ちます

テキストの組み立て

Sheet.Cells[1, 1].Formula := 'TEXTJOIN(",",TRUE,SEQUENCE(3))';
Sheet.Cells[2, 1].Formula := 'CONCAT(SEQUENCE(2,2))';

TEXTJOIN と CONCAT は、行優先順で計算配列と対応参照を走査し、ネストと型付き値を保持し、遭遇したエラーを普通のテキストに変換せず伝搬します

TEXTJOIN は区切り文字と空無視オプションを完全なシーケンスに適用します。省略された値と空白値も同じオプション契約に従い、結果は 32767 文字に制限されたままです

Classic BIFF の数式契約は別物です。CONCAT は BIFF ネイティブの関数ではなく、対応する Classic 統計 CSE 数式は引き続き利用できます

統計の組み立て

Sheet.Cells[3, 1].Formula := 'MEDIAN(SEQUENCE(4))';
Sheet.Cells[4, 1].Formula := 'PERCENTILE.EXC(SEQUENCE(5),0.5)';
Sheet.Cells[5, 1].Formula := 'COVARIANCE.P(SEQUENCE(3),SEQUENCE(3)*2)';

対応する値配列の利用側には、MEDIAN、LARGE、SMALL、PERCENTILE.INC、PERCENTILE.EXC、QUARTILE.INC、QUARTILE.EXC、PERCENTRANK.INC、PERCENTRANK.EXC、MODE.MULT、COVARIANCE.P があり、対応する旧式の percentile・quartile・percent-rank エイリアスも含まれます

数値コレクタは、ネイティブ関数が無視する場所では、配列や参照の中の Boolean とテキストの要素を無視します。直接渡された Boolean や数値テキストのスカラーは異なる型変換規則に従うことがあり、MODE.MULT は直接スカラー引数でもテキストと Boolean 値を無視します

COVARIANCE.P はオペランドを元の位置でペアにし、両方の値が数値のときだけその位置を含めます。各オペランドを独立に圧縮すると、無関係な要素がペアになり、誤った結果になります

LARGE は対応する小数の順位を切り上げ、SMALL は切り捨てます。1 未満の順位は #NUM! で拒否され、対応する最小・最大順位に等しい percentile-exclusive の端点は有効のままです

偶数個の MEDIAN は、有限入力に対する同符号合計のオーバーフローを避けます。極端に対立する値は、無効な浮動小数点結果を生み出す代わりに、検証済みネイティブの数値誤差動作を保持します

参照を要求する関数

RANK、RANK.EQ、RANK.AVG は参照引数に実際の参照のセマンティクスを保ちます。対応する参照を生み出す INDEX 式も含まれます

リテラルや計算された値配列がその引数に代用されることはなく、SEQUENCE に評価される定義名は値配列のままで、範囲参照にはなりません

名前、依存関係の変化、スピル

絶対的な定義名ソースとネストした計算名は、ソース依存を追跡し、伸縮し、対応する保存/再オープンのサイクルを越えて残ります。相対参照は利用側の位置ごとに解決されるため、名前が 1 つの固定ソース セルを保つ必要があるときは絶対参照を使ってください

Numbers = SEQUENCE(Arrays!$A$1)

MODE.MULT は通常のスピル伸縮、妨げ、再オープンの動作を保ちます。対応する Classic CSE 統計数式は固定出力の契約を保ちます

リソース上限と境界

オペランドの走査、数値の収集、並べ替え、結果の構築は、アクティブな計算ステップ予算と FormulaArrayMemoryLimit を守ります。リソース枯渇は既存の計算診断契約に従います

これらのコレクタが、すべての関数を値配列の利用側に変えたり、保存形式の数式能力を変えたり、既存の未対応外部参照やスピルの境界を緩めたりすることはありません