Microsoft announced Small Basic in October 2008,[3] and released the first stable version for distribution on July 12, 2011,[20] on a Microsoft Developer Network (MSDN) website, together with a teaching curriculum[22] and an introductory guide.[23] Between announcement and stable release, a number of Community Technology Preview (CTP) releases were made.
On March 27, 2015, Microsoft released Small Basic version 1.1,[21] which fixed a bug and upgraded the targeted .NET Framework version from version 3.5 to version 4.5, making it the first version incompatible with Windows XP.
Microsoft released Small Basic version 1.2 on October 1, 2015.[5] Version 1.2 was the first update after a four-year hiatus to introduce new features to Small Basic. The update added classes for working with Microsoft's Kinect motion sensors,[5] increased the number of languages supported by the included Dictionary object, and fixed a number of bugs.[6]
The following example demonstrates conditional branching. It ask the user for Celsius or Fahrenheit and then comments on the answer in the appropriate temperature unit.
' A Program that gives advice at a requested temperature.TextWindow.WriteLine("Do you use 'C'elsius or 'F'ahrenheit for temperature?")TextWindow.WriteLine("Enter C for Celsius and F for Fahrenheit:")question_temp:' Label to jump back to input if wrong input was giventempunit=TextWindow.Read()' Temperature Definitions in Celsius:tempArray["hot"]=30' 30 °C equals 86 °FtempArray["pretty"]=20' 20 °C equals 68 °FtempArray["cold"]=15' 15 °C equals 59 °FIftempunit="C"ORtempunit="c"ThenTextWindow.WriteLine("Celsius selected!")tempunit="C"' Could be lowercase, thus make it uppercaseElseIftempunit="F"ORtempunit="f"ThenTextWindow.WriteLine("Fahrenheit selected!")' We calculate the temperature values for Fahrenheit based on the Celsius valuestempArray["hot"]=((tempArray["hot"]*9)/5)+32tempArray["pretty"]=((tempArray["pretty"]*9)/5)+32tempArray["cold"]=((tempArray["cold"]*9)/5)+32tempunit="F"' Could be lowercase, thus make it uppercaseElseGOTOquestion_temp' Wrong input, jump back to label "question_temp"EndIfTextWindow.Write("Enter the temperature today (in "+tempunit+"): ")temp=TextWindow.ReadNumber()Iftemp>=tempArray["hot"]ThenTextWindow.WriteLine("It is pretty hot.")ElseIftemp>=tempArray["pretty"]ThenTextWindow.WriteLine("It is pretty nice.")ElseIftemp>=tempArray["cold"]ThenTextWindow.WriteLine("Don't forget your coat.")ElseTextWindow.WriteLine("Stay home.")EndIf
Small Basic does not support an inline If statement as does Visual Basic, for example:
Iftemp>50ThenTextWindow.WriteLine("It is pretty nice.")
Looping
This example demonstrates a loop. Starting from one and ending with ten, it multiplies each number by four and displays the result of the multiplication.
Whileloops are also supported, and the demonstrated Forloop can be augmented through the use of the Step keyword. The Step keyword is used in setting the value by which the counter variable, i, is incremented each iteration.
Data types
Small Basic supports basic data types, like strings, integers and decimals, and will readily convert one type to another as required by the situation. In the example, both the Read and ReadNumber methods read a string from the command line, but ReadNumber rejects any non-numeric characters. This allows the string to be converted to a numeric type and treated as a number rather than a string by the + operator.
TextWindow.WriteLine("Enter your name: ")name=TextWindow.Read()TextWindow.Write("Enter your age: ")age=TextWindow.ReadNumber()TextWindow.WriteLine("Hello, "+name+"!")TextWindow.WriteLine("In 5 years, you shall be "+(age+5)+" years old!")
As Small Basic will readily convert among data types, numbers can be manipulated as strings and numeric strings as numbers. This is demonstrated through the second example.
TextWindow.WriteLine(Math.log("100"))'Prints 2TextWindow.WriteLine("100"+"3000")' Prints 3100TextWindow.WriteLine("Windows "+8)' Prints Windows 8TextWindow.WriteLine(Text.GetLength(1023.42))' Prints 7 (length of decimal representation including decimal point)
In the second example, both strings are treated as numbers and added together, producing the output 3100. To concatenate the two values, producing the output 1003000, it is necessary to use the Text.Append(text1, text2) method.
Libraries
Standard library
The Small Basic standard library includes basic classes for mathematics, string handling, and input/output, as well as more exotic classes that are intended to make using the language more fun for learners. Examples of these include a Turtle graphics class, a class for retrieving photos from Flickr, and classes for interacting with Microsoft Kinect sensors.[26]
To make the classes easier to use for learners, they have been simplified. This simplification is demonstrated through the code used to retrieve a random mountain-themed image from Flickr:
Small Basic includes a "Turtle" graphics library that borrows from the Logo family of programming languages. For example, to draw a square using the turtle, the turtle is moved forward by a given number of pixels and rotated 90 degrees in a given direction. This action is then repeated four times to draw the four sides of the square.
More complex drawings are possible by altering the turning angle of the turtle and the number of iterations of the loop. For example, one can draw a hexagon by setting the turn angle to 60 degrees and the number of iterations to six.
Third-party libraries
Small Basic allows the use of third-party libraries. These libraries must be written in a CLR-compatible language, and the compiled binaries must target a compatible .NET Framework version. The classes provided by the library are required to be static, flagged with a specific attribute, and must use a specific data type.
An example of a class to be used in Small Basic is provided below, written in C#.
If available, the Small Basic development environment will display documentation for third-party libraries. The development environment accepts documentation in the form of an XML file, which can be automatically generated from source code comments by tools such as Microsoft Visual Studio and MonoDevelop.[27]