steve
/
factor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

sequences: add suffix! to destructive sequence ops article

db4
Slava Pestov 2010-02-25 05:57:09 +13:00
parent d0c21a9182
commit e5aa02571f
1 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
core/sequences/sequences-docs.factor
View File

@ -1617,8 +1617,8 @@ ARTICLE: "sequences-destructive-discussion" "When to use destructive operations"
} }
"The second reason is much weaker than the first one. In particular, many combinators (see " { $link map } ", " { $link produce } " and " { $link "namespaces-make" } ") as well as more advanced data structures (such as " { $vocab-link "persistent.vectors" } ") alleviate the need for explicit use of side effects." ; "The second reason is much weaker than the first one. In particular, many combinators (see " { $link map } ", " { $link produce } " and " { $link "namespaces-make" } ") as well as more advanced data structures (such as " { $vocab-link "persistent.vectors" } ") alleviate the need for explicit use of side effects." ;
ARTICLE: "sequences-destructive" "Destructive operations" ARTICLE: "sequences-destructive" "Destructive sequence operations"
"Many operations have constructive and destructive variants:" "Many operations have destructive variants that side effect an input sequence, instead of creating a new sequence:"
{ $table { $table
{ "Constructive" "Destructive" } { "Constructive" "Destructive" }
{ { $link suffix } { $link suffix! } } { { $link suffix } { $link suffix! } }
@ -1641,10 +1641,14 @@ ARTICLE: "sequences-destructive" "Destructive operations"
delete-all delete-all
filter! filter!
} }
"Adding elements:"
{ $subsections
suffix!
append!
}
"Other destructive words:" "Other destructive words:"
{ $subsections { $subsections
reverse! reverse!
append!
move move
exchange exchange
copy copy