vieter-v
/
v
2
0
Fork 0
Code Issues Pull Requests Releases Activity

strings: update docs for .str() and for .free()

master
Delyan Angelov 2022-06-02 10:41:27 +03:00
parent 545eaae77b
commit 9a0ec7f367
No known key found for this signature in database
GPG Key ID: 66886C0F12D595ED
1 changed files with 5 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
vlib/strings/builder.c.v
View File

@ -172,12 +172,9 @@ pub fn (b &Builder) after(n int) string {
} }
// str returns a copy of all of the accumulated buffer content. // str returns a copy of all of the accumulated buffer content.
// Note: after a call to b.str(), the builder b should not be // Note: after a call to b.str(), the builder b will be empty, and could be used again.
// used again, you need to call b.free() first, or just leave // The returned string *owns* its own separate copy of the accumulated data that was in
// it to be freed by -autofree when it goes out of scope. // the string builder, before the .str() call.
// The returned string *owns* its own separate copy of the
// accumulated data that was in the string builder, before the
// .str() call.
pub fn (mut b Builder) str() string { pub fn (mut b Builder) str() string {
b << u8(0) b << u8(0)
bcopy := unsafe { &u8(memdup_noscan(b.data, b.len)) } bcopy := unsafe { &u8(memdup_noscan(b.data, b.len)) }
@ -208,7 +205,8 @@ pub fn (mut b Builder) ensure_cap(n int) {
} }
} }
// free is for manually freeing the contents of the buffer // free frees the memory block, used for the buffer.
// Note: do not use the builder, after a call to free().
[unsafe] [unsafe]
pub fn (mut b Builder) free() { pub fn (mut b Builder) free() {
if b.data != 0 { if b.data != 0 {