{"id":22493343,"url":"https://github.com/ufcpp/linqtoarray","last_synced_at":"2025-10-15T04:53:40.110Z","repository":{"id":77043218,"uuid":"104624620","full_name":"ufcpp/LinqToArray","owner":"ufcpp","description":"Optimized subset of LINQ operators dedicated to arrays","archived":false,"fork":false,"pushed_at":"2022-07-05T11:22:54.000Z","size":25,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-14T08:39:49.209Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ufcpp.png","metadata":{"files":{"readme":"readme.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-24T06:44:03.000Z","updated_at":"2024-09-05T13:11:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"9a9bdaa6-8230-45cf-96ca-e26380f759a5","html_url":"https://github.com/ufcpp/LinqToArray","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ufcpp/LinqToArray","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufcpp%2FLinqToArray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufcpp%2FLinqToArray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufcpp%2FLinqToArray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufcpp%2FLinqToArray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ufcpp","download_url":"https://codeload.github.com/ufcpp/LinqToArray/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufcpp%2FLinqToArray/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279050586,"owners_count":26093532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-15T02:00:07.814Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-06T18:39:01.159Z","updated_at":"2025-10-15T04:53:40.094Z","avatar_url":"https://github.com/ufcpp.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 配列専用 LINQ\r\n\r\n## 背景\r\n\r\nふと、社内のコードを見ていると、LINQ を使っている場面の8割くらいは配列を引数にとって、即座に`ToArray`して配列で返していた。\r\n`System.Enumerable`ほどの汎用性は要らないので、その配列→配列の状況に最適化したLINQが欲しくなった。\r\n\r\nそこで、以下のような前提で、LINQ 演算子のいくつかを最適化実装したものを作る。\r\n\r\n- 配列専用にする\r\n- パイプライン\u003csup\u003e※1\u003c/sup\u003eを想定しない\r\n- 長さが、あるいは、少なくとも長さの上限\u003csup\u003e※2\u003c/sup\u003eが既知\r\n- 長さが短い\u003csup\u003e※3\u003c/sup\u003e\r\n\r\n(ものすごい制限が強い割には、高速化の割合は数割～(ごくごく一部)5倍程度なので、有用かどうか…)\r\n\r\n\u003csup\u003e※1\u003c/sup\u003e \r\n`Select().Where.Select().OrderBy()...` みたいな多段クエリのこと。\r\n戻り値を最初から配列にすることでオーバーヘッドを減らしているものの、\r\n1段1段配列を作られるとむしろ大幅に遅くなる。\r\n\r\n\u003csup\u003e※2\u003c/sup\u003e\r\n例えば`Where`や`Distinct`の場合、結果の長さはわからないものの、\r\n操作前の配列の長さを超えることは絶対にないので、\r\n「長さの最大値」であれば既知になる。\r\n\r\n\u003csup\u003e※3\u003c/sup\u003e\r\nこれは一時バッファーを`stackalloc`で確保するために必要な制限。\r\n大きなサイズで`stackalloc`しようとすると簡単にスタックオーバーフローする。\r\n`Span\u003cT\u003e buffer = len \u003c 1024 ? (Span\u003cT\u003e)stackalloc T[len] : (Span\u003cT\u003e)new T[len]`みたいな書き方をすればこの問題は回避可能。\r\n\r\n## 最適化手法\r\n\r\n### 配列専用化\r\n\r\n一般には、`foreach` ステートメントは以下のように展開される。\r\n\r\n元:\r\n\r\n```cs\r\nforeach (var x in data)\r\n{\r\n}\r\n```\r\n\r\n一般の展開結果:\r\n\r\n```cs\r\n{\r\n    var e = data.GetEnumerator();\r\n    try\r\n    {\r\n        while (e.MoveNext())\r\n        {\r\n            var x = e.Current;\r\n        }\r\n    }\r\n    finally\r\n    {\r\n        ((IDisposable)e).Dispose();\r\n    }\r\n}\r\n```\r\n\r\nそれが、配列の場合は以下のように、単なる`for`ステートメントに展開される。\r\n\r\n配列の展開結果:\r\n\r\n```cs\r\nfor (int i = 0; i \u003c data.Length; i++)\r\n{\r\n    var x = data[i];\r\n}\r\n```\r\n\r\nその結果、`IEnumerable\u003cT\u003e`などを経由せず、配列専用に作ることで数割程度高速になる。\r\n後述するが、`IEnumerator`の発生と、配列の範囲チェックという2つのコストが消える。\r\n\r\n#### 制限\r\n\r\nこの最適化のためには本当に配列専用でなければならない。\r\n\r\n(他の最適化では、「長さが既知であればいい」程度の制限なので、\r\n`IList`や、あるいは、`IEnumerable`とセットで長さを渡すなどでも実現できる。)\r\n\r\nかといって、「`List\u003cT\u003e`で渡ってきたデータを一度`ToArray`してから渡す」とかはかなり高コスト。この最適化のためには最初から配列でデータが渡ってくることが必須で、かなり用途が限られる。\r\n\r\n#### (補足)`IEnumerator`の発生\r\n\r\n`foreach`ステートメントの「一般の展開結果」では、\r\n`GetEnumerator`を経由することで`IEnumerator`のインスタンスが作られる。\r\n\r\n`List\u003cT\u003e`などでは、`GetEnumerator`が返す型を`List\u003cT\u003e`専用の構造体にすることでこのコストを回避していたりするが、これも、`IEnumerable\u003cT\u003e`インターフェイスを介して呼び出すとボックス化が起きてしまって、結局ヒープ確保が発生する。\r\n\r\nただし、1回の列挙につき1個のほんの小さなインスタンスができるだけなので、大したコストではない。\r\n\r\n#### (補足)配列の範囲チェック\r\n\r\n通常、配列 `a` に対してインデックスアクセスすると、\r\nそのJITコンパイル結果には範囲チェックが挿入される。\r\n配列の長さを越えて読み書き(バッファーオーバーラン脆弱性の原因)を起こさないようにするためなので、欠かすことはできないが、そこそこのコストになる。\r\n\r\nところが、以下のような`for`ステートメントを書く場合、`for`の条件式自体が範囲チェックになっているため、`x[i]`の個所に挟まるはずの範囲チェックはなくすような最適化がかかる。\r\n\r\n```cs\r\nfor (int i = 0; i \u003c a.Length; i++)\r\n{\r\n    var x = a[i];\r\n}\r\n```\r\n\r\n同じような`for`ステートメントを書いても、`IList\u003cT\u003e`や`IReadOnlyList\u003cT\u003e`経由ではここまでの最適化は掛からない。\r\n\r\n### 長さを既知にする\r\n\r\n一般の(長さが未知の)`IEnumerable\u003cT\u003e`に対して`ToArray`を行おうとすると、`List\u003cT\u003e`が内部でやっているのと同じような「足りなくなったらバッファー用の配列を確保しなおす」というような処理が必要になる。\r\n\r\nこれに対して、長さが既知なら、最初に1個だけ、所望の長さの配列を確保して、そこにデータをコピーしていけばいいのでかなり負担が少ない。\r\n\r\n#### 制限\r\n\r\n長さが既知であればいいので、`IList\u003cT\u003e`なども使える。\r\nそれでも、一般の`IEnumerable\u003cT\u003e`に対して使えないのはそこそこ不便な制限になる。\r\n\r\n### ハッシュテーブルの専用実装化\r\n\r\n`Distinct`や`GroupBy`などの実装には、内部的にハッシュテーブルを使うことになる。\r\n\r\n.NET でハッシュテーブルというと、`Dictionary\u003cTKey, TValue\u003e`や`HashSet\u003cT\u003e`だが、\r\nこれら標準のものを使うよりも最適化できるポイントがいくつかある。\r\n\r\n- `Distinct`などの内部で使う場合、`Remove`は考えなくていい\r\n  - `Remove`が不要であれば、ハッシュテーブルの実装はかなりシンプルになる\r\n- 長さが既知であれば、バッファーの作り直しが必要ない\r\n  - ハッシュテーブル内のバッファーの作り直しは結構負担が大きいので、これがなくなると結構速くなる\r\n\r\n#### 制限\r\n\r\n「`Remove`は考えなくていい」だけであれば特に制限は掛からない。\r\nたぶん、標準ライブラリの`System.Linq.Enumerable`の`Distinct`の実装ももっと速くできると思う。\r\n\r\n「長さが既知」の制限は前節参照。\r\n\r\n### 一時バッファーの`stackalloc`化\r\n\r\n前節のハッシュテーブル等は、メソッド内でしか使わない一時バッファーになる。\r\n\r\nこういう寿命がはっきりしているものに対してmanagedヒープを使うのはもったいないので、\r\nスタック上に一時バッファーを確保したい。\r\n幸い、C#では、条件さえ満たせば`stackalloc`という構文を使ってスタック上に一時バッファーを確保できる。\r\n\r\n#### 制限\r\n\r\n`stackalloc`の性質上、以下の制限が掛かる\r\n\r\n- あまり大きなサイズで確保できない\r\n  - スタックオーバーフローが簡単に起きる\r\n  - corefx や coreclr 内を見ている感じでは、せいぜい1Kバイト程度までしか`stackalloc`を使っていない\r\n- `yield return`をまたげない\r\n  - 「配列→配列」だからこそ使えるのであって、`IEnumerable\u003cT\u003e`を返すような作りには使えない\r\n\r\nただし、これらの制限は、以下のような「`stackalloc`と配列の分岐」を行えば回避できる。\r\n\r\n```cs\r\nSpan\u003cT\u003e buffer = len \u003c 1024 ? (Span\u003cT\u003e)stackalloc T[len] : (Span\u003cT\u003e)new T[len]\r\n```\r\n\r\n### 値型ジェネリクス(`EqualityComparer`のインライン化)\r\n\r\nハッシュテーブル内では、キーのハッシュ値取得や等値判定のために`IEqualityComparer\u003cT\u003e`が必要になる。\r\n\r\nここで、例えば以下のようなcomparerがあったとする。\r\n\r\n```cs\r\npublic struct StructEquatableComparer\u003cT\u003e : IEqualityComparer\u003cT\u003e\r\n    where T : IEquatable\u003cT\u003e\r\n{\r\n    public bool Equals(T x, T y) =\u003e x.Equals(y);\r\n    public int GetHashCode(T obj) =\u003e obj.GetHashCode();\r\n}\r\n```\r\n\r\nこれに対して、まず、普通に以下のような呼び方をする。\r\n\r\n```cs\r\npublic class HashSet\u003cT\u003e\r\n{\r\n    IEqualityComparer\u003cT\u003e _comparer;\r\n\r\n    public bool Contains(T key)\r\n    {\r\n        ...\r\n        if (_comparer.Equals(key, bucket.Key))\r\n        ...\r\n    }\r\n}\r\n```\r\n\r\nこの場合、以下のようなコストがかかる。\r\n\r\n- `_comparer` にインスタンスを持つコスト\r\n  - `Dictionary`のサイズが増える\r\n    - 元々フィールドが多い型であれば微々たるコスト増加なものの\r\n    - 「`Distinct`用の`HashSet`」の場合、フィールドは配列ただ1つで済むので、たった1フィールド増えるだけでもサイズが倍\r\n  - `StructEquatableComparer`は構造体なので、インターフェイスを介するとボックス化する\r\n- インターフェイスのメンバーの仮想呼び出し\r\n  - この書き方だと仮想呼び出しになるので、インライン化されない\r\n  - `int`等のように、`Equals`の中身が単純なものの場合、インライン化の有無でパフォーマンスが劇的に変わる\r\n\r\nそこで、以下のような実装を考える。\r\n\r\n```cs\r\npublic class HashSet\u003cT, TComparer\u003e\r\n    TComparer : struct, IEqualityComparer\u003cT\u003e\r\n{\r\n    public bool Contains(T key)\r\n    {\r\n        ...\r\n        if (default(TComparer).Equals(key, bucket.Key))\r\n        ...\r\n    }\r\n}\r\n```\r\n\r\n.NETのジェネリクスでは、ジェネリック型引数が構造体の場合、型ごとに展開されて、仮想呼び出しが消えるような最適化が掛かる。\r\nインライン化も掛かるようになるため、`int`等に対する`default(TComparer).Equals`呼び出しは劇的に速くなる。\r\n\r\n#### 制限\r\n\r\n他の最適化と違って、この最適化は引数・戻り値に対しての制限が一切かからない。\r\n配列でなくてもいいし、長さは未知でも、`yield return`を使っても構わない。\r\n\r\nただ、型の書き方がかなり面倒になる。\r\n例えば、通常の`HashSet`であれば`HashSet\u003cstring\u003e`と書けるのに対して、\r\n値型ジェネリクスを使ったものは`HashSet\u003cstring, StructEquatableComparer\u003cstring\u003e\u003e`と書かなくてはならず、かなり煩雑になる。\r\n\r\nまた、ジェネリック型引数の型推論も効きにくくなる。\r\n例えば`Distinct`であれば、`System.Linq.Enumerable`のものは`source.Distinct()`だけでいいのに対して、\r\n値型ジェネリクスを使ったものは`source.Distinct\u003cstring, StructEquatableComparer\u003cstring\u003e\u003e()`と書かなくてはならない。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fufcpp%2Flinqtoarray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fufcpp%2Flinqtoarray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fufcpp%2Flinqtoarray/lists"}