| SIMPOL Language Reference Manual | ||
|---|---|---|
 | ||
SIMPOL Language Reference Manual
The Nitty Gritty
Copyright © 2001-2017 Superbase Software Limited
All rights reserved. The programs and documentation in this book are not guaranteed to be without defect, nor are they declared to be fit for any specific purpose other than instruction in the use of the programming language SIMPOL. It is entirely possible (though not probable) that use of any sample program code in this book could reformat your hard disk disable your computer forever, fry your dog in a microwave oven, and even cause a computer virus to infect you by touching the keyboard, though none these things is terribly likely (after all, almost anything is possible. It is just that most things are extremely improbable.
| Revision History | ||
|---|---|---|
| Revision 0.48 | 2017-04-21 | nr |
| Updates from the changes to the various libaries from the 2.13 maintenance release. Plus changes to the WXWN component (new control: wxformgauge and changed control: wxformgrid), in addition to a new system function in the core SMPOL library: !osinfo(). | ||
| Revision 0.47 | 2016-10-13 | nr |
| Updates from the changes to the various libaries from the 2.06 maintenance release. | ||
| Revision 0.46 | 2016-09-19 | nr |
| Updates from the changes to the various libaries from the 2.05 maintenance release. | ||
| Revision 0.45 | 2016-07-08 | nr |
| Updates from the changes to the various libaries from the 2.01 maintenance release. | ||
| Revision 0.44 | 2016-03-21 | nr |
| Converted the documentation to Docbook 5. Updates were added for changes to many of the libraries in SIMPOL (see the release notes). Added sections for consolelib, commonreportgui, filtergui, ieeelib, and logmanager. Dropped the section on epoctypes, since it is no longer relevant. Dropped the basicutil section since this library is no longer distributed. | ||
| Revision 0.43 | 2014-07-15 | nr |
| Updates added for changes to many of the libraries in SIMPOL (see the release notes). | ||
| Revision 0.42 | 2014-03-19 | nr |
| Updates added for changes to many of the libraries in SIMPOL (see the release notes). Also added new sections for drilldown, dxflib, iplib, json, labelslib, recordview, repguilib, simpollib, and tableview. | ||
| Revision 0.41 | 2013-02-26 | nr |
| Updates added for changes to the appframework, databaseforms, db1util, and printformlib. | ||
| Revision 0.40 | 2012-01-19 | nr |
| Added the additional changes to the wxformgrid control (onlabelclick event, getcellbackgroundrgb(), getcelltextrgb(), getselectedcol(), setcellbackgroundrgb(), setcelltextrgb()). Also added new chapters for the new libraries: bzip2.sml, calceval.sml, simpolpacker.sml, and soundlib.sml. The datepicker.sml chapter was removed because the library functionality has been incorporated into the uisyshelp.sml library. | ||
| Revision 0.39 | 2011-03-22 | nr |
| Added the changes to the wxformgrid control (new methods and one event). | ||
| Revision 0.38 | 2010-09-22 | nr |
| Added the datepicker, registrylib, and uuencode sections, also updated the various SIMPOL language libraries that have changed for release 1.5. | ||
| Revision 0.37 | 2010-06-17 | nr |
| Some fixes to incorrect information. Updated the information for the latest SIMPOL language program libraries. | ||
| Revision 0.36 | 2010-03-12 | nr |
| Numerous content updates to improve the basic design and flow of the document and to better express the information. Also updated with all new features added to the various components since the inital release. | ||
| Revision 0.35 | 2009-03-30 | nr |
| Added all the sections for the SIMPOL language libraries supplied with the release. | ||
| Revision 0.34 | 2009-01-15 | nr |
| Added the errors 84 and 85 having to do with the definition of member functions of types. Also updated the copyright year. | ||
| Revision 0.33 | 2008-09-05 | nr |
| Added the error 200, "object has no value". | ||
| Revision 0.32 | 2008-07-21 | nr |
| Added the errors for the set object, which is now part of the core SIMPOL types. Also added other new errors for the changes to WXWN, and the new UTIL component. Added the documentation for the latest changes to WXWN, including: tooltips for form controls and toolbar tools, the onmouse event for all form controls, and the getscrollposition() and setscrollposition() methods of the wxwindow object. Also added the docs for the seticon() method of the wxwindow object. | ||
| Revision 0.31 | 2008-04-21 | nr |
| Added the documentation for the dnode and dlist types, which are part of the new SIMPOL component called smutil. | ||
| Revision 0.30 | 2008-03-27 | nr |
| Added the documentation for the set object, which is now part of the core SIMPOL types. | ||
| Revision 0.29 | 2008-03-05 | nr |
| Added four error value entries,: 525 (previously overlooked), 913, 914, and 915 (related to the adding of indexes on number fields plus the new unique index capability). Also added the documentation changes for the indexes on number fields and for unique indexes. | ||
| Revision 0.28 | 2008-02-28 | nr |
| Updated the documentation for the smodbc component and added the documentation for the odbc2.sml SIMPOL language library. | ||
| Revision 0.27 | 2007-11-19 | nr |
| Added the initial documentation for the smodbc component. | ||
| Revision 0.26 | 2007-09-27 | nr |
| Corrected the documentation of the new() method for point and fixedpoint types. Added documentation for the wxprintout.startprintpreview() method, wxprintdialog() function, wxformedittext.onchange and wxformcombo.onchange events. Updated the documentation of the wxformgrid.setcellvalue() method to add the valuearray parameter. Added the information property to the function type definition. | ||
| Revision 0.25 | 2007-06-11 | nr |
| Completed the proper documentation of the point and fixedpoint types. | ||
| Revision 0.24 | 2007-05-03 | nr |
| Updated the documentation for the receivestring() and receiveblob() functions for the tcpsocket type. Also added the documentation for the enhancements to the sbme1 objects that now allow for modifying the file definition, exposing the internal record ID as an indexed field, and retrieving the record count of a table. | ||
| Revision 0.23 | 2007-04-23 | nr |
| Removed the section covering the UTUI component, since this component has been deprecated now for some time by more complete functionality in the WXWN component. Also added all of the current documentation regarding the wxprintout objects: wxprintout, wxprintpage, wxprintpagetemplate, wxprintstring, wxprintbitmap, wxprinttextitem, and wxprintbitmapitem. | ||
| Revision 0.22 | 2007-01-08 | nr |
| Fixed the entry for wxrgbdialog (was missing the defaultrgb parameter) and added the entries and updates to wxwindow for child windows. | ||
| Revision 0.21 | 2006-12-28 | nr |
| Added the reference information for the wxgraphicline, wxgraphictriangle, wxgraphicrectangle, wxgraphicellipse and wxgraphicarc types. Updated the information for the wxform type where required by the new types. | ||
| Revision 0.20 | 2006-12-07 | nr |
| Added the reference information for the point, fixedpoint, event, function, module, property, and type types. Updated the information for the blob type. Added the information for the oncellselect event of the wxformgrid type and the additional enhancements for hosting wxform objects in a wxtoolbar. | ||
| Revision 0.19 | 2006-11-17 | nr |
| Added the hidden property for ppcstype1servertable types, as well as the comparable parameter to the setshareability() method. Also added the setpassword() and getpassword() methods to the same type. | ||
| Revision 0.18 | 2006-11-03 | nr |
| Added the wxscreengettextextent(), wxgetclipboard() and wxsetclipboard() functions. | ||
| Revision 0.17 | 2006-10-27 | nr |
| Added txfactor property, parameters and associated methods for the ppcstype1 and ppcstype1serverudp types. | ||
| Revision 0.16 | 2006-10-10 | nr |
| Added wxstatusbar, wxform.cursor (mouse pointer control), wxformedittext enhancements: setselection(), getselection(), setinsertionpoint(), getinsertionpoint(), and setmaxlength(). | ||
| Revision 0.15 | 2006-09-08 | nr |
| Added everything about wxformscrollbar, wxformsizebox, wxform.onmouse, wxform.capture(), wxform.release(), wxform.popupmenu(), and numerous enhancements to various controls. Removed the deprecated window1 and form1 sections. | ||
| Revision 0.14 | 2006-05-08 | nr |
| Added more information about wxgrid methods. | ||
| Revision 0.13 | 2006-04-22 | nr |
| Added more information about wxgrid. Implemented the documentation for the member operator (!) in appropriate places. Updated all of the source files to ensure consistent source formatting. Added the new information about wxgetfilename(), wxgetdirectory(), and wxmessage() which now deprecates the UTUI component. | ||
| Revision 0.12 | 2006-03-31 | nr |
| Added information about wxgrid, wxtoolbar, and wxtool. Converted to using <oXygen/> for editing and processing the documentation. First PDF version produced. | ||
| Revision 0.11 | 2006-03-06 | nr |
| The latest documentation for the current state of the WXWN component has been added. This includes the wxbitmap, wxbitmapbutton, wxmenubar, wxmenubarentry, wxmenu, and wxmenuitem types. Also, all of the types that were updated with the new underscore and double underscore properties have been updated. | ||
| Revision 0.10 | 2005-12-23 | nr |
| All of the documentation for the current state of the WXWN component has been added. This includes the wxwindow, wxform, wxformbutton, wxformtext, wxformedittext, wxformcheckbox, wxformoption, wxformlist, and wxformcombo, wxfont, wxdialog, and wxdialogstdbutton objects, as well as the wxprocess() and wxbreak() functions. | ||
| Revision 0.09 | 2004-04-01 | nr |
| Split the book into a Programmer's Guide and a Reference Guide. Added the reference documentation for the frm1, win1, ppsr, utos, and utui components. Changed to a component architecture type of book. All of the reference documentation on types and free functions that are not a built-in part of SIMPOL are now generated using a program written in SIMPOL that converts an XML document format created by us for documenting the API. Also added the documentation for !wait() and !like1(). | ||
| Revision 0.08 | 2003-09-04 | nr |
| Added the lock1 type, AND, OR, and XOR operators, the anyvalue type, additional narrative. | ||
| Revision 0.07 | 2003-01-13 | nr |
| Added the array type, .compress1, .decompress1, various type tags, additional narrative. | ||
| Revision 0.06 | 2002-10-02 | nr |
| Added the Superbase Micro Engine new types and wrote the content of the Variables chapter. | ||
| Revision 0.05 | 2002-09-30 | nr |
| Added the section covering the Superbase Micro Engine types. | ||
| Revision 0.04 | 2002-07-27 | nr |
| Added some more detail in the basic document and redesigned into parts. | ||
| Revision 0.03 | 2002-05-20 | nr |
| Added the section on esf1 types and reworked the smpol-types to be based on includes. | ||
| Revision 0.02 | 2002-02-27 | nr |
| Added the section on grammar and modified the book to include the initial main documentation. | ||
| Revision 0.01 | 2001-12-05 | nr |
| Initial conversion of existing SIMPOL documentation into DocBook XML format. | ||
Table of Contents
- Foreword
- I. The Core SIMPOL Language
- II. C-Language Components
- 4. SIMPOL Built-In Types
- 5. The Peer-to-Peer Client/Server (PPCS) Component
- 6. The Superbase Micro Engine (SBME) Component
- 7. The PPCS Server for SBME Databases (PPSR) Component
- 8. The CGI/ISAPI/FastCGI Component
- 9. The Sockets (SOCK) Component
- 10. The Operating System Utilities (UTOS) Component
- 11. The wxWidgets-based (WXWN) Components
- 12. The Shared Library (SLIB) Component
- 13. The ODBC Client (ODBC) Component
- 14. The ODBC Client Companion Library
- 15. The Language Utilities (UTIL) Component
- III. SIMPOL-Language Libraries
- 16. ABS
- 17. appframework
- 18. boolstr
- 19. bzip2
- 20. calceval
- 21. codepageslib
- 22. colorpalette
- 23. commonreportgui
- 24. conflib
- 25. consolelib
- 26. databaseforms
- 27. datetimelib
- 28. db1util
- 29. dbconverter
- 30. displayformat
- 31. drilldown
- 32. dxflib
- 33. errormsgs_en
- 34. fastset
- 35. filesyslib
- 36. filtergui
- 37. formlib
- 38. gaugelib
- 39. graphicreportlib
- 40. httpclientlib
- 41. ieeelib
- 42. imagelib
- 43. INT
- 44. iplib
- 45. jpeglib
- 46. json
- 47. labelslib
- 48. logmanager
- 49. libxmldom1
- 50. libxmldom2
- 51. libxmlutil
- 52. lists
- 53. LTRIM
- 54. mathlib
- 55. mrulib
- 56. netinfolib
- 57. objset
- 58. odbcsql1
- 59. PAD
- 60. parsenum
- 61. printformlib
- 62. quickreportlib
- 63. random
- 64. recordview
- 65. registrylib
- 66. reorglib
- 67. repguilib
- 68. replace
- 69. reportlib
- 70. rsalib
- 71. sbislib
- 72. SBLDateLib
- 73. sblexten
- 74. sbllib
- 75. SBLlocaledateinfo
- 76. SBLTimeLib
- 77. sbnglib
- 78. sendkeys
- 79. sendmail
- 80. serialize
- 81. sessionid
- 82. sessionid2
- 83. shellexecute
- 84. simpollib
- 85. smtpclientlib
- 86. smtpdatelib
- 87. sortlib
- 88. soundlib
- 89. sql1
- 90. STR
- 91. stringlib
- 92. tableview
- 93. timer
- 94. TRIM
- 95. uisyshelp
- 96. unittest
- 97. urlendecode
- 98. urllib
- 99. utf8lib
- 100. uuencode
- 101. VAL
- 102. volatable
- 103. windowsemaillib
- 104. winfiledlg
- 105. xmllib
- A. Error Codes
List of Tables