A Guide to the S-Lang Language (v2.3.0)

John E. Davis <www.jedsoft.org>

1. Preface

• 1.1 A Brief History of S-Lang
• 1.2 Acknowledgements

2. Introduction

• 2.1 slsh -- The S-Lang shell
• 2.2 Language Features
• 2.3 Data Types and Operators
• 2.4 Statements and Functions
• 2.5 Error Handling
• 2.6 Run-Time Library
• 2.7 Input/Output
• 2.8 Obtaining more information about S-Lang

3. Overview of the Language

• 3.1 Variables and Functions
• 3.2 Qualifiers
• 3.3 Strings
• 3.4 Referencing and Dereferencing
• 3.5 Arrays
• 3.6 Lists
• 3.7 Structures and User-Defined Types
• 3.8 Namespaces

4. Data Types and Literal Constants

• 4.1 Predefined Data Types
• 4.2 Typecasting: Converting from one Type to Another

5. Identifiers

6. Variables

7. Operators

• 7.1 Unary Operators
• 7.2 Binary Operators
• 7.3 Mixing Integer and Floating Point Arithmetic
• 7.4 Short Circuit Boolean Evaluation

8. Statements

• 8.1 Variable Declaration Statements
• 8.2 Assignment Statements
• 8.3 Conditional and Looping Statements

9. Functions

• 9.1 Declaring Functions
• 9.2 Parameter Passing Mechanism
• 9.3 Returning Values
• 9.4 Multiple Assignment Statement
• 9.5 Referencing Variables
• 9.6 Functions with a Variable Number of Arguments
• 9.7 Qualifiers
• 9.8 Exit-Blocks
• 9.9 Handling Return Values from a Function

10. Namespaces

11. Arrays

• 11.1 Creating Arrays
• 11.2 Reshaping Arrays
• 11.3 Simple Array Indexing
• 11.4 Indexing Multiple Elements with Ranges
• 11.5 Arrays and Variables
• 11.6 Using Arrays in Computations
• 11.7 Arrays of Arrays: A Cautionary Note

12. Associative Arrays

13. Structures and User-Defined Types

• 13.1 Defining a Structure
• 13.2 Accessing the Fields of a Structure
• 13.3 Linked Lists
• 13.4 Defining New Types
• 13.5 Operator Overloading

14. Lists

15. Error Handling

• 15.1 Traditional Error Handling
• 15.2 Error Handling through Exceptions

16. Loading Files: evalfile, autoload, and require

17. Modules

• 17.1 Introduction
• 17.2 Using Modules

18. File Input/Output

• 18.1 Input/Output via stdio
• 18.2 POSIX I/O
• 18.3 Advanced I/O techniques

19. slsh

• 19.1 Running slsh
• 19.2 Command line processing

20. Debugging

• 20.1 Tracebacks
• 20.2 Using the sldb debugger

21. Profiling

• 21.1 Introduction
• 21.2 Using the profiler

22. Regular Expressions

• 22.1 S-Lang RE Syntax
• 22.2 Differences between S-Lang and egrep REs

Appendix

23. S-Lang 2 Interpreter NEWS

• 23.1 What's new for S-Lang 2.2
• 23.2 What's new for S-Lang 2.1
• 23.3 What's new for S-Lang 2.0
• 23.4 Upgrading to S-Lang 2

24. Copyright

• 24.1 The GNU Public License
• 24.2 The Unicode Inc. Copyright