Update of /cvsroot/pure-data/externals/PDContainer/help In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv11457/help
Modified Files: help-h_deque.pd help-h_list.pd help-h_map.pd help-h_multimap.pd help-h_multiset.pd help-h_priority_queue.pd help-h_queue.pd help-h_set.pd help-h_stack.pd help-h_vector.pd Log Message: new help files for xml
Index: help-h_stack.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_stack.pd,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** help-h_stack.pd 4 Apr 2005 12:42:58 -0000 1.2 --- help-h_stack.pd 5 May 2005 22:59:34 -0000 1.3 *************** *** 1,77 **** ! #N canvas 489 0 796 753 10; #X obj 161 579 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 516 108 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 ! 0; ! #X obj 518 110 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 ! -143491 0; ! #N canvas 205 0 993 742 Container_Explanation 0; ! #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 16 15 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 254 23 general explation of; ! #X text 254 40 the datastructures; ! #X text 23 655 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ! ; ! #X obj 189 627 h_vector; ! #X text 500 654 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X obj 680 628 h_list; ! #X obj 189 773 h_deque; ! #X text 498 801 A queue is a "first in first out" (FIFO) data structure. ! That is , elements are added to the back of the queue (push) and may ! be removed from the front (pop).; ! #X obj 679 774 h_queue; ! #X text 22 951 A priority queue is also a "first in first out" (FIFO) ! data structure , but you can give the elements a priority. So the ! elements with a higher priority are automatically inserted before all ! other elements with a lower priority.; ! #X obj 154 924 h_priority_queue; ! #X text 20 800 A deque (double ended queue , pronounced "deck") is ! very much like a vector: like vector , it is a sequence that supports ! access to all elements via index. The main way in which deque differs ! from vector is that fast insertion and removal of elements is possible ! at the beginning _and_ the end.; ! #X text 22 232 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X obj 188 203 h_map; ! #X text 492 231 Multimaps are just like maps except that a key can ! be associated with several values. Multimap is a Sorted Associative ! Container and also a Multiple Associative Container , meaning that ! there is no limit on the number of elements with the same key. (see ! also Map); ! #X obj 643 201 h_multimap; ! #X text 24 419 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X obj 187 392 h_set; ! #X text 493 419 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X obj 642 391 h_multiset; ! #X text 339 167 :::: ASSOCIATIVE CONTAINERS ::::; ! #X text 393 592 :::: SEQUENCES ::::; ! #X text 289 1099 (look for help at all the objects for more information) ! ; ! #X text 35 87 PDContainer contains the following datastructures:; ! #X text 399 86 map , nultimap , set , multiset , vector , list ! , deque , queue , stack , priority queue; ! #X obj 679 916 h_stack; ! #X text 495 950 Stack is a "last in first out" (LIFO) data structure: the element at the top of a stack is the one that was most recently added (push). Top outputs the elements from the top without removing ! it , pop outputs and removes it.; ! #X restore 534 178 pd Container_Explanation; #N canvas 674 0 511 843 General_Concept 0; #X text 37 165 This library was made for algorithmic composition and --- 1,60 ---- ! #N canvas 0 0 796 754 10; #X obj 161 579 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 295 36 help file of; ! #X text 40 98 init arg: namespace; ! #X msg 430 438 clear; ! #X msg 430 532 help; ! #X obj 509 588 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 430 335 getnamespace; ! #X msg 430 476 clearall; ! #X obj 430 630 print BBB; ! #X obj 82 622 print AAA; ! #X text 541 360 <- change namespace; ! #X msg 430 359 namespace grix; ! #X text 478 438 <- clear all the data of the; ! #X text 499 453 current namespace; ! #X text 498 478 <- clear all the data in all; ! #X text 519 493 same containers (maybe; ! #X text 521 508 you shouldn't use this); ! #X text 530 337 <- get current namespace; ! #X text 429 283 general operations:; ! #X text 287 53 ::: h_stack :::; ! #X obj 430 563 h_stack data; ! #X floatatom 469 606 5 0 0 0 - - -; ! #X obj 82 557 h_stack data; ! #X floatatom 121 599 5 0 0 0 - - -; ! #X msg 430 391 getsize; ! #X text 493 391 <- puts out the size of the; ! #X text 514 407 stack at the 2nd outlet; ! #X msg 82 358 push $1; ! #X floatatom 82 332 5 0 0 0 - - -; ! #X symbolatom 130 332 10 0 0 0 - - -; ! #X text 148 359 <- push some data to the; ! #X text 169 374 top of the stack; ! #X msg 82 407 top; ! #X text 117 408 <- get the data from the top; ! #X text 138 423 of the stack without; ! #X text 138 436 removing it; ! #X msg 82 462 pop; ! #X text 513 606 <- nr of elements; ! #X text 187 579 <- bang if stack is empty; ! #X text 117 463 <- removes the data from the; ! #X text 138 478 top of the stack; ! #X text 137 494 (but without putting it; ! #X text 146 508 out !!!); ! #X text 38 133 Stack is a "last in first out" (LIFO) data structure: the element at the top of a stack is the one that was most recently added (push). Top outputs the elements from the top without removing ! it , pop removes it without putting it out.; ! #X obj 500 24 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 ! 0; ! #X obj 502 26 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 ! -143491 0; #N canvas 674 0 511 843 General_Concept 0; #X text 37 165 This library was made for algorithmic composition and *************** *** 116,121 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 99,102 ---- *************** *** 146,157 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 127,138 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 169,179 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 150,158 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 185,199 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 164,185 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 204,282 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 552 147 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 295 36 help file of; ! #X text 175 698 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 40 98 init arg: namespace; ! #X msg 430 438 clear; ! #X msg 430 532 help; ! #X obj 509 588 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 430 335 getnamespace; ! #X msg 430 476 clearall; ! #X obj 430 630 print BBB; ! #X obj 82 622 print AAA; ! #X text 541 360 <- change namespace; ! #X msg 430 359 namespace grix; ! #X text 478 438 <- clear all the data of the; ! #X text 499 453 current namespace; ! #X text 498 478 <- clear all the data in all; ! #X text 519 493 same containers (maybe; ! #X text 521 508 you shouldn't use this); ! #X text 530 337 <- get current namespace; ! #X text 429 283 general operations:; ! #X text 287 53 ::: h_stack :::; ! #X obj 430 563 h_stack data; ! #X floatatom 469 606 5 0 0 0 - - -; ! #X obj 82 557 h_stack data; ! #X floatatom 121 599 5 0 0 0 - - -; ! #X msg 430 391 getsize; ! #X text 493 391 <- puts out the size of the; ! #X text 514 407 stack at the 2nd outlet; ! #X msg 82 358 push $1; ! #X floatatom 82 332 5 0 0 0 - - -; ! #X symbolatom 130 332 10 0 0 0 - - -; ! #X text 148 359 <- push some data to the; ! #X text 169 374 top of the stack; ! #X msg 82 407 top; ! #X text 117 408 <- get the data from the top; ! #X text 138 423 of the stack without; ! #X text 138 436 removing it; ! #X msg 82 462 pop; ! #X text 513 606 <- nr of elements; ! #X text 187 579 <- bang if stack is empty; ! #X text 117 463 <- removes the data from the; ! #X text 138 478 top of the stack; ! #X text 137 494 (but without putting it; ! #X text 146 508 out !!!); ! #X text 38 133 Stack is a "last in first out" (LIFO) data structure: the element at the top of a stack is the one that was most recently added (push). Top outputs the elements from the top without removing ! it , pop removes it without putting it out.; ! #X connect 10 0 27 0; ! #X connect 11 0 27 0; ! #X connect 13 0 27 0; ! #X connect 14 0 27 0; ! #X connect 18 0 27 0; ! #X connect 27 0 15 0; ! #X connect 27 1 28 0; ! #X connect 27 2 12 0; ! #X connect 29 0 16 0; ! #X connect 29 1 30 0; ! #X connect 29 2 0 0; ! #X connect 31 0 27 0; ! #X connect 34 0 29 0; ! #X connect 35 0 34 0; ! #X connect 36 0 34 0; ! #X connect 39 0 29 0; ! #X connect 43 0 29 0; --- 190,367 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 62 pd General_Concept; ! #N canvas 205 0 993 742 Container_Explanation 0; ! #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 16 15 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 254 23 general explation of; ! #X text 254 40 the datastructures; ! #X text 23 655 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ! ; ! #X obj 189 627 h_vector; ! #X text 500 654 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X obj 680 628 h_list; ! #X obj 189 773 h_deque; ! #X text 498 801 A queue is a "first in first out" (FIFO) data structure. ! That is , elements are added to the back of the queue (push) and may ! be removed from the front (pop).; ! #X obj 679 774 h_queue; ! #X text 22 951 A priority queue is also a "first in first out" (FIFO) ! data structure , but you can give the elements a priority. So the ! elements with a higher priority are automatically inserted before all ! other elements with a lower priority.; ! #X obj 154 924 h_priority_queue; ! #X text 20 800 A deque (double ended queue , pronounced "deck") is ! very much like a vector: like vector , it is a sequence that supports ! access to all elements via index. The main way in which deque differs ! from vector is that fast insertion and removal of elements is possible ! at the beginning _and_ the end.; ! #X text 22 232 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X obj 188 203 h_map; ! #X text 492 231 Multimaps are just like maps except that a key can ! be associated with several values. Multimap is a Sorted Associative ! Container and also a Multiple Associative Container , meaning that ! there is no limit on the number of elements with the same key. (see ! also Map); ! #X obj 643 201 h_multimap; ! #X text 24 419 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X obj 187 392 h_set; ! #X text 493 419 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X obj 642 391 h_multiset; ! #X text 339 167 :::: ASSOCIATIVE CONTAINERS ::::; ! #X text 393 592 :::: SEQUENCES ::::; ! #X text 289 1099 (look for help at all the objects for more information) ! ; ! #X text 35 87 PDContainer contains the following datastructures:; ! #X text 399 86 map , nultimap , set , multiset , vector , list ! , deque , queue , stack , priority queue; ! #X obj 679 916 h_stack; ! #X text 495 950 Stack is a "last in first out" (LIFO) data structure: the element at the top of a stack is the one that was most recently added (push). Top outputs the elements from the top without removing ! it , pop outputs and removes it.; ! #X restore 518 90 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 116 pd Fileformats; ! #X text 218 709 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 178 693 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #X connect 5 0 22 0; ! #X connect 6 0 22 0; ! #X connect 8 0 22 0; ! #X connect 9 0 22 0; ! #X connect 13 0 22 0; ! #X connect 22 0 10 0; ! #X connect 22 1 23 0; ! #X connect 22 2 7 0; ! #X connect 24 0 11 0; ! #X connect 24 1 25 0; ! #X connect 24 2 0 0; ! #X connect 26 0 22 0; ! #X connect 29 0 24 0; ! #X connect 30 0 29 0; ! #X connect 31 0 29 0; ! #X connect 34 0 24 0; ! #X connect 38 0 24 0;
Index: help-h_priority_queue.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_priority_queue.pd,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -C2 -d -r1.1.1.1 -r1.2 *** help-h_priority_queue.pd 25 Oct 2004 19:02:32 -0000 1.1.1.1 --- help-h_priority_queue.pd 5 May 2005 22:59:34 -0000 1.2 *************** *** 2,77 **** #X obj 261 702 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 516 108 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 ! 0; ! #X obj 518 110 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 ! -143491 0; ! #N canvas 205 0 993 742 Container_Explanation 0; ! #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 16 15 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 254 23 general explation of; ! #X text 254 40 the datastructures; ! #X text 23 655 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ! ; ! #X obj 189 627 h_vector; ! #X text 500 654 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X obj 680 628 h_list; ! #X obj 189 773 h_deque; ! #X text 498 801 A queue is a "first in first out" (FIFO) data structure. ! That is , elements are added to the back of the queue (push) and may ! be removed from the front (pop).; ! #X obj 679 774 h_queue; ! #X text 22 951 A priority queue is also a "first in first out" (FIFO) ! data structure , but you can give the elements a priority. So the ! elements with a higher priority are automatically inserted before all ! other elements with a lower priority.; ! #X obj 154 924 h_priority_queue; ! #X text 20 800 A deque (double ended queue , pronounced "deck") is ! very much like a vector: like vector , it is a sequence that supports ! access to all elements via index. The main way in which deque differs ! from vector is that fast insertion and removal of elements is possible ! at the beginning _and_ the end.; ! #X text 22 232 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X obj 188 203 h_map; ! #X text 492 231 Multimaps are just like maps except that a key can ! be associated with several values. Multimap is a Sorted Associative ! Container and also a Multiple Associative Container , meaning that ! there is no limit on the number of elements with the same key. (see ! also Map); ! #X obj 643 201 h_multimap; ! #X text 24 419 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X obj 187 392 h_set; ! #X text 493 419 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X obj 642 391 h_multiset; ! #X text 339 167 :::: ASSOCIATIVE CONTAINERS ::::; ! #X text 393 592 :::: SEQUENCES ::::; ! #X text 289 1099 (look for help at all the objects for more information) ! ; ! #X text 35 87 PDContainer contains the following datastructures:; ! #X text 399 86 map , nultimap , set , multiset , vector , list ! , deque , queue , stack , priority queue; ! #X obj 679 916 h_stack; ! #X text 495 950 Stack is a "last in first out" (LIFO) data structure: ! the element at the top of a stack is the one that was most recently ! added (push). Top outputs the elements from the top without removing ! it , pop outputs and removes it.; ! #X restore 534 178 pd Container_Explanation; #N canvas 674 0 511 843 General_Concept 0; #X text 37 165 This library was made for algorithmic composition and --- 2,65 ---- #X obj 261 702 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 295 36 help file of; ! #X text 40 98 init arg: namespace; ! #X msg 430 438 clear; ! #X msg 430 532 help; ! #X obj 607 586 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 430 335 getnamespace; ! #X msg 430 476 clearall; ! #X obj 430 630 print BBB; ! #X text 541 360 <- change namespace; ! #X msg 430 359 namespace grix; ! #X text 478 438 <- clear all the data of the; ! #X text 499 453 current namespace; ! #X text 498 478 <- clear all the data in all; ! #X text 519 493 same containers (maybe; ! #X text 521 508 you shouldn't use this); ! #X text 530 337 <- get current namespace; ! #X text 429 283 general operations:; ! #X floatatom 518 606 5 0 0 0 - - -; ! #X floatatom 172 717 5 0 0 0 - - -; ! #X msg 430 391 getsize; ! #X text 493 391 <- puts out the size of the; ! #X text 514 407 stack at the 2nd outlet; ! #X text 153 600 removing it; ! #X msg 84 626 pop; ! #X text 285 53 ::: h_queue :::; ! #X text 562 606 <- nr of elements; ! #X text 119 627 <- removes the data fom the front; ! #X text 40 128 A priority queue is also a "first in first out" (FIFO) ! data structure like a queue , but you can give the elements a priority. ! So the elements with a higher priority are automatically inserted before ! all other elements with a lower priority.; ! #X msg 84 571 top; ! #X text 132 572 <- get the data from the top; ! #X text 153 587 of the container without; ! #X text 140 642 of the container; ! #X text 287 702 <- bang if container is empty; ! #X obj 79 486 print AAA; ! #X msg 256 431 list damm 4345 it; ! #X floatatom 256 337 5 0 0 0 - - -; ! #X symbolatom 256 355 10 0 0 0 - - -; ! #X msg 256 407 hacka 45; ! #X msg 256 384 3 4 krschi; ! #X text 253 309 value:; ! #X msg 79 358 push $1; ! #X floatatom 79 336 5 0 0 0 - - -; ! #X text 77 308 priority:; ! #X text 81 263 add data to the priority_queue:; ! #X obj 79 463 h_priority_queue $0-aetsch; ! #X obj 84 743 print CCC; ! #X obj 84 678 h_priority_queue $0-aetsch; ! #X obj 430 563 h_priority_queue $0-aetsch; ! #X obj 500 24 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 ! 0; ! #X obj 502 26 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 ! -143491 0; #N canvas 674 0 511 843 General_Concept 0; #X text 37 165 This library was made for algorithmic composition and *************** *** 116,121 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 104,107 ---- *************** *** 146,157 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 132,143 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 169,179 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 155,163 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 185,199 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 169,190 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 204,292 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 552 147 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 295 36 help file of; ! #X text 201 805 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at , 2004; ! #X text 40 98 init arg: namespace; ! #X msg 430 438 clear; ! #X msg 430 532 help; ! #X obj 607 586 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 430 335 getnamespace; ! #X msg 430 476 clearall; ! #X obj 430 630 print BBB; ! #X text 541 360 <- change namespace; ! #X msg 430 359 namespace grix; ! #X text 478 438 <- clear all the data of the; ! #X text 499 453 current namespace; ! #X text 498 478 <- clear all the data in all; ! #X text 519 493 same containers (maybe; ! #X text 521 508 you shouldn't use this); ! #X text 530 337 <- get current namespace; ! #X text 429 283 general operations:; ! #X floatatom 518 606 5 0 0 0 - - -; ! #X floatatom 172 717 5 0 0 0 - - -; ! #X msg 430 391 getsize; ! #X text 493 391 <- puts out the size of the; ! #X text 514 407 stack at the 2nd outlet; ! #X text 153 600 removing it; ! #X msg 84 626 pop; ! #X text 285 53 ::: h_queue :::; ! #X text 562 606 <- nr of elements; ! #X text 119 627 <- removes the data fom the front; ! #X text 40 128 A priority queue is also a "first in first out" (FIFO) ! data structure like a queue , but you can give the elements a priority. ! So the elements with a higher priority are automatically inserted before ! all other elements with a lower priority.; ! #X msg 84 571 top; ! #X text 132 572 <- get the data from the top; ! #X text 153 587 of the container without; ! #X text 140 642 of the container; ! #X text 287 702 <- bang if container is empty; ! #X obj 79 486 print AAA; ! #X msg 256 431 list damm 4345 it; ! #X floatatom 256 337 5 0 0 0 - - -; ! #X symbolatom 256 355 10 0 0 0 - - -; ! #X msg 256 407 hacka 45; ! #X msg 256 384 3 4 krschi; ! #X text 253 309 value:; ! #X msg 79 358 push $1; ! #X floatatom 79 336 5 0 0 0 - - -; ! #X text 77 308 priority:; ! #X text 81 263 add data to the priority_queue:; ! #X obj 79 463 h_priority_queue $0-aetsch; ! #X obj 84 743 print CCC; ! #X obj 84 678 h_priority_queue $0-aetsch; ! #X obj 430 563 h_priority_queue $0-aetsch; ! #X connect 10 0 55 0; ! #X connect 11 0 55 0; ! #X connect 13 0 55 0; ! #X connect 14 0 55 0; ! #X connect 17 0 55 0; ! #X connect 27 0 55 0; ! #X connect 31 0 54 0; ! #X connect 36 0 54 0; ! #X connect 42 0 52 1; ! #X connect 43 0 52 1; ! #X connect 44 0 52 1; ! #X connect 45 0 52 1; ! #X connect 46 0 52 1; ! #X connect 48 0 52 0; #X connect 49 0 48 0; ! #X connect 52 0 41 0; ! #X connect 54 0 53 0; ! #X connect 54 1 26 0; ! #X connect 54 2 0 0; ! #X connect 55 0 15 0; ! #X connect 55 1 25 0; ! #X connect 55 2 12 0; --- 195,377 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 62 pd General_Concept; ! #N canvas 205 0 993 742 Container_Explanation 0; ! #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 16 15 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 254 23 general explation of; ! #X text 254 40 the datastructures; ! #X text 23 655 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ! ; ! #X obj 189 627 h_vector; ! #X text 500 654 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X obj 680 628 h_list; ! #X obj 189 773 h_deque; ! #X text 498 801 A queue is a "first in first out" (FIFO) data structure. ! That is , elements are added to the back of the queue (push) and may ! be removed from the front (pop).; ! #X obj 679 774 h_queue; ! #X text 22 951 A priority queue is also a "first in first out" (FIFO) ! data structure , but you can give the elements a priority. So the ! elements with a higher priority are automatically inserted before all ! other elements with a lower priority.; ! #X obj 154 924 h_priority_queue; ! #X text 20 800 A deque (double ended queue , pronounced "deck") is ! very much like a vector: like vector , it is a sequence that supports ! access to all elements via index. The main way in which deque differs ! from vector is that fast insertion and removal of elements is possible ! at the beginning _and_ the end.; ! #X text 22 232 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X obj 188 203 h_map; ! #X text 492 231 Multimaps are just like maps except that a key can ! be associated with several values. Multimap is a Sorted Associative ! Container and also a Multiple Associative Container , meaning that ! there is no limit on the number of elements with the same key. (see ! also Map); ! #X obj 643 201 h_multimap; ! #X text 24 419 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X obj 187 392 h_set; ! #X text 493 419 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X obj 642 391 h_multiset; ! #X text 339 167 :::: ASSOCIATIVE CONTAINERS ::::; ! #X text 393 592 :::: SEQUENCES ::::; ! #X text 289 1099 (look for help at all the objects for more information) ! ; ! #X text 35 87 PDContainer contains the following datastructures:; ! #X text 399 86 map , nultimap , set , multiset , vector , list ! , deque , queue , stack , priority queue; ! #X obj 679 916 h_stack; ! #X text 495 950 Stack is a "last in first out" (LIFO) data structure: ! the element at the top of a stack is the one that was most recently ! added (push). Top outputs the elements from the top without removing ! it , pop outputs and removes it.; ! #X restore 518 90 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 116 pd Fileformats; ! #X text 224 810 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 184 794 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at , 2004; ! #X connect 5 0 50 0; ! #X connect 6 0 50 0; ! #X connect 8 0 50 0; ! #X connect 9 0 50 0; ! #X connect 12 0 50 0; ! #X connect 22 0 50 0; ! #X connect 26 0 49 0; ! #X connect 31 0 49 0; ! #X connect 37 0 47 1; ! #X connect 38 0 47 1; ! #X connect 39 0 47 1; ! #X connect 40 0 47 1; ! #X connect 41 0 47 1; ! #X connect 43 0 47 0; ! #X connect 44 0 43 0; ! #X connect 47 0 36 0; #X connect 49 0 48 0; ! #X connect 49 1 21 0; ! #X connect 49 2 0 0; ! #X connect 50 0 10 0; ! #X connect 50 1 20 0; ! #X connect 50 2 7 0;
Index: help-h_vector.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_vector.pd,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -C2 -d -r1.1.1.1 -r1.2 *** help-h_vector.pd 25 Oct 2004 19:02:32 -0000 1.1.1.1 --- help-h_vector.pd 5 May 2005 22:59:34 -0000 1.2 *************** *** 1,8 **** ! #N canvas 498 0 830 880 10; #X obj 157 404 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 509 44 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 511 46 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; --- 1,88 ---- ! #N canvas 0 54 830 880 10; #X obj 157 404 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 40 98 init arg: namespace; ! #X msg 480 313 print; ! #X msg 480 357 clear; ! #X msg 480 671 help; ! #X obj 566 721 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 480 254 getnamespace; ! #X msg 480 395 clearall; ! #X obj 480 770 print BBB; ! #X obj 71 443 print AAA; ! #X text 591 279 <- change namespace; ! #X msg 480 278 namespace grix; ! #X text 527 314 <- print all the data of the; ! #X text 546 329 current namespace; ! #X text 528 357 <- clear all the data of the; ! #X text 549 372 current namespace; ! #X text 548 397 <- clear all the data in all; ! #X text 569 412 same containers (maybe; ! #X text 571 427 you shouldn't use this); ! #X text 580 256 <- get current namespace; ! #X text 512 213 general operations:; ! #X msg 297 366 list damm 4345 it; ! #X floatatom 297 272 5 0 0 0 - - -; ! #X symbolatom 297 290 10 0 0 0 - - -; ! #X msg 297 342 hacka 45; ! #X msg 297 319 3 4 krschi; ! #X text 307 241 value:; ! #X text 279 54 ::: h_vector :::; ! #X text 31 143 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ! ; ! #X msg 480 608 resize $1; ! #X msg 480 642 getsize; ! #X floatatom 488 580 5 0 0 0 - - -; ! #X text 556 609 <- resizes the vector; ! #X obj 480 698 h_vector klax; ! #X floatatom 523 741 5 0 0 0 - - -; ! #X text 545 641 <- get the size (at 2nd; ! #X text 567 655 outlet); ! #X text 567 740 <- size of vector; ! #X obj 71 383 h_vector klax; ! #X floatatom 114 422 5 0 0 0 - - -; ! #X msg 71 290 get $1; ! #X floatatom 77 269 5 0 0 0 - - -; ! #X floatatom 77 226 5 0 0 0 - - -; ! #X msg 71 247 set $1; ! #X msg 71 698 insert $1; ! #X floatatom 78 671 5 0 0 0 - - -; ! #X floatatom 79 721 5 0 0 0 - - -; ! #X msg 70 744 remove $1; ! #X text 127 246 <- changes the value; ! #X text 148 260 at that index; ! #X text 145 304 at that index; ! #X text 124 290 <- get the value; ! #X text 177 404 <- bang if not found; ! #X msg 70 526 pushback gsdfg 34; ! #X msg 70 572 popback; ! #X obj 70 622 h_vector klax; ! #X floatatom 70 481 5 0 0 0 - - -; ! #X msg 70 503 pushback $1; ! #X text 166 503 <- inserts the data at the; ! #X text 223 518 back of the vector; ! #X text 230 532 (so the size will; ! #X text 230 545 increase); ! #X text 131 571 <- removes the element from the; ! #X text 154 586 back (so the size will decrease); ! #X msg 178 768 some data; ! #X text 152 671 remove and insert at index:; ! #X text 188 708 If you need this very often you; ! #X text 188 722 should better use a list or a map; ! #X text 187 694 Thats not very fast with a vector!; ! #X text 188 735 (or something else) !; ! #X obj 70 768 h_vector klax; ! #X symbolatom 115 481 10 0 0 0 - - -; ! #X obj 500 24 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 502 26 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; *************** *** 48,53 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 128,131 ---- *************** *** 78,89 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 156,167 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 101,111 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 179,187 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 117,131 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 193,214 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 136,183 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 545 83 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 205 825 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 40 98 init arg: namespace; ! #X msg 480 293 print; ! #X msg 480 337 clear; ! #X msg 480 681 help; ! #X obj 566 731 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 480 234 getnamespace; ! #X msg 480 375 clearall; ! #X obj 480 780 print BBB; ! #X obj 71 443 print AAA; ! #X text 591 259 <- change namespace; ! #X msg 480 258 namespace grix; ! #X text 527 294 <- print all the data of the; ! #X text 546 309 current namespace; ! #X text 528 337 <- clear all the data of the; ! #X text 549 352 current namespace; ! #X text 548 377 <- clear all the data in all; ! #X text 569 392 same containers (maybe; ! #X text 571 407 you shouldn't use this); ! #X text 585 440 <- save all the data of; ! #X text 582 455 current namespac to disk; ! #X text 579 481 <- read this file to; ! #X text 580 236 <- get current namespace; ! #X text 512 193 general operations:; ! #X msg 297 366 list damm 4345 it; ! #X floatatom 297 272 5 0 0 0 - - -; ! #X symbolatom 297 290 10 0 0 0 - - -; ! #X msg 297 342 hacka 45; ! #X msg 297 319 3 4 krschi; ! #X text 307 241 value:; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 --- 219,236 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 62 pd General_Concept; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 *************** *** 247,344 **** added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 527 114 pd Container_Explanation; ! #X text 279 54 ::: h_vector :::; ! #X text 31 143 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ; ! #X msg 480 618 resize $1; ! #X msg 480 652 getsize; ! #X text 593 495 current namespace and; ! #X text 592 509 it at the back (so the; ! #X text 593 524 size will increase); ! #X msg 480 440 save data.dat; ! #X msg 480 481 read data.dat; ! #X msg 480 547 readat data.dat 0; ! #X text 614 547 <- read the file at; ! #X text 635 563 the given index; ! #X text 624 579 (so that the size; ! #X text 625 593 won't increase); ! #X floatatom 488 590 5 0 0 0 - - -; ! #X text 556 619 <- resizes the vector; ! #X obj 480 708 h_vector klax; ! #X floatatom 523 751 5 0 0 0 - - -; ! #X text 545 651 <- get the size (at 2nd; ! #X text 567 665 outlet); ! #X text 567 750 <- size of vector; ! #X obj 71 383 h_vector klax; ! #X floatatom 114 422 5 0 0 0 - - -; ! #X msg 71 290 get $1; ! #X floatatom 77 269 5 0 0 0 - - -; ! #X floatatom 77 226 5 0 0 0 - - -; ! #X msg 71 247 set $1; ! #X msg 71 698 insert $1; ! #X floatatom 78 671 5 0 0 0 - - -; ! #X floatatom 79 721 5 0 0 0 - - -; ! #X msg 70 744 remove $1; ! #X text 127 246 <- changes the value; ! #X text 148 260 at that index; ! #X text 145 304 at that index; ! #X text 124 290 <- get the value; ! #X text 177 404 <- bang if not found; ! #X msg 70 526 pushback gsdfg 34; ! #X msg 70 572 popback; ! #X obj 70 622 h_vector klax; ! #X floatatom 70 481 5 0 0 0 - - -; ! #X msg 70 503 pushback $1; ! #X text 166 503 <- inserts the data at the; ! #X text 223 518 back of the vector; ! #X text 230 532 (so the size will; ! #X text 230 545 increase); ! #X text 131 571 <- removes the element from the; ! #X text 154 586 back (so the size will decrease); ! #X msg 178 768 some data; ! #X text 152 671 remove and insert at index:; ! #X text 188 708 If you need this very often you; ! #X text 188 722 should better use a list or a map; ! #X text 187 694 Thats not very fast with a vector!; ! #X text 188 735 (or something else) !; ! #X obj 70 768 h_vector klax; ! #X symbolatom 115 481 10 0 0 0 - - -; ! #X connect 9 0 54 0; ! #X connect 10 0 54 0; ! #X connect 11 0 54 0; ! #X connect 13 0 54 0; ! #X connect 14 0 54 0; ! #X connect 18 0 54 0; ! #X connect 31 0 59 1; ! #X connect 32 0 59 1; ! #X connect 33 0 59 1; ! #X connect 34 0 59 1; ! #X connect 35 0 59 1; ! #X connect 40 0 54 0; ! #X connect 41 0 54 0; ! #X connect 45 0 54 0; ! #X connect 46 0 54 0; ! #X connect 47 0 54 0; ! #X connect 52 0 40 0; ! #X connect 54 0 15 0; ! #X connect 54 1 55 0; ! #X connect 54 2 12 0; ! #X connect 59 0 16 0; ! #X connect 59 1 60 0; ! #X connect 59 2 0 0; ! #X connect 61 0 59 0; ! #X connect 62 0 61 0; ! #X connect 63 0 64 0; ! #X connect 64 0 59 0; ! #X connect 65 0 91 0; ! #X connect 66 0 65 0; ! #X connect 67 0 68 0; ! #X connect 68 0 91 0; ! #X connect 74 0 76 0; ! #X connect 75 0 76 0; ! #X connect 77 0 78 0; ! #X connect 78 0 76 0; ! #X connect 85 0 91 1; ! #X connect 92 0 78 0; --- 300,444 ---- added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 518 90 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 116 pd Fileformats; ! #X text 238 841 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 198 825 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #N canvas 174 18 646 402 read_save_possibilities 0; ! #X obj 44 336 outlet; ! #X msg 44 208 save data.dat; ! #X msg 44 244 read data.dat; ! #X msg 44 288 readat data.dat 0; ! #X text 149 208 <- save all the data of the current namespace as textfile ! ; ! #X text 143 244 <- read this textfile to the current namespace and ! insert it at the back (so the size will increase); ! #X text 177 287 <- read the textfile and insert it at the given index ! (so the size won't increase !); ! #X text 166 94 <- read this XML-file to the current namespace and insert ! it at the back (so the size will increase); ! #X text 169 61 <- save all the data of the current namespace as XML-file ! ; ! #X text 196 139 <- read the XML-file and insert it at the given index ! (so the size won't increase !); ! #X msg 44 61 saveXML data.xml; ! #X msg 44 93 readXML data.xml; ! #X msg 44 139 readatXML data.xml 0; ! #X connect 1 0 0 0; ! #X connect 2 0 0 0; ! #X connect 3 0 0 0; ! #X connect 10 0 0 0; ! #X connect 11 0 0 0; ! #X connect 12 0 0 0; ! #X restore 480 476 pd read_save_possibilities; ! #X text 520 500 different possiblities to read; ! #X text 520 514 and write from and to files; ! #X text 519 529 (XML and textfiles); ! #X connect 5 0 36 0; ! #X connect 6 0 36 0; ! #X connect 7 0 36 0; ! #X connect 9 0 36 0; ! #X connect 10 0 36 0; ! #X connect 14 0 36 0; ! #X connect 24 0 41 1; ! #X connect 25 0 41 1; ! #X connect 26 0 41 1; ! #X connect 27 0 41 1; ! #X connect 28 0 41 1; ! #X connect 32 0 36 0; ! #X connect 33 0 36 0; ! #X connect 34 0 32 0; ! #X connect 36 0 11 0; ! #X connect 36 1 37 0; ! #X connect 36 2 8 0; ! #X connect 41 0 12 0; ! #X connect 41 1 42 0; ! #X connect 41 2 0 0; ! #X connect 43 0 41 0; ! #X connect 44 0 43 0; ! #X connect 45 0 46 0; ! #X connect 46 0 41 0; ! #X connect 47 0 73 0; ! #X connect 48 0 47 0; ! #X connect 49 0 50 0; ! #X connect 50 0 73 0; ! #X connect 56 0 58 0; ! #X connect 57 0 58 0; ! #X connect 59 0 60 0; ! #X connect 60 0 58 0; ! #X connect 67 0 73 1; ! #X connect 74 0 60 0; ! #X connect 82 0 36 0;
Index: help-h_map.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_map.pd,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** help-h_map.pd 29 Oct 2004 11:56:12 -0000 1.2 --- help-h_map.pd 5 May 2005 22:59:33 -0000 1.3 *************** *** 1,9 **** ! #N canvas 332 0 818 882 10; #X msg 82 407 add ge; #X obj 175 494 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 514 131 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 516 133 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; --- 1,79 ---- ! #N canvas 0 0 818 882 10; #X msg 82 407 add ge; #X obj 175 494 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 292 53 ::: h_map :::; ! #X text 40 98 init arg: namespace; ! #X msg 474 379 print; ! #X msg 474 423 clear; ! #X msg 474 643 help; ! #X obj 567 704 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 474 320 getnamespace; ! #X msg 474 461 clearall; ! #X obj 474 681 h_map druschka; ! #X obj 474 757 print BBB; ! #X obj 82 495 print AAA; ! #X text 585 345 <- change namespace; ! #X msg 474 344 namespace grix; ! #X text 521 380 <- print all the data of the; ! #X text 540 395 current namespace; ! #X text 522 423 <- clear all the data of the; ! #X text 543 438 current namespace; ! #X text 542 463 <- clear all the data in all; ! #X text 563 478 same containers (maybe; ! #X text 565 493 you shouldn't use this); ! #X text 574 322 <- get current namespace; ! #X text 473 268 general operations:; ! #X msg 82 381 add bla bal tuff; ! #X msg 82 431 add 4 f 3; ! #X msg 82 356 add $1; ! #X floatatom 82 318 5 0 0 0 - - -; ! #X symbolatom 129 320 10 0 0 0 - - -; ! #X obj 82 472 h_map druschka; ! #X msg 244 433 list damm 4345 it; ! #X floatatom 244 339 5 0 0 0 - - -; ! #X symbolatom 244 357 10 0 0 0 - - -; ! #X msg 244 409 hacka 45; ! #X msg 244 386 3 4 krschi; ! #X text 37 130 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X text 110 293 key:; ! #X text 254 308 value:; ! #X text 127 269 add data to the map:; ! #X obj 172 748 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 79 749 print AAA; ! #X floatatom 79 572 5 0 0 0 - - -; ! #X symbolatom 126 574 10 0 0 0 - - -; ! #X obj 79 726 h_map druschka; ! #X text 136 541 get , remove data:; ! #X msg 79 610 get $1; ! #X msg 79 635 get bla bal tuff; ! #X msg 79 661 get ge; ! #X msg 79 685 get 4 f 3; ! #X floatatom 222 576 5 0 0 0 - - -; ! #X symbolatom 269 578 10 0 0 0 - - -; ! #X msg 222 614 remove $1; ! #X msg 222 639 remove bla bal tuff; ! #X msg 222 665 remove ge; ! #X msg 222 689 remove 4 f 3; ! #X text 195 748 <- bang if the key isn't found; ! #X msg 474 609 getsize; ! #X text 539 608 <- get the size (at 2nd; ! #X text 561 622 outlet); ! #X obj 520 730 print size; ! #X obj 504 26 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 506 28 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; *************** *** 49,54 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 119,122 ---- *************** *** 79,90 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 147,158 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 102,112 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 170,178 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 118,132 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 184,205 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 137,221 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 550 170 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 200 831 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 292 53 ::: h_map :::; ! #X text 40 98 init arg: namespace; ! #X msg 482 405 print; ! #X msg 482 449 clear; ! #X msg 482 669 help; ! #X obj 575 730 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 482 346 getnamespace; ! #X msg 482 487 clearall; ! #X msg 482 552 save map.dat; ! #X msg 482 593 read map.dat; ! #X obj 482 707 h_map druschka; ! #X obj 482 783 print BBB; ! #X obj 82 495 print AAA; ! #X text 593 371 <- change namespace; ! #X msg 482 370 namespace grix; ! #X text 529 406 <- print all the data of the; ! #X text 548 421 current namespace; ! #X text 530 449 <- clear all the data of the; ! #X text 551 464 current namespace; ! #X text 550 489 <- clear all the data in all; ! #X text 571 504 same containers (maybe; ! #X text 573 519 you shouldn't use this); ! #X text 583 553 <- save all the data of; ! #X text 580 568 current namespac to disk; ! #X text 581 593 <- read this file to; ! #X text 602 607 current namespace; ! #X text 582 348 <- get current namespace; ! #X text 481 294 general operations:; ! #X msg 82 381 add bla bal tuff; ! #X msg 82 431 add 4 f 3; ! #X msg 82 356 add $1; ! #X floatatom 82 318 5 0 0 0 - - -; ! #X symbolatom 129 320 10 0 0 0 - - -; ! #X obj 82 472 h_map druschka; ! #X msg 244 433 list damm 4345 it; ! #X floatatom 244 339 5 0 0 0 - - -; ! #X symbolatom 244 357 10 0 0 0 - - -; ! #X msg 244 409 hacka 45; ! #X msg 244 386 3 4 krschi; ! #X text 37 130 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X text 110 293 key:; ! #X text 254 308 value:; ! #X text 127 269 add data to the map:; ! #X obj 172 748 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 79 749 print AAA; ! #X floatatom 79 572 5 0 0 0 - - -; ! #X symbolatom 126 574 10 0 0 0 - - -; ! #X obj 79 726 h_map druschka; ! #X text 136 541 get , remove data:; ! #X msg 79 610 get $1; ! #X msg 79 635 get bla bal tuff; ! #X msg 79 661 get ge; ! #X msg 79 685 get 4 f 3; ! #X floatatom 222 576 5 0 0 0 - - -; ! #X symbolatom 269 578 10 0 0 0 - - -; ! #X msg 222 614 remove $1; ! #X msg 222 639 remove bla bal tuff; ! #X msg 222 665 remove ge; ! #X msg 222 689 remove 4 f 3; ! #X text 195 748 <- bang if the key isn't found; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 --- 210,227 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 540 64 pd General_Concept; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 *************** *** 285,330 **** added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 532 201 pd Container_Explanation; ! #X msg 482 635 getsize; ! #X text 547 634 <- get the size (at 2nd; ! #X text 569 648 outlet); ! #X obj 528 756 print size; ! #X connect 0 0 42 0; ! #X connect 11 0 19 0; ! #X connect 12 0 19 0; ! #X connect 13 0 19 0; ! #X connect 15 0 19 0; ! #X connect 16 0 19 0; ! #X connect 17 0 19 0; ! #X connect 18 0 19 0; ! #X connect 19 0 20 0; ! #X connect 19 1 73 0; ! #X connect 19 2 14 0; ! #X connect 23 0 19 0; ! #X connect 37 0 42 0; ! #X connect 38 0 42 0; ! #X connect 39 0 42 0; ! #X connect 40 0 39 0; ! #X connect 41 0 39 0; ! #X connect 42 0 21 0; ! #X connect 42 2 1 0; ! #X connect 43 0 42 1; ! #X connect 44 0 42 1; ! #X connect 45 0 42 1; ! #X connect 46 0 42 1; ! #X connect 47 0 42 1; ! #X connect 54 0 58 0; ! #X connect 55 0 58 0; ! #X connect 56 0 53 0; ! #X connect 56 2 52 0; ! #X connect 58 0 56 0; ! #X connect 59 0 56 0; ! #X connect 60 0 56 0; ! #X connect 61 0 56 0; ! #X connect 62 0 64 0; ! #X connect 63 0 64 0; ! #X connect 64 0 56 0; ! #X connect 65 0 56 0; ! #X connect 66 0 56 0; ! #X connect 67 0 56 0; ! #X connect 70 0 19 0; --- 291,430 ---- added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 522 92 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 554 118 pd Fileformats; ! #N canvas 174 18 646 317 read_save_possibilities 0; ! #X obj 50 258 outlet; ! #X msg 50 158 save data.dat; ! #X msg 50 194 read data.dat; ! #X text 155 158 <- save all the data of the current namespace as textfile ! ; ! #X text 149 194 <- read this textfile to the current namespace and ! insert it at the back (so the size will increase); ! #X text 173 83 <- read this XML-file to the current namespace and insert ! it at the back (so the size will increase); ! #X text 176 50 <- save all the data of the current namespace as XML-file ! ; ! #X msg 51 50 saveXML data.xml; ! #X msg 51 82 readXML data.xml; ! #X connect 1 0 0 0; ! #X connect 2 0 0 0; ! #X connect 7 0 0 0; ! #X connect 8 0 0 0; ! #X restore 474 522 pd read_save_possibilities; ! #X text 512 543 different possiblities to read; ! #X text 512 557 and write from and to files; ! #X text 511 571 (XML and textfiles); ! #X text 248 827 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 208 811 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #X connect 0 0 32 0; ! #X connect 7 0 13 0; ! #X connect 8 0 13 0; ! #X connect 9 0 13 0; ! #X connect 11 0 13 0; ! #X connect 12 0 13 0; ! #X connect 13 0 14 0; ! #X connect 13 1 62 0; ! #X connect 13 2 10 0; ! #X connect 17 0 13 0; ! #X connect 27 0 32 0; ! #X connect 28 0 32 0; ! #X connect 29 0 32 0; ! #X connect 30 0 29 0; ! #X connect 31 0 29 0; ! #X connect 32 0 15 0; ! #X connect 32 2 1 0; ! #X connect 33 0 32 1; ! #X connect 34 0 32 1; ! #X connect 35 0 32 1; ! #X connect 36 0 32 1; ! #X connect 37 0 32 1; ! #X connect 44 0 48 0; ! #X connect 45 0 48 0; ! #X connect 46 0 43 0; ! #X connect 46 2 42 0; ! #X connect 48 0 46 0; ! #X connect 49 0 46 0; ! #X connect 50 0 46 0; ! #X connect 51 0 46 0; ! #X connect 52 0 54 0; ! #X connect 53 0 54 0; ! #X connect 54 0 46 0; ! #X connect 55 0 46 0; ! #X connect 56 0 46 0; ! #X connect 57 0 46 0; ! #X connect 59 0 13 0; ! #X connect 68 0 13 0;
Index: help-h_set.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_set.pd,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** help-h_set.pd 29 Oct 2004 11:56:13 -0000 1.2 --- help-h_set.pd 5 May 2005 22:59:34 -0000 1.3 *************** *** 1,7 **** ! #N canvas 219 0 865 892 10; #X msg 154 388 add ge; ! #X obj 514 131 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 516 133 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; --- 1,65 ---- ! #N canvas 0 0 800 865 10; #X msg 154 388 add ge; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 37 100 init arg: namespace; ! #X msg 477 380 print; ! #X msg 477 424 clear; ! #X msg 477 644 help; ! #X msg 477 321 getnamespace; ! #X msg 477 462 clearall; ! #X text 588 346 <- change namespace; ! #X msg 477 345 namespace grix; ! #X text 524 381 <- print all the data of the; ! #X text 543 396 current namespace; ! #X text 525 424 <- clear all the data of the; ! #X text 546 439 current namespace; ! #X text 545 464 <- clear all the data in all; ! #X text 566 479 same containers (maybe; ! #X text 568 494 you shouldn't use this); ! #X text 577 323 <- get current namespace; ! #X text 476 269 general operations:; ! #X msg 154 362 add bla bal tuff; ! #X msg 154 412 add 4 f 3; ! #X msg 154 337 add $1; ! #X floatatom 154 299 5 0 0 0 - - -; ! #X symbolatom 201 301 10 0 0 0 - - -; ! #X floatatom 84 578 5 0 0 0 - - -; ! #X symbolatom 131 580 10 0 0 0 - - -; ! #X text 139 544 get , remove data:; ! #X msg 84 616 get $1; ! #X msg 84 641 get bla bal tuff; ! #X msg 84 667 get ge; ! #X msg 84 691 get 4 f 3; ! #X floatatom 227 582 5 0 0 0 - - -; ! #X symbolatom 274 584 10 0 0 0 - - -; ! #X msg 227 620 remove $1; ! #X msg 227 645 remove bla bal tuff; ! #X msg 227 671 remove ge; ! #X msg 227 695 remove 4 f 3; ! #X floatatom 84 757 5 0 0 0 - - -; ! #X floatatom 477 698 5 0 0 0 - - -; ! #X text 291 51 ::: h_set :::; ! #X text 37 129 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X text 140 268 add data to the set:; ! #X obj 154 453 h_set krx; ! #X floatatom 154 477 5 0 0 0 - - -; ! #X obj 84 732 h_set krx; ! #X text 131 757 <- 1 if the data is set (otherwise 0); ! #X obj 477 675 h_set krx; ! #X obj 535 698 print size; ! #X msg 477 609 getsize; ! #X text 542 608 <- get the size (at 2nd; ! #X text 564 622 outlet); ! #X obj 500 24 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 502 26 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; *************** *** 47,52 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 105,108 ---- *************** *** 77,88 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 133,144 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 100,110 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 156,164 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 116,130 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 170,191 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 135,205 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 550 170 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 228 840 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 37 100 init arg: namespace; ! #X msg 482 417 print; ! #X msg 482 461 clear; ! #X msg 482 681 help; ! #X msg 482 358 getnamespace; ! #X msg 482 499 clearall; ! #X text 593 383 <- change namespace; ! #X msg 482 382 namespace grix; ! #X text 529 418 <- print all the data of the; ! #X text 548 433 current namespace; ! #X text 530 461 <- clear all the data of the; ! #X text 551 476 current namespace; ! #X text 550 501 <- clear all the data in all; ! #X text 571 516 same containers (maybe; ! #X text 573 531 you shouldn't use this); ! #X text 583 565 <- save all the data of; ! #X text 580 580 current namespac to disk; ! #X text 581 605 <- read this file to; ! #X text 602 619 current namespace; ! #X text 582 360 <- get current namespace; ! #X text 481 306 general operations:; ! #X msg 154 362 add bla bal tuff; ! #X msg 154 412 add 4 f 3; ! #X msg 154 337 add $1; ! #X floatatom 154 299 5 0 0 0 - - -; ! #X symbolatom 201 301 10 0 0 0 - - -; ! #X floatatom 84 578 5 0 0 0 - - -; ! #X symbolatom 131 580 10 0 0 0 - - -; ! #X text 139 544 get , remove data:; ! #X msg 84 616 get $1; ! #X msg 84 641 get bla bal tuff; ! #X msg 84 667 get ge; ! #X msg 84 691 get 4 f 3; ! #X floatatom 227 582 5 0 0 0 - - -; ! #X symbolatom 274 584 10 0 0 0 - - -; ! #X msg 227 620 remove $1; ! #X msg 227 645 remove bla bal tuff; ! #X msg 227 671 remove ge; ! #X msg 227 695 remove 4 f 3; ! #X floatatom 84 757 5 0 0 0 - - -; ! #X floatatom 482 735 5 0 0 0 - - -; ! #X text 291 51 ::: h_set :::; ! #X text 37 129 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X text 140 268 add data to the set:; ! #X obj 154 453 h_set krx; ! #X floatatom 154 477 5 0 0 0 - - -; ! #X obj 84 732 h_set krx; ! #X text 131 757 <- 1 if the data is set (otherwise 0); ! #X obj 482 712 h_set krx; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 --- 196,213 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 62 pd General_Concept; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 *************** *** 269,308 **** added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 532 201 pd Container_Explanation; ! #X msg 482 564 save set.dat; ! #X msg 482 605 read set.dat; ! #X obj 540 735 print size; ! #X msg 482 646 getsize; ! #X text 547 645 <- get the size (at 2nd; ! #X text 569 659 outlet); ! #X connect 0 0 52 0; ! #X connect 9 0 56 0; ! #X connect 10 0 56 0; ! #X connect 11 0 56 0; ! #X connect 12 0 56 0; ! #X connect 13 0 56 0; ! #X connect 15 0 56 0; ! #X connect 29 0 52 0; ! #X connect 30 0 52 0; ! #X connect 31 0 52 0; ! #X connect 32 0 31 0; ! #X connect 33 0 31 0; ! #X connect 34 0 37 0; ! #X connect 35 0 37 0; ! #X connect 37 0 54 0; ! #X connect 38 0 54 0; ! #X connect 39 0 54 0; ! #X connect 40 0 54 0; ! #X connect 41 0 43 0; ! #X connect 42 0 43 0; ! #X connect 43 0 54 0; ! #X connect 44 0 54 0; ! #X connect 45 0 54 0; ! #X connect 46 0 54 0; ! #X connect 52 0 53 0; ! #X connect 54 0 47 0; ! #X connect 56 0 48 0; ! #X connect 56 1 60 0; ! #X connect 58 0 56 0; ! #X connect 59 0 56 0; ! #X connect 61 0 11 0; --- 277,408 ---- added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 518 90 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 116 pd Fileformats; ! #N canvas 174 18 646 317 read_save_possibilities 0; ! #X obj 50 258 outlet; ! #X msg 50 158 save data.dat; ! #X msg 50 194 read data.dat; ! #X text 155 158 <- save all the data of the current namespace as textfile ! ; ! #X text 149 194 <- read this textfile to the current namespace and ! insert it at the back (so the size will increase); ! #X text 173 83 <- read this XML-file to the current namespace and insert ! it at the back (so the size will increase); ! #X text 176 50 <- save all the data of the current namespace as XML-file ! ; ! #X msg 51 50 saveXML data.xml; ! #X msg 51 82 readXML data.xml; ! #X connect 1 0 0 0; ! #X connect 2 0 0 0; ! #X connect 7 0 0 0; ! #X connect 8 0 0 0; ! #X restore 477 525 pd read_save_possibilities; ! #X text 515 546 different possiblities to read; ! #X text 515 560 and write from and to files; ! #X text 514 574 (XML and textfiles); ! #X text 283 824 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 243 808 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #X connect 0 0 44 0; ! #X connect 5 0 48 0; ! #X connect 6 0 48 0; ! #X connect 7 0 48 0; ! #X connect 8 0 48 0; ! #X connect 9 0 48 0; ! #X connect 11 0 48 0; ! #X connect 21 0 44 0; ! #X connect 22 0 44 0; ! #X connect 23 0 44 0; ! #X connect 24 0 23 0; ! #X connect 25 0 23 0; ! #X connect 26 0 29 0; ! #X connect 27 0 29 0; ! #X connect 29 0 46 0; ! #X connect 30 0 46 0; ! #X connect 31 0 46 0; ! #X connect 32 0 46 0; ! #X connect 33 0 35 0; ! #X connect 34 0 35 0; ! #X connect 35 0 46 0; ! #X connect 36 0 46 0; ! #X connect 37 0 46 0; ! #X connect 38 0 46 0; ! #X connect 44 0 45 0; ! #X connect 46 0 39 0; ! #X connect 48 0 40 0; ! #X connect 48 1 49 0; ! #X connect 50 0 7 0; ! #X connect 58 0 48 0;
Index: help-h_multimap.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_multimap.pd,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** help-h_multimap.pd 29 Oct 2004 11:56:13 -0000 1.2 --- help-h_multimap.pd 5 May 2005 22:59:33 -0000 1.3 *************** *** 1,7 **** ! #N canvas 0 0 868 918 10; #X msg 82 407 add ge; ! #X obj 514 131 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 516 133 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; --- 1,73 ---- ! #N canvas 556 0 813 872 10; #X msg 82 407 add ge; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 40 98 init arg: namespace; ! #X msg 479 373 print; ! #X msg 479 417 clear; ! #X msg 479 655 help; ! #X msg 479 314 getnamespace; ! #X msg 479 455 clearall; ! #X obj 479 708 print BBB; ! #X obj 82 495 print AAA; ! #X text 590 339 <- change namespace; ! #X msg 479 338 namespace grix; ! #X text 526 374 <- print all the data of the; ! #X text 545 389 current namespace; ! #X text 527 417 <- clear all the data of the; ! #X text 548 432 current namespace; ! #X text 547 457 <- clear all the data in all; ! #X text 568 472 same containers (maybe; ! #X text 570 487 you shouldn't use this); ! #X text 579 316 <- get current namespace; ! #X text 478 262 general operations:; ! #X msg 82 381 add bla bal tuff; ! #X msg 82 431 add 4 f 3; ! #X msg 82 356 add $1; ! #X floatatom 82 318 5 0 0 0 - - -; ! #X symbolatom 129 320 10 0 0 0 - - -; ! #X msg 232 429 list damm 4345 it; ! #X floatatom 232 335 5 0 0 0 - - -; ! #X symbolatom 232 353 10 0 0 0 - - -; ! #X msg 232 405 hacka 45; ! #X msg 232 382 3 4 krschi; ! #X text 110 293 key:; ! #X text 242 304 value:; ! #X obj 79 749 print AAA; ! #X floatatom 79 572 5 0 0 0 - - -; ! #X symbolatom 126 574 10 0 0 0 - - -; ! #X text 136 541 get , remove data:; ! #X msg 79 610 get $1; ! #X msg 79 635 get bla bal tuff; ! #X msg 79 661 get ge; ! #X msg 79 685 get 4 f 3; ! #X floatatom 222 576 5 0 0 0 - - -; ! #X symbolatom 269 578 10 0 0 0 - - -; ! #X msg 222 614 remove $1; ! #X msg 222 639 remove bla bal tuff; ! #X msg 222 665 remove ge; ! #X msg 222 689 remove 4 f 3; ! #X text 40 131 Multimaps are just like maps except that a key can be ! associated with several values. Multimap is a Sorted Associative Container ! and also a Multiple Associative Container , meaning that there is ! no limit on the number of elements with the same key. (see also Map) ! ; ! #X text 275 53 ::: h_multimap :::; ! #X obj 82 472 h_multimap dampta; ! #X obj 79 726 h_multimap dampta; ! #X obj 479 686 h_multimap dampta; ! #X floatatom 136 782 5 0 0 0 - - -; ! #X text 111 263 add data to the multimap:; ! #X text 180 783 <- nr of values at the specific key; ! #X msg 479 600 getsize; ! #X text 566 613 outlet); ! #X text 544 599 <- get the size (at 3rd; ! #X obj 593 709 print size; ! #X obj 500 24 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 502 26 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; *************** *** 47,52 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 113,116 ---- *************** *** 77,88 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 141,152 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 100,110 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 164,172 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 116,130 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 178,199 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 135,215 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 550 170 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 203 848 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 40 98 init arg: namespace; ! #X msg 481 408 print; ! #X msg 481 452 clear; ! #X msg 481 690 help; ! #X msg 481 349 getnamespace; ! #X msg 481 490 clearall; ! #X msg 481 555 save map.dat; ! #X msg 481 596 read map.dat; ! #X obj 481 743 print BBB; ! #X obj 82 495 print AAA; ! #X text 592 374 <- change namespace; ! #X msg 481 373 namespace grix; ! #X text 528 409 <- print all the data of the; ! #X text 547 424 current namespace; ! #X text 529 452 <- clear all the data of the; ! #X text 550 467 current namespace; ! #X text 549 492 <- clear all the data in all; ! #X text 570 507 same containers (maybe; ! #X text 572 522 you shouldn't use this); ! #X text 582 556 <- save all the data of; ! #X text 579 571 current namespac to disk; ! #X text 580 596 <- read this file to; ! #X text 601 610 current namespace; ! #X text 581 351 <- get current namespace; ! #X text 480 297 general operations:; ! #X msg 82 381 add bla bal tuff; ! #X msg 82 431 add 4 f 3; ! #X msg 82 356 add $1; ! #X floatatom 82 318 5 0 0 0 - - -; ! #X symbolatom 129 320 10 0 0 0 - - -; ! #X msg 232 429 list damm 4345 it; ! #X floatatom 232 335 5 0 0 0 - - -; ! #X symbolatom 232 353 10 0 0 0 - - -; ! #X msg 232 405 hacka 45; ! #X msg 232 382 3 4 krschi; ! #X text 110 293 key:; ! #X text 242 304 value:; ! #X obj 79 749 print AAA; ! #X floatatom 79 572 5 0 0 0 - - -; ! #X symbolatom 126 574 10 0 0 0 - - -; ! #X text 136 541 get , remove data:; ! #X msg 79 610 get $1; ! #X msg 79 635 get bla bal tuff; ! #X msg 79 661 get ge; ! #X msg 79 685 get 4 f 3; ! #X floatatom 222 576 5 0 0 0 - - -; ! #X symbolatom 269 578 10 0 0 0 - - -; ! #X msg 222 614 remove $1; ! #X msg 222 639 remove bla bal tuff; ! #X msg 222 665 remove ge; ! #X msg 222 689 remove 4 f 3; ! #X text 40 131 Multimaps are just like maps except that a key can be ! associated with several values. Multimap is a Sorted Associative Container ! and also a Multiple Associative Container , meaning that there is ! no limit on the number of elements with the same key. (see also Map) ! ; ! #X text 275 53 ::: h_multimap :::; ! #X obj 82 472 h_multimap dampta; ! #X obj 79 726 h_multimap dampta; ! #X obj 481 721 h_multimap dampta; ! #X floatatom 136 782 5 0 0 0 - - -; ! #X text 111 263 add data to the multimap:; ! #X text 180 783 <- nr of values at the specific key; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 --- 204,221 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 62 pd General_Concept; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 *************** *** 279,322 **** added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 532 201 pd Container_Explanation; ! #X msg 481 635 getsize; ! #X text 568 648 outlet); ! #X text 546 634 <- get the size (at 3rd; ! #X obj 595 744 print size; ! #X connect 0 0 61 0; ! #X connect 9 0 63 0; ! #X connect 10 0 63 0; ! #X connect 11 0 63 0; ! #X connect 12 0 63 0; ! #X connect 13 0 63 0; ! #X connect 14 0 63 0; ! #X connect 15 0 63 0; ! #X connect 19 0 63 0; ! #X connect 33 0 61 0; ! #X connect 34 0 61 0; ! #X connect 35 0 61 0; ! #X connect 36 0 35 0; ! #X connect 37 0 35 0; ! #X connect 38 0 61 1; ! #X connect 39 0 61 1; ! #X connect 40 0 61 1; ! #X connect 41 0 61 1; ! #X connect 42 0 61 1; ! #X connect 46 0 49 0; ! #X connect 47 0 49 0; ! #X connect 49 0 62 0; ! #X connect 50 0 62 0; ! #X connect 51 0 62 0; ! #X connect 52 0 62 0; ! #X connect 53 0 55 0; ! #X connect 54 0 55 0; ! #X connect 55 0 62 0; ! #X connect 56 0 62 0; ! #X connect 57 0 62 0; ! #X connect 58 0 62 0; ! #X connect 61 0 17 0; ! #X connect 62 0 45 0; ! #X connect 62 1 64 0; ! #X connect 63 0 16 0; ! #X connect 63 2 71 0; ! #X connect 68 0 63 0; --- 285,422 ---- added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 518 90 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 116 pd Fileformats; ! #N canvas 174 18 646 317 read_save_possibilities 0; ! #X obj 50 258 outlet; ! #X msg 50 158 save data.dat; ! #X msg 50 194 read data.dat; ! #X text 155 158 <- save all the data of the current namespace as textfile ! ; ! #X text 149 194 <- read this textfile to the current namespace and ! insert it at the back (so the size will increase); ! #X text 173 83 <- read this XML-file to the current namespace and insert ! it at the back (so the size will increase); ! #X text 176 50 <- save all the data of the current namespace as XML-file ! ; ! #X msg 51 50 saveXML data.xml; ! #X msg 51 82 readXML data.xml; ! #X connect 1 0 0 0; ! #X connect 2 0 0 0; ! #X connect 7 0 0 0; ! #X connect 8 0 0 0; ! #X restore 479 515 pd read_save_possibilities; ! #X text 517 536 different possiblities to read; ! #X text 517 550 and write from and to files; ! #X text 516 564 (XML and textfiles); ! #X text 260 835 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 220 819 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #X connect 0 0 51 0; ! #X connect 5 0 53 0; ! #X connect 6 0 53 0; ! #X connect 7 0 53 0; ! #X connect 8 0 53 0; ! #X connect 9 0 53 0; ! #X connect 13 0 53 0; ! #X connect 23 0 51 0; ! #X connect 24 0 51 0; ! #X connect 25 0 51 0; ! #X connect 26 0 25 0; ! #X connect 27 0 25 0; ! #X connect 28 0 51 1; ! #X connect 29 0 51 1; ! #X connect 30 0 51 1; ! #X connect 31 0 51 1; ! #X connect 32 0 51 1; ! #X connect 36 0 39 0; ! #X connect 37 0 39 0; ! #X connect 39 0 52 0; ! #X connect 40 0 52 0; ! #X connect 41 0 52 0; ! #X connect 42 0 52 0; ! #X connect 43 0 45 0; ! #X connect 44 0 45 0; ! #X connect 45 0 52 0; ! #X connect 46 0 52 0; ! #X connect 47 0 52 0; ! #X connect 48 0 52 0; ! #X connect 51 0 11 0; ! #X connect 52 0 35 0; ! #X connect 52 1 54 0; ! #X connect 53 0 10 0; ! #X connect 53 2 60 0; ! #X connect 57 0 53 0; ! #X connect 66 0 53 0;
Index: help-h_list.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_list.pd,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** help-h_list.pd 18 Mar 2005 10:15:01 -0000 1.4 --- help-h_list.pd 5 May 2005 22:59:33 -0000 1.5 *************** *** 1,6 **** ! #N canvas 81 0 834 894 10; ! #X obj 525 58 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 527 60 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; --- 1,191 ---- ! #N canvas 535 40 834 864 10; ! #X obj 36 29 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 38 31 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 298 41 help file of; ! #X text 39 103 init arg: namespace; ! #X msg 483 298 print; ! #X msg 483 342 clear; ! #X msg 483 653 help; ! #X obj 604 712 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 483 239 getnamespace; ! #X msg 483 380 clearall; ! #X obj 483 769 print BBB; ! #X text 594 264 <- change namespace; ! #X msg 483 263 namespace grix; ! #X text 530 299 <- print all the data of the; ! #X text 549 314 current namespace; ! #X text 531 342 <- clear all the data of the; ! #X text 552 357 current namespace; ! #X text 551 382 <- clear all the data in all; ! #X text 572 397 same containers (maybe; ! #X text 574 412 you shouldn't use this); ! #X text 583 241 <- get current namespace; ! #X text 514 198 general operations:; ! #X msg 483 561 getsize; ! #X floatatom 523 749 5 0 0 0 - - -; ! #X text 570 574 outlet); ! #X text 290 58 ::: h_list :::; ! #X text 40 133 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X obj 483 691 h_list simonatbase; ! #X text 604 730 <- size of the list; ! #X obj 192 721 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 71 700 h_list simonatbase; ! #X obj 71 674 r $0-list; ! #X obj 71 739 print AAA; ! #N canvas 523 246 495 416 pusch_pop_back_front 0; ! #X msg 66 229 popback; ! #X floatatom 76 120 5 0 0 0 - - -; ! #X msg 66 140 pushback $1; ! #X text 180 140 <- inserts the data at the; ! #X symbolatom 121 120 10 0 0 0 - - -; ! #X msg 66 180 pushfront $1; ! #X floatatom 76 161 5 0 0 0 - - -; ! #X symbolatom 119 161 10 0 0 0 - - -; ! #X msg 66 252 popfront; ! #X msg 66 302 back; ! #X msg 66 324 front; ! #X obj 66 367 s $0-list; ! #X text 200 155 front/back of the list; ! #X text 152 244 the back/front; ! #X text 130 231 <- removes the element from; ! #X text 143 316 the back/front; ! #X text 121 301 <- gives out the element from; ! #X text 27 28 insert/remove/get data at the back/front of the list. ! ; ! #X text 27 44 These methods won't change the current iterator position ! !!!; ! #X connect 0 0 11 0; ! #X connect 1 0 2 0; ! #X connect 2 0 11 0; ! #X connect 4 0 2 0; ! #X connect 5 0 11 0; ! #X connect 6 0 5 0; ! #X connect 7 0 5 0; ! #X connect 8 0 11 0; ! #X connect 9 0 11 0; ! #X connect 10 0 11 0; ! #X restore 136 494 pd pusch_pop_back_front; ! #X text 40 452 insert/remove/get data at the back/front of the list ! ,; ! #X text 43 247 You can use so called "iterators" to navigate through ! ; ! #X text 40 468 _without_ changing the current iterator position:; ! #N canvas 843 44 493 562 iterator_navigation 0; ! #X text 39 73 Iterators are a generalization of pointers: they are ! objects that point to other objects. Via an iterator you can navigate ! through the container. You can ask a list for an iterator that points ! to the first element with the message begin. You can get a past-the-end ! iterator with the message end.; ! #X text 182 35 ::: ITERATORS :::; ! #X msg 43 216 begin; ! #X msg 43 321 next; ! #X text 40 179 iterator navigation:; ! #X obj 43 505 s $0-list; ! #X text 91 217 <- points to the first element fo the h_list; ! #X text 87 244 <- points _after_ the last element of the h_list; ! #X text 94 259 (so that you can insert data there for example ,; ! #X text 99 274 but attention: you can't remove an element at; ! #X text 98 289 that position !!!); ! #X text 85 321 <- increment the iterator - so it will point to; ! #X text 107 335 the next element of h_list; ! #X msg 43 244 end; ! #X msg 43 357 last; ! #X text 84 358 <- decrement the iterator - so it will point to; ! #X text 106 372 the previous element of h_list; ! #X msg 43 400 getiter; ! #X text 113 401 <- puts out the current iterator position; ! #X text 134 416 at second outlet; ! #X msg 57 467 setiter $1; ! #X floatatom 57 448 5 0 0 0 - - -; ! #X text 147 467 <- set specific iterator position; ! #X connect 2 0 5 0; ! #X connect 3 0 5 0; ! #X connect 13 0 5 0; ! #X connect 14 0 5 0; ! #X connect 17 0 5 0; ! #X connect 20 0 5 0; ! #X connect 21 0 20 0; ! #X restore 137 303 pd iterator_navigation; ! #X text 43 261 the h_list. Here is a short explanation of iterators ! ; ! #X text 43 275 and how you can use it in with h_list:; ! #X text 45 364 operations at a specific iterator position:; ! #N canvas 0 469 468 430 iterator_operations 0; ! #X obj 54 389 s $0-list; ! #X msg 54 283 delete; ! #X msg 54 113 insert $1; ! #X floatatom 54 92 5 0 0 0 - - -; ! #X msg 54 338 get; ! #X symbolatom 100 92 10 0 0 0 - - -; ! #X text 48 33 Operations at a specific iterator position :; ! #X msg 54 137 insert bla sdflj 34 fd; ! #X text 235 126 current iterator position; ! #X text 212 111 <- inserts the data at the; ! #X text 139 299 current iterator position; ! #X text 116 284 <- deletes the data at the; ! #X text 138 355 current iterator position; ! #X text 115 340 <- get the data at the; ! #X msg 54 230 modify hallo da du; ! #X floatatom 68 171 5 0 0 0 - - -; ! #X symbolatom 68 189 10 0 0 0 - - -; ! #X msg 54 208 modify $1; ! #X text 211 188 <- modifies the data at the; ! #X text 232 203 current iterator position; ! #X text 231 219 (it overrides the data); ! #X connect 1 0 0 0; ! #X connect 2 0 0 0; ! #X connect 3 0 2 0; ! #X connect 4 0 0 0; ! #X connect 5 0 2 0; ! #X connect 7 0 0 0; ! #X connect 14 0 0 0; ! #X connect 15 0 17 0; ! #X connect 16 0 17 0; ! #X connect 17 0 0 0; ! #X restore 138 388 pd iterator_operations; ! #X text 39 550 special operations with h_list:; ! #N canvas 705 269 550 449 special_operations 0; ! #X msg 54 289 unique; ! #X msg 54 237 reverse; ! #X msg 54 189 sort; ! #X obj 54 369 s $0-list; ! #X text 30 28 special operations with h_list:; ! #X floatatom 54 92 5 0 0 0 - - -; ! #X symbolatom 100 92 10 0 0 0 - - -; ! #X msg 54 113 remove $1; ! #X msg 54 137 remove bla sdflj 34 fd; ! #X text 212 111 <- removes the element with; ! #X text 235 126 the given data; ! #X text 124 237 <- reverses the h_list; ! #X text 102 190 <- sorts the h_list; ! #X text 113 289 <- Removes all but the first element in every consecutive ! group of equal elements. The relative order of elements that are not ! removed is unchanged.; ! #X connect 0 0 3 0; ! #X connect 1 0 3 0; ! #X connect 2 0 3 0; ! #X connect 5 0 7 0; ! #X connect 6 0 7 0; ! #X connect 7 0 3 0; ! #X connect 8 0 3 0; ! #X restore 134 578 pd special_operations; ! #X text 217 720 <- bang if not found; ! #X floatatom 563 730 5 0 0 0 - - -; ! #X text 565 750 <- current iterator position; ! #X floatatom 151 721 5 0 0 0 - - -; ! #X floatatom 111 721 5 0 0 0 - - -; ! #X msg 483 604 getiter; ! #X text 548 560 <- get the size (at 3nd; ! #X text 574 620 (2nd outlet); ! #X text 553 605 <- get current iterator pos; ! #X obj 500 28 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 502 30 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; *************** *** 46,51 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 231,234 ---- *************** *** 76,87 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 259,270 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 99,109 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 282,290 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 115,129 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 296,317 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 134,174 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 561 97 pd General_Concept; ! #X obj 49 38 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 51 40 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 311 50 help file of; ! #X text 194 842 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 52 112 init arg: namespace; ! #X msg 496 307 print; ! #X msg 496 351 clear; ! #X msg 496 662 help; ! #X obj 617 721 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 496 248 getnamespace; ! #X msg 496 389 clearall; ! #X obj 496 778 print BBB; ! #X text 607 273 <- change namespace; ! #X msg 496 272 namespace grix; ! #X text 543 308 <- print all the data of the; ! #X text 562 323 current namespace; ! #X text 544 351 <- clear all the data of the; ! #X text 565 366 current namespace; ! #X text 564 391 <- clear all the data in all; ! #X text 585 406 same containers (maybe; ! #X text 587 421 you shouldn't use this); ! #X text 601 454 <- save all the data of; ! #X text 598 469 current namespac to disk; ! #X text 595 495 <- read this file to; ! #X text 596 250 <- get current namespace; ! #X text 527 207 general operations:; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 --- 322,339 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 66 pd General_Concept; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 *************** *** 238,424 **** added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 543 128 pd Container_Explanation; ! #X msg 496 570 getsize; ! #X text 609 509 current namespace and; ! #X msg 496 454 save data.dat; ! #X msg 496 495 read data.dat; ! #X floatatom 536 758 5 0 0 0 - - -; ! #X text 583 583 outlet); ! #X text 303 67 ::: h_list :::; ! #X text 53 142 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X text 609 523 add it at the current; ! #X text 610 537 iterator position; ! #X obj 496 700 h_list simonatbase; ! #X text 617 739 <- size of the list; ! #X obj 205 730 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 84 709 h_list simonatbase; ! #X obj 84 683 r $0-list; ! #X obj 84 748 print AAA; ! #N canvas 523 246 495 416 pusch_pop_back_front 0; ! #X msg 66 229 popback; ! #X floatatom 76 120 5 0 0 0 - - -; ! #X msg 66 140 pushback $1; ! #X text 180 140 <- inserts the data at the; ! #X symbolatom 121 120 10 0 0 0 - - -; ! #X msg 66 180 pushfront $1; ! #X floatatom 76 161 5 0 0 0 - - -; ! #X symbolatom 119 161 10 0 0 0 - - -; ! #X msg 66 252 popfront; ! #X msg 66 302 back; ! #X msg 66 324 front; ! #X obj 66 367 s $0-list; ! #X text 200 155 front/back of the list; ! #X text 152 244 the back/front; ! #X text 130 231 <- removes the element from; ! #X text 143 316 the back/front; ! #X text 121 301 <- gives out the element from; ! #X text 27 28 insert/remove/get data at the back/front of the list. ; ! #X text 27 44 These methods won't change the current iterator position ! !!!; ! #X connect 0 0 11 0; ! #X connect 1 0 2 0; ! #X connect 2 0 11 0; ! #X connect 4 0 2 0; ! #X connect 5 0 11 0; ! #X connect 6 0 5 0; ! #X connect 7 0 5 0; ! #X connect 8 0 11 0; ! #X connect 9 0 11 0; ! #X connect 10 0 11 0; ! #X restore 149 503 pd pusch_pop_back_front; ! #X text 53 461 insert/remove/get data at the back/front of the list ! ,; ! #X text 56 256 You can use so called "iterators" to navigate through ; ! #X text 53 477 _without_ changing the current iterator position:; ! #N canvas 843 44 493 562 iterator_navigation 0; ! #X text 39 73 Iterators are a generalization of pointers: they are ! objects that point to other objects. Via an iterator you can navigate ! through the container. You can ask a list for an iterator that points ! to the first element with the message begin. You can get a past-the-end ! iterator with the message end.; ! #X text 182 35 ::: ITERATORS :::; ! #X msg 43 216 begin; ! #X msg 43 321 next; ! #X text 40 179 iterator navigation:; ! #X obj 43 505 s $0-list; ! #X text 91 217 <- points to the first element fo the h_list; ! #X text 87 244 <- points _after_ the last element of the h_list; ! #X text 94 259 (so that you can insert data there for example ,; ! #X text 99 274 but attention: you can't remove an element at; ! #X text 98 289 that position !!!); ! #X text 85 321 <- increment the iterator - so it will point to; ! #X text 107 335 the next element of h_list; ! #X msg 43 244 end; ! #X msg 43 357 last; ! #X text 84 358 <- decrement the iterator - so it will point to; ! #X text 106 372 the previous element of h_list; ! #X msg 43 400 getiter; ! #X text 113 401 <- puts out the current iterator position; ! #X text 134 416 at second outlet; ! #X msg 57 467 setiter $1; ! #X floatatom 57 448 5 0 0 0 - - -; ! #X text 147 467 <- set specific iterator position; ! #X connect 2 0 5 0; ! #X connect 3 0 5 0; ! #X connect 13 0 5 0; ! #X connect 14 0 5 0; ! #X connect 17 0 5 0; ! #X connect 20 0 5 0; ! #X connect 21 0 20 0; ! #X restore 150 312 pd iterator_navigation; ! #X text 56 270 the h_list. Here is a short explanation of iterators ; ! #X text 56 284 and how you can use it in with h_list:; ! #X text 58 373 operations at a specific iterator position:; ! #N canvas 0 469 468 430 iterator_operations 0; ! #X obj 54 389 s $0-list; ! #X msg 54 283 delete; ! #X msg 54 113 insert $1; ! #X floatatom 54 92 5 0 0 0 - - -; ! #X msg 54 338 get; ! #X symbolatom 100 92 10 0 0 0 - - -; ! #X text 48 33 Operations at a specific iterator position :; ! #X msg 54 137 insert bla sdflj 34 fd; ! #X text 235 126 current iterator position; ! #X text 212 111 <- inserts the data at the; ! #X text 139 299 current iterator position; ! #X text 116 284 <- deletes the data at the; ! #X text 138 355 current iterator position; ! #X text 115 340 <- get the data at the; ! #X msg 54 230 modify hallo da du; ! #X floatatom 68 171 5 0 0 0 - - -; ! #X symbolatom 68 189 10 0 0 0 - - -; ! #X msg 54 208 modify $1; ! #X text 211 188 <- modifies the data at the; ! #X text 232 203 current iterator position; ! #X text 231 219 (it overrides the data); #X connect 1 0 0 0; #X connect 2 0 0 0; - #X connect 3 0 2 0; - #X connect 4 0 0 0; - #X connect 5 0 2 0; #X connect 7 0 0 0; ! #X connect 14 0 0 0; ! #X connect 15 0 17 0; ! #X connect 16 0 17 0; ! #X connect 17 0 0 0; ! #X restore 151 397 pd iterator_operations; ! #X text 52 559 special operations with h_list:; ! #N canvas 705 269 550 449 special_operations 0; ! #X msg 54 289 unique; ! #X msg 54 237 reverse; ! #X msg 54 189 sort; ! #X obj 54 369 s $0-list; ! #X text 30 28 special operations with h_list:; ! #X floatatom 54 92 5 0 0 0 - - -; ! #X symbolatom 100 92 10 0 0 0 - - -; ! #X msg 54 113 remove $1; ! #X msg 54 137 remove bla sdflj 34 fd; ! #X text 212 111 <- removes the element with; ! #X text 235 126 the given data; ! #X text 124 237 <- reverses the h_list; ! #X text 102 190 <- sorts the h_list; ! #X text 113 289 <- Removes all but the first element in every consecutive ! group of equal elements. The relative order of elements that are not ! removed is unchanged.; ! #X connect 0 0 3 0; ! #X connect 1 0 3 0; ! #X connect 2 0 3 0; ! #X connect 5 0 7 0; ! #X connect 6 0 7 0; ! #X connect 7 0 3 0; ! #X connect 8 0 3 0; ! #X restore 147 587 pd special_operations; ! #X text 230 729 <- bang if not found; ! #X floatatom 576 739 5 0 0 0 - - -; ! #X text 578 759 <- current iterator position; ! #X floatatom 164 730 5 0 0 0 - - -; ! #X floatatom 124 730 5 0 0 0 - - -; ! #X msg 496 613 getiter; ! #X text 561 569 <- get the size (at 3nd; ! #X text 587 629 (2nd outlet); ! #X text 566 614 <- get current iterator pos; ! #X connect 8 0 40 0; ! #X connect 9 0 40 0; ! #X connect 10 0 40 0; ! #X connect 12 0 40 0; ! #X connect 13 0 40 0; ! #X connect 16 0 40 0; ! #X connect 30 0 40 0; ! #X connect 32 0 40 0; ! #X connect 33 0 40 0; ! #X connect 40 0 14 0; ! #X connect 40 1 34 0; ! #X connect 40 2 58 0; ! #X connect 40 3 11 0; ! #X connect 43 0 45 0; ! #X connect 43 1 61 0; ! #X connect 43 2 60 0; ! #X connect 43 3 42 0; ! #X connect 44 0 43 0; ! #X connect 62 0 40 0; --- 403,522 ---- added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 518 94 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 120 pd Fileformats; ! #N canvas 174 18 646 317 read_save_possibilities 0; ! #X obj 50 258 outlet; ! #X msg 50 158 save data.dat; ! #X msg 50 194 read data.dat; ! #X text 155 158 <- save all the data of the current namespace as textfile ; ! #X text 149 194 <- read this textfile to the current namespace and ! insert it at the back (so the size will increase); ! #X text 173 83 <- read this XML-file to the current namespace and insert ! it at the back (so the size will increase); ! #X text 176 50 <- save all the data of the current namespace as XML-file ! ; ! #X msg 51 50 saveXML data.xml; ! #X msg 51 82 readXML data.xml; #X connect 1 0 0 0; #X connect 2 0 0 0; #X connect 7 0 0 0; ! #X connect 8 0 0 0; ! #X restore 483 459 pd read_save_possibilities; ! #X text 523 483 different possiblities to read; ! #X text 523 497 and write from and to files; ! #X text 522 512 (XML and textfiles); ! #X text 234 821 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 194 805 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #X connect 4 0 27 0; ! #X connect 5 0 27 0; ! #X connect 6 0 27 0; ! #X connect 8 0 27 0; ! #X connect 9 0 27 0; ! #X connect 12 0 27 0; ! #X connect 22 0 27 0; ! #X connect 27 0 10 0; ! #X connect 27 1 23 0; ! #X connect 27 2 45 0; ! #X connect 27 3 7 0; ! #X connect 30 0 32 0; ! #X connect 30 1 48 0; ! #X connect 30 2 47 0; ! #X connect 30 3 29 0; ! #X connect 31 0 30 0; ! #X connect 49 0 27 0; ! #X connect 58 0 27 0;
Index: help-h_multiset.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_multiset.pd,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** help-h_multiset.pd 29 Oct 2004 11:56:13 -0000 1.2 --- help-h_multiset.pd 5 May 2005 22:59:33 -0000 1.3 *************** *** 1,7 **** ! #N canvas 157 0 817 875 10; #X msg 154 388 add ge; ! #X obj 514 131 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 516 133 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; --- 1,64 ---- ! #N canvas 0 0 817 875 10; #X msg 154 388 add ge; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 37 100 init arg: namespace; ! #X msg 470 377 print; ! #X msg 470 421 clear; ! #X msg 470 642 help; ! #X msg 470 318 getnamespace; ! #X msg 470 459 clearall; ! #X text 581 343 <- change namespace; ! #X msg 470 342 namespace grix; ! #X text 517 378 <- print all the data of the; ! #X text 536 393 current namespace; ! #X text 518 421 <- clear all the data of the; ! #X text 539 436 current namespace; ! #X text 538 461 <- clear all the data in all; ! #X text 559 476 same containers (maybe; ! #X text 561 491 you shouldn't use this); ! #X text 570 320 <- get current namespace; ! #X text 469 266 general operations:; ! #X msg 154 362 add bla bal tuff; ! #X msg 154 412 add 4 f 3; ! #X msg 154 337 add $1; ! #X floatatom 154 299 5 0 0 0 - - -; ! #X symbolatom 201 301 10 0 0 0 - - -; ! #X floatatom 84 578 5 0 0 0 - - -; ! #X symbolatom 131 580 10 0 0 0 - - -; ! #X text 139 544 get , remove data:; ! #X msg 84 616 get $1; ! #X msg 84 641 get bla bal tuff; ! #X msg 84 667 get ge; ! #X msg 84 691 get 4 f 3; ! #X floatatom 227 582 5 0 0 0 - - -; ! #X symbolatom 274 584 10 0 0 0 - - -; ! #X msg 227 620 remove $1; ! #X msg 227 645 remove bla bal tuff; ! #X msg 227 671 remove ge; ! #X msg 227 695 remove 4 f 3; ! #X floatatom 84 757 5 0 0 0 - - -; ! #X floatatom 470 696 5 0 0 0 - - -; ! #X floatatom 154 477 5 0 0 0 - - -; ! #X text 275 52 ::: h_multiset :::; ! #X obj 154 453 h_multiset $0-pscht; ! #X obj 84 731 h_multiset $0-pscht; ! #X obj 470 673 h_multiset $0-pscht; ! #X text 131 757 <- the number how often the data is set; ! #X text 37 137 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X text 140 268 add data to the multiset:; ! #X msg 470 605 getsize; ! #X text 535 604 <- get the size (at 2nd; ! #X text 557 618 outlet); ! #X obj 598 695 print size; ! #X obj 500 24 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 502 26 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; *************** *** 47,52 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 104,107 ---- *************** *** 77,88 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 132,143 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 100,110 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 155,163 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 116,130 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 169,190 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 135,204 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 550 170 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 295 36 help file of; ! #X text 213 828 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 37 100 init arg: namespace; ! #X msg 474 411 print; ! #X msg 474 455 clear; ! #X msg 474 676 help; ! #X msg 474 352 getnamespace; ! #X msg 474 493 clearall; ! #X text 585 377 <- change namespace; ! #X msg 474 376 namespace grix; ! #X text 521 412 <- print all the data of the; ! #X text 540 427 current namespace; ! #X text 522 455 <- clear all the data of the; ! #X text 543 470 current namespace; ! #X text 542 495 <- clear all the data in all; ! #X text 563 510 same containers (maybe; ! #X text 565 525 you shouldn't use this); ! #X text 575 559 <- save all the data of; ! #X text 572 574 current namespac to disk; ! #X text 573 599 <- read this file to; ! #X text 594 613 current namespace; ! #X text 574 354 <- get current namespace; ! #X text 473 300 general operations:; ! #X msg 154 362 add bla bal tuff; ! #X msg 154 412 add 4 f 3; ! #X msg 154 337 add $1; ! #X floatatom 154 299 5 0 0 0 - - -; ! #X symbolatom 201 301 10 0 0 0 - - -; ! #X floatatom 84 578 5 0 0 0 - - -; ! #X symbolatom 131 580 10 0 0 0 - - -; ! #X text 139 544 get , remove data:; ! #X msg 84 616 get $1; ! #X msg 84 641 get bla bal tuff; ! #X msg 84 667 get ge; ! #X msg 84 691 get 4 f 3; ! #X floatatom 227 582 5 0 0 0 - - -; ! #X symbolatom 274 584 10 0 0 0 - - -; ! #X msg 227 620 remove $1; ! #X msg 227 645 remove bla bal tuff; ! #X msg 227 671 remove ge; ! #X msg 227 695 remove 4 f 3; ! #X floatatom 84 757 5 0 0 0 - - -; ! #X floatatom 474 730 5 0 0 0 - - -; ! #X floatatom 154 477 5 0 0 0 - - -; ! #X text 275 52 ::: h_multiset :::; ! #X obj 154 453 h_multiset $0-pscht; ! #X obj 84 731 h_multiset $0-pscht; ! #X obj 474 707 h_multiset $0-pscht; ! #X text 131 757 <- the number how often the data is set; ! #X text 37 137 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X text 140 268 add data to the multiset:; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 --- 195,212 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 62 pd General_Concept; #N canvas 205 0 993 742 Container_Explanation 0; #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 *************** *** 268,307 **** added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 532 201 pd Container_Explanation; ! #X msg 474 558 save set.dat; ! #X msg 474 599 read set.dat; ! #X msg 474 639 getsize; ! #X text 539 638 <- get the size (at 2nd; ! #X text 561 652 outlet); ! #X obj 602 729 print size; ! #X connect 0 0 51 0; ! #X connect 9 0 53 0; ! #X connect 10 0 53 0; ! #X connect 11 0 53 0; ! #X connect 12 0 53 0; ! #X connect 13 0 53 0; ! #X connect 15 0 53 0; ! #X connect 29 0 51 0; ! #X connect 30 0 51 0; ! #X connect 31 0 51 0; ! #X connect 32 0 31 0; ! #X connect 33 0 31 0; ! #X connect 34 0 37 0; ! #X connect 35 0 37 0; ! #X connect 37 0 52 0; ! #X connect 38 0 52 0; ! #X connect 39 0 52 0; ! #X connect 40 0 52 0; ! #X connect 41 0 43 0; ! #X connect 42 0 43 0; ! #X connect 43 0 52 0; ! #X connect 44 0 52 0; ! #X connect 45 0 52 0; ! #X connect 46 0 52 0; ! #X connect 51 0 49 0; ! #X connect 52 0 47 0; ! #X connect 53 0 48 0; ! #X connect 53 1 63 0; ! #X connect 58 0 53 0; ! #X connect 59 0 53 0; ! #X connect 60 0 53 0; --- 276,407 ---- added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 518 90 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 116 pd Fileformats; ! #N canvas 174 18 646 317 read_save_possibilities 0; ! #X obj 50 258 outlet; ! #X msg 50 158 save data.dat; ! #X msg 50 194 read data.dat; ! #X text 155 158 <- save all the data of the current namespace as textfile ! ; ! #X text 149 194 <- read this textfile to the current namespace and ! insert it at the back (so the size will increase); ! #X text 173 83 <- read this XML-file to the current namespace and insert ! it at the back (so the size will increase); ! #X text 176 50 <- save all the data of the current namespace as XML-file ! ; ! #X msg 51 50 saveXML data.xml; ! #X msg 51 82 readXML data.xml; ! #X connect 1 0 0 0; ! #X connect 2 0 0 0; ! #X connect 7 0 0 0; ! #X connect 8 0 0 0; ! #X restore 470 524 pd read_save_possibilities; ! #X text 508 545 different possiblities to read; ! #X text 508 559 and write from and to files; ! #X text 507 573 (XML and textfiles); ! #X text 244 827 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 204 811 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #X connect 0 0 43 0; ! #X connect 5 0 45 0; ! #X connect 6 0 45 0; ! #X connect 7 0 45 0; ! #X connect 8 0 45 0; ! #X connect 9 0 45 0; ! #X connect 11 0 45 0; ! #X connect 21 0 43 0; ! #X connect 22 0 43 0; ! #X connect 23 0 43 0; ! #X connect 24 0 23 0; ! #X connect 25 0 23 0; ! #X connect 26 0 29 0; ! #X connect 27 0 29 0; ! #X connect 29 0 44 0; ! #X connect 30 0 44 0; ! #X connect 31 0 44 0; ! #X connect 32 0 44 0; ! #X connect 33 0 35 0; ! #X connect 34 0 35 0; ! #X connect 35 0 44 0; ! #X connect 36 0 44 0; ! #X connect 37 0 44 0; ! #X connect 38 0 44 0; ! #X connect 43 0 41 0; ! #X connect 44 0 39 0; ! #X connect 45 0 40 0; ! #X connect 45 1 52 0; ! #X connect 49 0 45 0; ! #X connect 58 0 45 0;
Index: help-h_deque.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_deque.pd,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -C2 -d -r1.1.1.1 -r1.2 *** help-h_deque.pd 25 Oct 2004 19:02:32 -0000 1.1.1.1 --- help-h_deque.pd 5 May 2005 22:59:33 -0000 1.2 *************** *** 2,8 **** #X obj 147 379 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 509 44 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 511 46 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; --- 2,8 ---- #X obj 147 379 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 498 23 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 0; ! #X obj 500 25 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 -143491 0; #N canvas 674 0 511 843 General_Concept 0; *************** *** 48,53 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 48,51 ---- *************** *** 78,89 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 76,87 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 101,111 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 99,107 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 117,131 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 113,134 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 136,146 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 545 83 pd General_Concept; #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; --- 139,156 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 534 61 pd General_Concept; #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; *************** *** 148,162 **** -66577 0; #X text 295 36 help file of; - #X text 194 830 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at - , 2004; #X text 36 98 init arg: namespace; #X msg 480 293 print; #X msg 480 337 clear; ! #X msg 480 681 help; ! #X obj 558 732 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; #X msg 480 234 getnamespace; #X msg 480 375 clearall; ! #X obj 480 780 print BBB; #X obj 68 380 print AAA; #X text 591 259 <- change namespace; --- 158,170 ---- -66577 0; #X text 295 36 help file of; #X text 36 98 init arg: namespace; #X msg 480 293 print; #X msg 480 337 clear; ! #X msg 480 637 help; ! #X obj 559 688 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; #X msg 480 234 getnamespace; #X msg 480 375 clearall; ! #X obj 480 736 print BBB; #X obj 68 380 print AAA; #X text 591 259 <- change namespace; *************** *** 169,175 **** #X text 569 392 same containers (maybe; #X text 571 407 you shouldn't use this); - #X text 585 440 <- save all the data of; - #X text 582 455 current namespac to disk; - #X text 579 481 <- read this file to; #X text 580 236 <- get current namespace; #X text 512 193 general operations:; --- 177,180 ---- *************** *** 247,267 **** added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 527 114 pd Container_Explanation; ! #X msg 480 618 resize $1; ! #X msg 480 652 getsize; ! #X text 593 495 current namespace and; ! #X text 592 509 it at the back (so the; ! #X text 593 524 size will increase); ! #X msg 480 440 save data.dat; ! #X msg 480 481 read data.dat; ! #X msg 480 547 readat data.dat 0; ! #X text 614 547 <- read the file at; ! #X text 635 563 the given index; ! #X text 624 579 (so that the size; ! #X text 625 593 won't increase); ! #X floatatom 488 590 5 0 0 0 - - -; ! #X floatatom 519 751 5 0 0 0 - - -; ! #X text 545 651 <- get the size (at 2nd; ! #X text 567 665 outlet); #X msg 68 290 get $1; #X floatatom 74 269 5 0 0 0 - - -; --- 252,262 ---- added (push). Top outputs the elements from the top without removing it , pop outputs and removes it.; ! #X restore 516 89 pd Container_Explanation; ! #X msg 480 574 resize $1; ! #X msg 480 608 getsize; ! #X floatatom 488 546 5 0 0 0 - - -; ! #X floatatom 519 707 5 0 0 0 - - -; ! #X text 545 607 <- get the size (at 2nd; ! #X text 567 621 outlet); #X msg 68 290 get $1; #X floatatom 74 269 5 0 0 0 - - -; *************** *** 296,302 **** #X obj 70 776 h_deque havi; #X obj 69 619 h_deque havi; ! #X obj 480 708 h_deque havi; ! #X text 560 752 <- size of deque; ! #X text 556 619 <- resizes the deque; #X text 187 702 Thats not very fast with a deque!; #X msg 69 489 pushfront $1; --- 291,297 ---- #X obj 70 776 h_deque havi; #X obj 69 619 h_deque havi; ! #X obj 480 664 h_deque havi; ! #X text 560 708 <- size of deque; ! #X text 556 575 <- resizes the deque; #X text 187 702 Thats not very fast with a deque!; #X msg 69 489 pushfront $1; *************** *** 313,356 **** #X text 146 586 back/front; #X obj 69 641 print CCC; ! #X connect 9 0 82 0; ! #X connect 10 0 82 0; ! #X connect 11 0 82 0; ! #X connect 13 0 82 0; ! #X connect 14 0 82 0; ! #X connect 18 0 82 0; ! #X connect 31 0 79 1; ! #X connect 32 0 79 1; ! #X connect 33 0 79 1; ! #X connect 34 0 79 1; ! #X connect 35 0 79 1; ! #X connect 38 0 82 0; ! #X connect 39 0 82 0; ! #X connect 43 0 82 0; ! #X connect 44 0 82 0; ! #X connect 45 0 82 0; ! #X connect 50 0 38 0; ! #X connect 54 0 79 0; ! #X connect 55 0 54 0; ! #X connect 56 0 57 0; ! #X connect 57 0 79 0; ! #X connect 58 0 80 0; ! #X connect 59 0 58 0; ! #X connect 60 0 61 0; ! #X connect 61 0 80 0; ! #X connect 67 0 81 0; ! #X connect 68 0 69 0; ! #X connect 69 0 81 0; ! #X connect 71 0 80 1; ! #X connect 76 0 69 0; ! #X connect 79 0 16 0; ! #X connect 79 2 0 0; ! #X connect 81 0 98 0; ! #X connect 82 0 15 0; ! #X connect 82 1 51 0; ! #X connect 82 2 12 0; ! #X connect 86 0 81 0; ! #X connect 87 0 86 0; ! #X connect 88 0 86 0; ! #X connect 89 0 81 0; ! #X connect 90 0 81 0; ! #X connect 91 0 81 0; --- 308,456 ---- #X text 146 586 back/front; #X obj 69 641 print CCC; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 548 115 pd Fileformats; ! #N canvas 174 18 646 402 read_save_possibilities 0; ! #X obj 44 336 outlet; ! #X msg 44 208 save data.dat; ! #X msg 44 244 read data.dat; ! #X msg 44 288 readat data.dat 0; ! #X text 149 208 <- save all the data of the current namespace as textfile ! ; ! #X text 143 244 <- read this textfile to the current namespace and ! insert it at the back (so the size will increase); ! #X text 177 287 <- read the textfile and insert it at the given index ! (so the size won't increase !); ! #X text 166 94 <- read this XML-file to the current namespace and insert ! it at the back (so the size will increase); ! #X text 169 61 <- save all the data of the current namespace as XML-file ! ; ! #X text 196 139 <- read the XML-file and insert it at the given index ! (so the size won't increase !); ! #X msg 44 61 saveXML data.xml; ! #X msg 44 93 readXML data.xml; ! #X msg 44 139 readatXML data.xml 0; ! #X connect 1 0 0 0; ! #X connect 2 0 0 0; ! #X connect 3 0 0 0; ! #X connect 10 0 0 0; ! #X connect 11 0 0 0; ! #X connect 12 0 0 0; ! #X restore 480 456 pd read_save_possibilities; ! #X text 520 480 different possiblities to read; ! #X text 520 494 and write from and to files; ! #X text 519 509 (XML and textfiles); ! #X text 216 844 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 180 827 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2005; ! #X connect 8 0 68 0; ! #X connect 9 0 68 0; ! #X connect 10 0 68 0; ! #X connect 12 0 68 0; ! #X connect 13 0 68 0; ! #X connect 17 0 68 0; ! #X connect 27 0 65 1; ! #X connect 28 0 65 1; ! #X connect 29 0 65 1; ! #X connect 30 0 65 1; ! #X connect 31 0 65 1; ! #X connect 34 0 68 0; ! #X connect 35 0 68 0; ! #X connect 36 0 34 0; ! #X connect 40 0 65 0; ! #X connect 41 0 40 0; ! #X connect 42 0 43 0; ! #X connect 43 0 65 0; ! #X connect 44 0 66 0; ! #X connect 45 0 44 0; ! #X connect 46 0 47 0; ! #X connect 47 0 66 0; ! #X connect 53 0 67 0; ! #X connect 54 0 55 0; ! #X connect 55 0 67 0; ! #X connect 57 0 66 1; ! #X connect 62 0 55 0; ! #X connect 65 0 15 0; ! #X connect 65 2 0 0; ! #X connect 67 0 84 0; ! #X connect 68 0 14 0; ! #X connect 68 1 37 0; ! #X connect 68 2 11 0; ! #X connect 72 0 67 0; ! #X connect 73 0 72 0; ! #X connect 74 0 72 0; ! #X connect 75 0 67 0; ! #X connect 76 0 67 0; ! #X connect 77 0 67 0; ! #X connect 86 0 68 0;
Index: help-h_queue.pd =================================================================== RCS file: /cvsroot/pure-data/externals/PDContainer/help/help-h_queue.pd,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -C2 -d -r1.1.1.1 -r1.2 *** help-h_queue.pd 25 Oct 2004 19:02:32 -0000 1.1.1.1 --- help-h_queue.pd 5 May 2005 22:59:34 -0000 1.2 *************** *** 1,77 **** ! #N canvas 414 45 794 745 10; #X obj 154 536 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 516 108 cnv 15 204 104 empty empty empty 20 12 0 14 -66577 -66577 ! 0; ! #X obj 518 110 cnv 15 200 100 empty empty ReadMe: 65 15 0 14 -262131 ! -143491 0; ! #N canvas 205 0 993 742 Container_Explanation 0; ! #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 16 15 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 254 23 general explation of; ! #X text 254 40 the datastructures; ! #X text 23 655 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ! ; ! #X obj 189 627 h_vector; ! #X text 500 654 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X obj 680 628 h_list; ! #X obj 189 773 h_deque; ! #X text 498 801 A queue is a "first in first out" (FIFO) data structure. That is , elements are added to the back of the queue (push) and may be removed from the front (pop).; ! #X obj 679 774 h_queue; ! #X text 22 951 A priority queue is also a "first in first out" (FIFO) ! data structure , but you can give the elements a priority. So the ! elements with a higher priority are automatically inserted before all ! other elements with a lower priority.; ! #X obj 154 924 h_priority_queue; ! #X text 20 800 A deque (double ended queue , pronounced "deck") is ! very much like a vector: like vector , it is a sequence that supports ! access to all elements via index. The main way in which deque differs ! from vector is that fast insertion and removal of elements is possible ! at the beginning _and_ the end.; ! #X text 22 232 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X obj 188 203 h_map; ! #X text 492 231 Multimaps are just like maps except that a key can ! be associated with several values. Multimap is a Sorted Associative ! Container and also a Multiple Associative Container , meaning that ! there is no limit on the number of elements with the same key. (see ! also Map); ! #X obj 643 201 h_multimap; ! #X text 24 419 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X obj 187 392 h_set; ! #X text 493 419 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X obj 642 391 h_multiset; ! #X text 339 167 :::: ASSOCIATIVE CONTAINERS ::::; ! #X text 393 592 :::: SEQUENCES ::::; ! #X text 289 1099 (look for help at all the objects for more information) ! ; ! #X text 35 87 PDContainer contains the following datastructures:; ! #X text 399 86 map , nultimap , set , multiset , vector , list ! , deque , queue , stack , priority queue; ! #X obj 679 916 h_stack; ! #X text 495 950 Stack is a "last in first out" (LIFO) data structure: ! the element at the top of a stack is the one that was most recently ! added (push). Top outputs the elements from the top without removing ! it , pop outputs and removes it.; ! #X restore 534 178 pd Container_Explanation; #N canvas 674 0 511 843 General_Concept 0; #X text 37 165 This library was made for algorithmic composition and --- 1,56 ---- ! #N canvas 529 37 794 742 10; #X obj 154 536 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 -1; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 295 36 help file of; ! #X text 40 98 init arg: namespace; ! #X msg 430 438 clear; ! #X msg 430 532 help; ! #X obj 502 587 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 430 335 getnamespace; ! #X msg 430 476 clearall; ! #X obj 430 630 print BBB; ! #X obj 82 579 print AAA; ! #X text 541 360 <- change namespace; ! #X msg 430 359 namespace grix; ! #X text 478 438 <- clear all the data of the; ! #X text 499 453 current namespace; ! #X text 498 478 <- clear all the data in all; ! #X text 519 493 same containers (maybe; ! #X text 521 508 you shouldn't use this); ! #X text 530 337 <- get current namespace; ! #X text 429 283 general operations:; ! #X floatatom 466 606 5 0 0 0 - - -; ! #X floatatom 118 556 5 0 0 0 - - -; ! #X msg 430 391 getsize; ! #X text 493 391 <- puts out the size of the; ! #X text 514 407 stack at the 2nd outlet; ! #X msg 82 358 push $1; ! #X floatatom 82 332 5 0 0 0 - - -; ! #X symbolatom 130 332 10 0 0 0 - - -; ! #X text 151 436 removing it; ! #X msg 82 462 pop; ! #X text 285 53 ::: h_queue :::; ! #X obj 82 514 h_queue xlt; ! #X obj 430 563 h_queue xlt; ! #X text 39 136 A queue is a "first in first out" (FIFO) data structure. That is , elements are added to the back of the queue (push) and may be removed from the front (pop).; ! #X text 510 606 <- nr of elements; ! #X text 180 536 <- bang if queue is empty; ! #X text 148 359 <- push some data in the queue; ! #X msg 82 407 front; ! #X text 130 408 <- get the data from the front; ! #X text 151 423 of the queue without; ! #X text 138 478 of the queue; ! #X text 117 463 <- removes the data fom the front; ! #X obj 500 24 cnv 15 204 120 empty empty empty 20 12 0 14 -66577 -66577 ! 0; ! #X obj 502 26 cnv 15 200 116 empty empty ReadMe: 65 15 0 14 -262131 ! -143491 0; #N canvas 674 0 511 843 General_Concept 0; #X text 37 165 This library was made for algorithmic composition and *************** *** 116,121 **** #X restore 39 503 pd namespace_example; #X text 161 554 ::: DATATYPES :::; - #X text 41 579 In the containers you can save all of the build-in datatypes: - lists , floats , and symbol.; #X text 38 296 As storage datastructures I implemented the C++ STL (Standard Template Library) Containers in PD. Currently following datastructures --- 95,98 ---- *************** *** 146,157 **** #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; - #X text 111 659 ( If you use lists as key you can also make a multidimensional - matrix ! ); #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs with lists , you don't have to update the ! send-receive pairs all the time , you can use send-receive "namespaces" , ...; #X connect 1 0 0 0; #X connect 2 0 0 1; --- 123,134 ---- #X text 229 520 <- get data2; #X text 345 199 <- add to key data2 a list; #X text 69 193 <- add to key data1 a list; #X text 32 32 ::: MAP_EXAMPLE :::; #X text 34 72 With the datastructure "map" it's for example possible ! to make send-receive pairs , you don't have to update the send-receive ! pairs all the time (like [value]) , you can use send-receive "namespaces" , ...; + #X text 111 659 ( If you use lists as key you can also make a multidimensional + matrix ... ); #X connect 1 0 0 0; #X connect 2 0 0 1; *************** *** 169,179 **** #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 159 669 ::: SAVE/LOAD :::; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into the specific container. (In ! future I'll also make a XML-fileformat , which will be easier to edit ! !); ! #N canvas 215 140 716 536 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; --- 146,154 ---- #X connect 15 0 13 0; #X restore 41 615 pd map_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X text 41 579 In the containers you can save all of the PD build-in ! datatypes: lists , floats , and symbol.; ! #N canvas 215 140 716 600 save_load_example 0; #X text 27 23 ::: SAVE/LOAD EXAMPLE :::; #X msg 68 229 pushback one word; *************** *** 185,199 **** #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 368 320 h_list $0-local; ! #X msg 368 235 save example.dat; ! #X msg 393 284 print; ! #X text 493 236 <- save data as file; #X obj 140 477 h_set blablu; ! #X msg 140 405 read example.dat; ! #X text 274 405 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; #X connect 1 0 6 0; #X connect 2 0 6 0; --- 160,181 ---- #X obj 68 324 h_list $0-local; #X text 93 168 <- add these three lists to h_list; ! #X obj 333 321 h_list $0-local; ! #X msg 358 285 print; #X obj 140 477 h_set blablu; ! #X msg 140 413 read example.dat; ! #X text 274 413 <- read the same data now into a h_set; #X text 26 67 You can save and load data from and to disk. So you can also exchange data through different datastructures with the same data-format (here from a h_list to a h_set).; #X msg 178 441 print; + #X msg 333 207 saveXML example.xml; + #X text 457 238 <- save data as file; + #X msg 333 238 save example.dat; + #X text 477 208 <- save data as XML file; + #X msg 140 378 readXML example.xml; + #X text 283 379 <- read the same XML data now into a h_set; + #X text 22 529 Please use the XML fileformat if possible , because + it's easier to edit in an external editor and the XML parser is much + more stable !; #X connect 1 0 6 0; #X connect 2 0 6 0; *************** *** 204,278 **** #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 10 0 8 0; ! #X connect 13 0 12 0; ! #X connect 16 0 12 0; ! #X restore 42 771 pd save_load_example; ! #X text 273 34 general concept of; ! #X text 274 52 PDContainer; ! #X restore 552 147 pd General_Concept; ! #X obj 33 24 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 35 26 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 295 36 help file of; ! #X text 175 698 =%)!(%= PDContainer , by Georg Holzmann grh@gmx.at ! , 2004; ! #X text 40 98 init arg: namespace; ! #X msg 430 438 clear; ! #X msg 430 532 help; ! #X obj 502 587 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X msg 430 335 getnamespace; ! #X msg 430 476 clearall; ! #X obj 430 630 print BBB; ! #X obj 82 579 print AAA; ! #X text 541 360 <- change namespace; ! #X msg 430 359 namespace grix; ! #X text 478 438 <- clear all the data of the; ! #X text 499 453 current namespace; ! #X text 498 478 <- clear all the data in all; ! #X text 519 493 same containers (maybe; ! #X text 521 508 you shouldn't use this); ! #X text 530 337 <- get current namespace; ! #X text 429 283 general operations:; ! #X floatatom 466 606 5 0 0 0 - - -; ! #X floatatom 118 556 5 0 0 0 - - -; ! #X msg 430 391 getsize; ! #X text 493 391 <- puts out the size of the; ! #X text 514 407 stack at the 2nd outlet; ! #X msg 82 358 push $1; ! #X floatatom 82 332 5 0 0 0 - - -; ! #X symbolatom 130 332 10 0 0 0 - - -; ! #X text 151 436 removing it; ! #X msg 82 462 pop; ! #X text 285 53 ::: h_queue :::; ! #X obj 82 514 h_queue xlt; ! #X obj 430 563 h_queue xlt; ! #X text 39 136 A queue is a "first in first out" (FIFO) data structure. That is , elements are added to the back of the queue (push) and may be removed from the front (pop).; ! #X text 510 606 <- nr of elements; ! #X text 180 536 <- bang if queue is empty; ! #X text 148 359 <- push some data in the queue; ! #X msg 82 407 front; ! #X text 130 408 <- get the data from the front; ! #X text 151 423 of the queue without; ! #X text 138 478 of the queue; ! #X text 117 463 <- removes the data fom the front; ! #X connect 10 0 38 0; ! #X connect 11 0 38 0; ! #X connect 13 0 38 0; ! #X connect 14 0 38 0; ! #X connect 18 0 38 0; ! #X connect 28 0 38 0; ! #X connect 31 0 37 0; ! #X connect 32 0 31 0; ! #X connect 33 0 31 0; ! #X connect 35 0 37 0; ! #X connect 37 0 16 0; ! #X connect 37 1 27 0; ! #X connect 37 2 0 0; ! #X connect 38 0 15 0; ! #X connect 38 1 26 0; ! #X connect 38 2 12 0; ! #X connect 43 0 37 0; --- 186,363 ---- #X connect 5 0 4 0; #X connect 9 0 8 0; ! #X connect 11 0 10 0; ! #X connect 14 0 10 0; ! #X connect 15 0 8 0; ! #X connect 17 0 8 0; ! #X connect 19 0 10 0; ! #X restore 40 797 pd save_load_example; ! #X text 41 696 All the data of all containers can be saved to disk. ! So you can also manually edit the file with an editor (which is sometimes ! much faster) and then load it in PD into a container. You can also ! load data from other containers. Please use the XML fileformat if possible ! , because it's easier to edit in an external editor and the XML parser ! is much more stable.; ! #X text 164 671 ::: SAVE/LOAD :::; ! #X restore 536 62 pd General_Concept; ! #N canvas 205 0 993 742 Container_Explanation 0; ! #X obj 14 13 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ; ! #X obj 16 15 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 -66577 0; ! #X text 254 23 general explation of; ! #X text 254 40 the datastructures; ! #X text 23 655 A vector is a sequence that supports access to all elements ! via index (like an array) and fast insertion and removal of elements ! at the end. The number of elements in a vector may vary dynamically. ! ; ! #X obj 189 627 h_vector; ! #X text 500 654 Fast insertion and removal anywhere , all the other ! elements move up. But a list provides only sequential access (not via ! index !). A list is a doubly linked list.; ! #X obj 680 628 h_list; ! #X obj 189 773 h_deque; ! #X text 498 801 A queue is a "first in first out" (FIFO) data structure. That is , elements are added to the back of the queue (push) and may be removed from the front (pop).; ! #X obj 679 774 h_queue; ! #X text 22 951 A priority queue is also a "first in first out" (FIFO) ! data structure , but you can give the elements a priority. So the ! elements with a higher priority are automatically inserted before all ! other elements with a lower priority.; ! #X obj 154 924 h_priority_queue; ! #X text 20 800 A deque (double ended queue , pronounced "deck") is ! very much like a vector: like vector , it is a sequence that supports ! access to all elements via index. The main way in which deque differs ! from vector is that fast insertion and removal of elements is possible ! at the beginning _and_ the end.; ! #X text 22 232 Maps represent a mapping from one type (the key type) ! to another type (the value type). You can associate a value with a ! key , or find the value associated with a key , very efficiently. ! Map is a Sorted Associative Container and it is also a Unique Associative ! Container , meaning that no two elements have the same key. (see Multimap ! for more elements with the same key); ! #X obj 188 203 h_map; ! #X text 492 231 Multimaps are just like maps except that a key can ! be associated with several values. Multimap is a Sorted Associative ! Container and also a Multiple Associative Container , meaning that ! there is no limit on the number of elements with the same key. (see ! also Map); ! #X obj 643 201 h_multimap; ! #X text 24 419 Sets allow you to add and delete elements. Afterwards ! you can look if an element is set. Set is a Sorted Associative Container ! and a Unique Associative Container , meaning that no two elements ! are the same. (see Multiset to have several copies of the same element) ! ; ! #X obj 187 392 h_set; ! #X text 493 419 Multisets are just like sets , except that you can ! have several copies of the same element. Multiset is a Sorted Associative ! Container and a Multiple Associative Container , meaning that two ! or more elements may be identical. (see also Set); ! #X obj 642 391 h_multiset; ! #X text 339 167 :::: ASSOCIATIVE CONTAINERS ::::; ! #X text 393 592 :::: SEQUENCES ::::; ! #X text 289 1099 (look for help at all the objects for more information) ! ; ! #X text 35 87 PDContainer contains the following datastructures:; ! #X text 399 86 map , nultimap , set , multiset , vector , list ! , deque , queue , stack , priority queue; ! #X obj 679 916 h_stack; ! #X text 495 950 Stack is a "last in first out" (LIFO) data structure: ! the element at the top of a stack is the one that was most recently ! added (push). Top outputs the elements from the top without removing ! it , pop outputs and removes it.; ! #X restore 518 90 pd Container_Explanation; ! #N canvas 254 0 927 786 Fileformats 0; ! #X obj 38 27 cnv 15 404 54 empty empty empty 22 25 0 18 -1 -66577 0 ! ; ! #X obj 40 29 cnv 15 400 50 empty empty PDContainer 22 25 0 18 -228992 ! -66577 0; ! #X text 259 56 PDContainer; ! #X text 257 38 different fileformats of; ! #X text 472 116 Please use the XML fileformat if possible , because ! it's easier to edit in an external editor and the XML parser is much ! more stable!; ! #X text 40 582 s go; ! #X text 40 569 f 2 s wow f 2; ! #X text 40 599 f 23; ! #X text 38 634 (f=float , s=symbol); ! #X text 37 171 a) single elements: are the containers h_vector , h_list ! , h_deque , h_set , h_multiset; ! #X text 471 172 b) key-value pairs: are the containers h_map and h_multimap ! ; ! #X text 469 276 2.element: symbol go; ! #X text 476 698 f 2 s wow - f 2; ! #X text 476 712 s go - s not f 34; ! #X text 476 729 f 23 - s op; ! #X text 488 244 key: list 2 wow; ! #X text 470 229 1.element:; ! #X text 488 258 value: float 2; ! #X text 490 291 key: symbol go; ! #X text 490 305 value: list symbol not float 34; ! #X text 39 243 1.element: list 2 wow 2; ! #X text 39 257 2.element: symbol go; ! #X text 38 272 3.element: float 23; ! #X text 37 223 a) example1:; ! #X text 470 212 b) example2:; ! #X text 37 312 a) example1 , XML:; ! #X text 37 339 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 37 353 <PDContainer type="h_list">; ! #X text 54 366 <element>; ! #X text 70 379 <f> 2 </f>; ! #X text 70 405 <f> 2 </f>; ! #X text 56 418 </element>; ! #X text 70 391 <s> wow </s>; ! #X text 56 431 <element>; ! #X text 57 455 </element>; ! #X text 72 443 <s> go </s>; ! #X text 56 468 <element>; ! #X text 57 492 </element>; ! #X text 72 480 <f> 23 </f>; ! #X text 41 506 </PDContainer>; ! #X text 41 542 a) example1 , textfile:; ! #X text 39 115 You can save the data of the containers to XML files ! and normal textfiles (see General_Concept).; ! #X text 469 375 <?xml version="1.0" encoding="ISO-8859-1" ?>; ! #X text 469 389 <PDContainer type="h_list">; ! #X text 486 402 <element>; ! #X text 519 430 <f> 2 </f>; ! #X text 520 482 <f> 2 </f>; ! #X text 488 506 </element>; ! #X text 519 442 <s> wow </s>; ! #X text 475 634 </PDContainer>; ! #X text 469 348 b) example2 , XML:; ! #X text 503 415 <key>; ! #X text 504 456 </key>; ! #X text 503 468 <value>; ! #X text 504 494 </value>; ! #X text 487 519 <element>; ! #X text 489 621 </element>; ! #X text 504 532 <key>; ! #X text 505 559 </key>; ! #X text 504 571 <value>; ! #X text 505 609 </value>; ! #X text 520 545 <s> go </s>; ! #X text 521 584 <s> not </s>; ! #X text 521 597 <f> 34 </f>; ! #X text 476 668 b) example2 , textfile:; ! #X restore 550 116 pd Fileformats; ! #X text 211 703 htttp://grh.mur.at/software/pdcontainer.html; ! #X text 171 687 =%)!(%= PDContainer , by Georg Holzmann grh@mur.at ! , 2004; ! #X connect 5 0 33 0; ! #X connect 6 0 33 0; ! #X connect 8 0 33 0; ! #X connect 9 0 33 0; ! #X connect 13 0 33 0; ! #X connect 23 0 33 0; ! #X connect 26 0 32 0; ! #X connect 27 0 26 0; ! #X connect 28 0 26 0; ! #X connect 30 0 32 0; ! #X connect 32 0 11 0; ! #X connect 32 1 22 0; ! #X connect 32 2 0 0; ! #X connect 33 0 10 0; ! #X connect 33 1 21 0; ! #X connect 33 2 7 0; ! #X connect 38 0 32 0;