diff --git a/reference/mysqli/mysqli/insert-id.xml b/reference/mysqli/mysqli/insert-id.xml index ebbed9ef37..110e8880e5 100644 --- a/reference/mysqli/mysqli/insert-id.xml +++ b/reference/mysqli/mysqli/insert-id.xml @@ -70,8 +70,8 @@ - もし数値が int の最大値をこえた場合、 - 文字列で結果を返します。 + 数値が int の最大値をこえる場合、 + 文字列として返します。 diff --git a/reference/mysqli/mysqli_stmt/insert-id.xml b/reference/mysqli/mysqli_stmt/insert-id.xml index 86b087ee90..e0d0972981 100644 --- a/reference/mysqli/mysqli_stmt/insert-id.xml +++ b/reference/mysqli/mysqli_stmt/insert-id.xml @@ -1,11 +1,11 @@ - + mysqli_stmt::$insert_id mysqli_stmt_insert_id - 直近の INSERT 操作で生成した ID を取得する + 直近に実行したステートメントで生成された AUTO_INCREMENT カラムの値を返す @@ -17,9 +17,117 @@ intstringmysqli_stmt_insert_id mysqli_stmtstatement + + AUTO_INCREMENT + 属性を持つカラムがあるテーブル上での + INSERT 文や UPDATE + 文が生成した ID を返します。 + 複数行の INSERT 文の場合、 + 自動生成されて挿入に成功した最初の値を返します。 + LAST_INSERT_ID(expr) を + AUTO_INCREMENT の値の設定に使った場合や、 + UPDATE 文で使った場合は、 + expr の値を返します。 + + + ステートメントが + AUTO_INCREMENT の値を変更しなかった場合、 + 0 を返します。 + + + + + &reftitle.parameters; + + &mysqli.stmt.description; + + + + + &reftitle.returnvalues; + + ステートメントが更新した AUTO_INCREMENT + フィールドの値を返します。ステートメントがまだ実行されていない場合や、 + AUTO_INCREMENT の値を更新しなかった場合はゼロを返します。 + + + この値はステートメントオブジェクトに固有のものです。 + 同じ接続でこのステートメントの後に実行された別のステートメントからも、 + 他の接続やクライアントが発行したステートメントからも影響を受けません。 + + + + 数値が int の最大値をこえる場合、 + 文字列として返します。 + + + + + + &reftitle.examples; + + <varname>mysqli_stmt::$insert_id</varname> の例 + &style.oop; + +query("CREATE TEMPORARY TABLE myCity LIKE City"); + +$stmt = $mysqli->prepare("INSERT INTO myCity (Name, CountryCode, District, Population) VALUES (?, ?, ?, ?)"); + +$name = 'Stuttgart'; +$countryCode = 'DEU'; +$district = 'Stuttgart'; +$population = 617000; +$stmt->bind_param('sssi', $name, $countryCode, $district, $population); +$stmt->execute(); + +printf("New record has ID %d.\n", $stmt->insert_id); +]]> + + &style.procedural; + + + + &examples.outputs; + + + + + - &warn.undocumented.func; + + &reftitle.seealso; + + mysqli_insert_id + mysqli_stmt_affected_rows + mysqli_stmt_execute +