---

yaml
---
r: 12188
b: refs/heads/master
c: c0a9979
h: refs/heads/master
v: v3

Author: brson

[refs]

@@ -1,5 +1,5 @@
 ---
-refs/heads/master: ad21976fbc4776fe09f98cd087fbe4cecf23cd84
+refs/heads/master: c0a99790cb5cf3ba54954b1b8f7c04f54c42f984
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
 refs/heads/snap-stage3: 4a81779abd786ff22d71434c6d9a5917ea4cdfff
 refs/heads/try: 2898dcc5d97da9427ac367542382b6239d9c0bbf

trunk/src/libcore/str.rs

@@ -94,6 +94,7 @@ export
    char_at,
    reserve,
    reserve_at_least,
+   capacity,
 
    unsafe;
 
@@ -1530,6 +1531,18 @@ fn reserve_at_least(&s: str, n: uint) unsafe {
     reserve(s, uint::next_power_of_two(n + 1u) - 1u)
 }
 
+#[doc = "
+Returns the number of single-byte characters the string can hold without
+reallocating
+"]
+fn capacity(&&s: str) -> uint unsafe {
+    as_bytes(s) {|buf|
+        let vcap = vec::capacity(buf);
+        assert vcap > 0u;
+        vcap - 1u
+    }
+}
+
 #[doc = "Unsafe operations"]
 mod unsafe {
    export