Translate vec-insert-remove.md (#58)

toku-sa-n · web-flow · commit 006e8bfb44d8 · 2020-07-15T10:13:27.000-07:00
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
@@ -46,7 +46,7 @@
 	* [プッシュとポップ](vec-push-pop.md)
 	* [デアロケーティング](vec-dealloc.md)
 	* [参照外し](vec-deref.md)
-	* [Insert and Remove](vec-insert-remove.md)
+	* [挿入と削除](vec-insert-remove.md)
 	* [IntoIter](vec-into-iter.md)
 	* [RawVec](vec-raw.md)
 	* [Drain](vec-drain.md)
diff --git a/src/vec-insert-remove.md b/src/vec-insert-remove.md
@@ -1,27 +1,51 @@
+<!--
 # Insert and Remove
+-->
 
+# 挿入と削除
+
+<!--
 Something *not* provided by slice is `insert` and `remove`, so let's do those
 next.
+-->
+
+スライスから提供*されない*ものに、 `insert` と `remove` があります。
+今度はこれらを実装していきましょう。
 
+<!--
 Insert needs to shift all the elements at the target index to the right by one.
 To do this we need to use `ptr::copy`, which is our version of C's `memmove`.
 This copies some chunk of memory from one location to another, correctly
 handling the case where the source and destination overlap (which will
 definitely happen here).
+-->
 
+挿入では、挿入位置から最後の要素まで、 1 ずつずらす必要があります。
+これを行なうために、 `ptr::copy` を使う必要があります。 C の `memmove` の、
+Rust 版のようなものです。これは、ある場所のメモリを別の場所にコピーします。
+そして、2つの場所が重なっていても、正しくコピーされます (今回の場合、
+明らかに重なります) 。
+
+<!--
 If we insert at index `i`, we want to shift the `[i .. len]` to `[i+1 .. len+1]`
 using the old len.
+-->
+
+インデックス `i` の位置に挿入する場合、古い `len` の値を用いて、
+`[i .. len]` を `[i+1 .. len+1]` にシフトします。
 
 ```rust,ignore
 pub fn insert(&mut self, index: usize, elem: T) {
-    // Note: `<=` because it's valid to insert after everything
-    // which would be equivalent to push.
+    // 注意: 全要素の後に挿入しても問題ないため、
+    // `<=` としています。これは、プッシュと同等です。
+
+    // 境界外インデックスです
     assert!(index <= self.len, "index out of bounds");
     if self.cap == self.len { self.grow(); }
 
     unsafe {
         if index < self.len {
-            // ptr::copy(src, dest, len): "copy from source to dest len elems"
+            // ptr::copy(src, dest, len): "src から dest まで len 個の要素をコピー"
             ptr::copy(self.ptr.offset(index as isize),
                       self.ptr.offset(index as isize + 1),
                       self.len - index);
@@ -32,12 +56,19 @@ pub fn insert(&mut self, index: usize, elem: T) {
 }
 ```
 
+<!--
 Remove behaves in the opposite manner. We need to shift all the elements from
 `[i+1 .. len + 1]` to `[i .. len]` using the *new* len.
+-->
+
+削除では真逆の事を行ないます。*新しい* len を使用して、
+`[i+1 .. len+1]` を `[i .. len]` にシフトします。
 
 ```rust,ignore
 pub fn remove(&mut self, index: usize) -> T {
-    // Note: `<` because it's *not* valid to remove after everything
+    // 注意: 全要素のあとの物を削除することは*有効ではない*ため、 '<' を使用します
+
+    // 境界外インデックスです
     assert!(index < self.len, "index out of bounds");
     unsafe {
         self.len -= 1;
