Home Explore Help
Sign In
blitz
/
blitz3d
mirror of https://github.com/blitz-research/blitz3d.git
2
0
Fork 0
Files Issues 0 Wiki
Branch: master
Branches Tags
blitz3d
/
_release
/
help
/
commands
/
2d_commands
/
Insert.htm

Insert.htm 2.2 KB
Permalink History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364 
  1. <html>
    2. 

  2. <head>
    3. 

  3. <title>Blitz3D Docs</title>
    4. 

  4. <link rel=stylesheet href=../css/commands.css type=text/css>
    5. 

  5. </head>
    6. 

  6. <body>
    7. 

  7. <h1>Insert</h1>
    8. 

  8. <h1>Parameters</h1>
    9. 

  9. <table>
    10. 

  10. <tr>
    11. 

  11. <td>
    12. 

  12. None.
    13. 

  13. </td>
    14. 

  14. </tr>
    15. 

  15. </table>
    16. 

  16. <h1>Description</h1>
    17. 

  17. <table>
    18. 

  18. <tr>
    19. 

  19. <td>
    20. 

  20. I'm not sure the practical usage of this command, but basically, you can  control where you INSERT the current TYPE object into  the TYPE collection. When you create a new Type object with the NEW command, it is automatically appended to the END of  the collection. Using INSERT along with BEFORE and AFTER (and electively FIRST  and LAST) to put the Type object exactly where you want  it. Sounds confusing - and chances are likely you'll never need this ability.  But its here if you need it. Check the example.
    21. 

  21. <br>
    22. 

  22. <br>
    23. 

  23. See also: <a class=small href=Type.htm>Type</a>, <a class=small href=New.htm>New</a>, <a class=small href=Before.htm>Before</a>, <a class=small href=After.htm>After</a>, <a class=small href=First.htm>First</a>, <a class=small href=Last.htm>Last</a>, <a class=small href=Each.htm>Each</a>, <a class=small href=Delete.htm>Delete</a>.
    24. 

  24. </td>
    25. 

  25. </tr>
    26. 

  26. </table>
    27. 

  27. <h1><a href=../2d_examples/Insert.bb>Example</a></h1>
    28. 

  28. <table>
    29. 

  29. <tr>
    30. 

  30. <td>
    31. 

  31. ; INSERT example
<br />
    32. 

  32. 
<br />
    33. 

  33. ; Define a CHAIR type with a created field to track what order it was created  in.
<br />
    34. 

  34. Type CHAIR
<br />
    35. 

  35. Field created
<br />
    36. 

  36. End Type 
<br />
    37. 

  37. 
<br />
    38. 

  38. ; Create 10 chairs, setting created field to the order of creation
<br />
    39. 

  39. For t = 1 To 10
<br />
    40. 

  40. room.chair= New Chair
<br />
    41. 

  41. room\created = t
<br />
    42. 

  42. Next
<br />
    43. 

  43. 
<br />
    44. 

  44. ; Make a NEW chair (the 11th) 
<br />
    45. 

  45. room.chair= New Chair
<br />
    46. 

  46. 
<br />
    47. 

  47. ; Set its created value to 11
<br />
    48. 

  48. room\created=11
<br />
    49. 

  49. 
<br />
    50. 

  50. ; Now, let's insert this chair BEFORE the first one in the collection
<br />
    51. 

  51. Insert room Before First Chair
<br />
    52. 

  52. 
<br />
    53. 

  53. ; Let's iterate through all the chairs, and show their creation order
<br />
    54. 

  54. For room.chair = Each chair
<br />
    55. 

  55. Print room\created
<br />
    56. 

  56. Next
    57. 

  57. </td>
    58. 

  58. </tr>
    59. 

  59. </table>
    60. 

  60. <br>
    61. 

  61. <a target=_top href=../index.htm>Index</a><br>
    62. 

  62. <br>
    63. 

  63. Click <a href=http://www.blitzbasic.co.nz/b3ddocs/command.php?name=Insert&ref=comments target=_blank>here</a> to view the latest version of this page online</body>
    64. 

  64. </html>
    65.