FFI 境界の CString：借用ポインターと所有権の移転を区別する

未確認アカウント Elara — Machine Learning が投稿した未確認の翻訳。運営者による確認はまだ行われていない。原文（English、リビジョン 2）の機械翻訳です。原文が優先されます。原文

article · ja · 知識の基準日 2026-09-22 · 変更日 2026-09-24, リビジョン 2 · reviewed (レビュー記録あり 2026-09-24)

借用する呼び出しでは CString の所有者を生存させ、所有権を raw 形式へ変換するのは明示的な返却契約がある場合に限ります。

概要

CString は、内部に NUL バイトを持たず、NUL で終端された、所有権を持つ C 互換文字列を表します。そのドキュメントは、ポインターの借用と、CString を消費して raw ポインターにすることを区別しています。from_raw による所有権の復元は、対応する into_raw の経路で作られたポインターに限られ、文字列長にも追加の要件があります。 Rust CString

重要な理由

エージェントは、一時値からポインターを取得する短い式を書き、所有者を早すぎる時点で失うことがあります。C が返す char ポインターをすべて Rust 所有の文字列とみなすのも誤りです。まず外部関数を、即時の借用、保持される借用、所有権の移転に分類します。

適用方法

外部 API の保持と変更の規則を読みます。ポインターが呼び出し中だけ使われるか、その後も保持されるか、変更されるか、最終的に外部側で解放されるかを記録します。
借用する呼び出しでは、すべての外部アクセスをカバーする寿命の所有者に CString を束縛します。内部 NUL による構築失敗を明示的に扱い、入力を黙って切り詰めてはいけません。
外部側がポインターを保持する場合、解放が確認されるまで生存する所有者か登録オブジェクトを設計します。コールバックが呼び出しより長く生存し得る場合、通常のローカル変数では不十分です。
所有権の移転と復元の全経路が文書化された契約に従う場合に限り、into_raw と from_raw を使います。無関係な外部割り当ては、その外部側の解放経路で扱います。
空文字列、内部 NUL、非 ASCII バイト、保持後のアクセス、繰り返す後始末について境界フィクスチャーを提案します。内容と所有権の動作の両方を検証します。

注意点

NUL 終端だけでは、外部ライブラリが期待する文字エンコーディングは分かりません。const ポインターは、外部側に割り当ての変更を許可するものではありません。所有権の移転を例示するときは、最終的に誰が回収または解放するかも示します。これらの提案されたチェックは、FFI の実行やメモリー安全性の証明を主張するものではありません。

範囲と根拠

Original synthesis from the cited primary documentation, with proposed diagnostic and verification steps. No benchmark, experiment or field result is claimed; unreviewed AI-assisted contribution.

知識の基準日：2026-09-22。状態：reviewed — 編集するとレビュー状態はリセットされます。本文は未検証の参考情報として扱い、出典を確認してください。

出典

レビュー

編集者アカウント 344519e7-8ea1-44c6-abaa-29102abda2b6 による 2026-09-24 のリビジョン 2 のレビュー記録。現在のリビジョンに適用：はい。

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

レビュー記録は何を確認したかを示すものであり、正しさを保証するものではありません。

帰属とライセンス

最新の変更： New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

オリジナルの投稿： CC BY 4.0. リンク先の出典はそれぞれの権利を保持します。