Ring Documentation, Release 1.4.

The next screen shot for the Cards Game

The next screen shot for the Cards Game (Android)

1.9. Samples in this book 8

 Ring Documentation, Release 1.4.1

The next screen shot from the Web Development chapter

1.9. Samples in this book 9

 Ring Documentation, Release 1.4.1

The next screen shots for simple 2D Games that we will present in the Game Engine Chapter.
Stars Fighter Game

Flappy Bird 3000 Game

Super Man 2016 Game

1.9. Samples in this book 10

 CHAPTER

TWO

INTRODUCTION

Welcome to the Ring programming language!

The Ring is an Innovative and practical general-purpose multi-paradigm language that can be embedded in C/C++
projects, extended using C/C++ code and/or used as standalone language. The supported programming paradigms
are Imperative, Procedural, Object-Oriented, Functional, Meta programming, Declarative programming using nested
structures, and Natural programming. The language is portable (Windows, Linux, Mac OS X, Android, etc.) and can
be used to create Console, GUI, Web, Games and Mobile applications. The language is designed to be Simple, Small,
Flexible and Fast. Its Dynamic Language (Dynamic Typing and Weakly Typed) that compile the source code to byte
code then execute it by the Ring Virtual Machine, which is integrated with the Ring Compiler in one program.
In this chapter we are going to discuss the goals behind the language design and implementation.

2.1 Motivation

In Nov. 2011, I started to think about creating a new version of the Programming Without Coding Technology (PWCT)
software from scratch.
I was interested in creating multi-platform edition of the software beside adding support for Web & Mobile develop-
ment. Most of the PWCT source code was written in VFP and the software comes with a simple scripting language
for creating the components called (RPWI). The software contains components that support code generation in pro-
gramming languages like Harbour, C, Supernova & Python.
What I was looking for is a programming language that can be used to build the development environment, provides
multi-platform support, more productivity, better performance, can be used for components scripting & can be used
for developing different kinds of applications.
Instead of using a mix of programming languages, I decided to use one programming language for creating the devel-
opment environment, for components scripting & for creating the applications.
I looked at many programming languages like C, C++, Java, C#, Lua, PHP, Python & Ruby. I avoided using C or C++
directly because I want high-level of productivity more than the level provided by these languages, also a language
behind visual programming environment for novice programmers or professionals must be easy to use & productive.

11
 Ring Documentation, Release 1.4.1

Java & C# are avoided for some reason too! I wanted to use a dynamic programming language and these languages are
static typing, Java is multi-platform, also C# through Mono, but the use of huge number of classes and forcing the use
of Object-Orientation, using a verbose language is not right for me. I need a small language, but fast and productive,
also I need better control on the Garbage Collector (GC), I need a better one that is designed for fast applications.
Lua is small and fast, but its avoided because I need more powerful language for large applications.
PHP is a Web programming language and its syntax is very similar to C, this leads to a language not general as I want
and not simple as I need to have.
Python & Ruby are more like what I need, but I need something more simple, smaller, faster & productive.
Python and Ruby are Case-Sensitive, the list index start counting from 0, you have to define the function before calling
it, Ruby usage of Object-Orientation and message passing is more than what I need and decrease performance, Python
syntax (indentation, using self, :, pass & _) is not good for my goals.
All of these languages are successful languages, and very good for their domains, but what I need is a different
language that comes with new ideas and intelligent implementation (Innovative, Ready, Simple, Small, Flexible and
Fast).

2.2 History

In Sept. 2013 I started the design and the implementation of the Ring programming language. After 21 months of
development, In May 2015 the language Compiler & Virtual Machine were ready for use!
After that I spent three months testing the language again, trying to discover any bug to fix, writing better tests, by
the end of August 2015, all know bugs were fixed, Writing many tests and testing automation helped a lot in getting a
stable product.
In September 12, 2015, most of the documentation was written. Before releasing the language I started the marketing
by writing a post in Arabic language about it to my facebook profile page asking for contributors interested in the
language idea after reading a short description, In the same day I got a lot of emails from developers and friends
interested to contribute!
Ring 1.0 is released on January 25, 2016
Ring 1.1 is released on October 6, 2016
Ring 1.2 is released on January 25, 2017
Ring 1.3 is released on May 15, 2017
Ring 1.4 is released on June 29, 2017
Ring 1.4.1 is released on July 11, 2017

2.3 Features

The Ring language comes with the next features

Tip: The language is ready for production!

Free Open Source (MIT License)

Hybrid Implementation (Compiler + Virtual Machine)
Declarative programming on the top of Object-Oriented programming

2.2. History 12
 Ring Documentation, Release 1.4.1

Natural Language programming on the top of Object-Oriented programming

Syntax Flexibility (You can change the language keywords and operators)
Compact Syntax, No explicit end for statements (No ; or ENTER is required)
Using braces { } we can access objects and use attributes/methods as variables/functions
Transparent Implementation
Visual Implementation - Developed using Visual Programming (PWCT)
A small language (Around 200,000 lines of code)
The compiler + The Virtual Machine are 15,000 lines of C code
The other 185,000 lines of code are related to libraries!
Writen in ANSI C (The code is generated)
Optional Printing for Tokens/Grammar/Byte-Code during execution
Portable (Windows, Linux & Mac OS X)
Comments (One line & Multi-lines)
Not Case-Sensitive
Dynamic Typing
Weakly typed
Lexical Scoping (Global, Local & Object State)
Default scope for variables inside functions (Local)
Default scope for variables outside functions (global)
Garbage Collector - Automatic Memory Management (Escape Analysis and Reference Counting)
Structure Programming
Rich control structures & Operators
For in get item by reference not value, you can read/edit the item
Use exit to go outside from more than one loop
Procedures/Functions
Main Function (optional)
Call Function before the definition
Recursion
Multi-line literals
Access (read/write) string letter by index
The list index start by 1
No keyword to end Functions/Classes/Packages
Range operator ex: 1:10 and a:z
First Class Variables, Lists, Objects and Functions
Store/Copy Lists/Objects by value (Deep Copy)
Pass Lists/Objects by reference

2.3. Features 13
 Ring Documentation, Release 1.4.1

Native Object-Oriented Support

Encapsulation
Setter/Getter (optional)
private state (optional)
Instantiation
Polymorphism
Composition
Inheritance (Single Inheritance)
Operator Overloading
Packages
Reflection and Meta-programming
Clear program structure (Statements then functions then packages & classes)
Exception Handling
Eval() to execute code during run-time
8-bit clean, work on binary data directly
I/O commands
Math functions
String functions
List functions
File processing functions
Database support (ODBC, SQLite & MySQL)
Security Functions (OpenSSL)
Internet Functions (LibCurl)
Zip Functions
CGI Library (Written in Ring)
HTTP Get
HTTP Post
File upload
Cookies
URL Encode
HTML Templates
HTML Special Characters
HTML Generation using Functions
HTML Generation using Classes
CRUD Example (using MVC)
Users Example (Register, Login and Check)

2.3. Features 14
 Ring Documentation, Release 1.4.1

Extension using C/C++ (Simple API)

Embedding the language in C/C++ programs
Comes with code generator (Written in Ring) to quickly wrap C/C++ Libraries
Used to Support Allegro by creating RingAllegro
Used to Support LibSDL by creating RingLibSDL
Used to Support Qt by creating RingQt
Create 2D Games for Desktop and Mobile (Using the Allegro Library or the LibSDL Library)
Comes with simple Game Engine for 2D Games
Create GUI Applications for Desktop and Mobile (Using the Qt Framework)
Comes with IDE contains the Code Editor (Ring Notepad) and the Form Designer

2.4 License

The Ring Programming Language

http://ring-lang.net/
Version 1.4.1
The MIT License (MIT)
Copyright (c) Mahmoud Fayed
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documen-
tation files (the Software), to deal in the Software without restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom
the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
Software.
THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PAR-
TICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFT-
WARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

2.4. License 15
 CHAPTER

THREE

LANGUAGE DESIGN

In this chapter we will learn about the basic concepts behind the language design.

3.1 Why Ring?

The language is simple, trying to be natural, encourage organization and comes with transparent and visual implemen-
tation. It comes with compact syntax and a group of features that enable the programmer to create natural interfaces
and declarative domain-specific languages in a fraction of time. It is very small, fast and comes with smart garbage
collector that puts the memory under the programmer control. It supports many programming paradigms, comes with
useful and practical libraries. The language is designed for productivity and developing high quality solutions that can
scale.

3.2 Designed for a Clear Goal

Applications programming language.

Productivity and developing high quality solutions that can scale.
Small and fast language that can be embedded in C/C++ projects.
Simple language that can be used in education and introducing Compiler/VM concepts.
General-Purpose language that can be used for creating domain-specific libraries, frameworks and tools.
Practical language designed for creating the next version of the Programming Without Coding Technology
software.

3.3 Simple

Ring is a very simple language, and has a very straightforward syntax. It encourages programmers to program without
boilerplate code
See "Hello, World!"

The Main function is optional and will be executed after the statements, and is useful for using the local scope.
Func Main
See "Hello, World!"

16
 Ring Documentation, Release 1.4.1

Uses Dynamic Typing and Lexical scoping. No $ is required before the variable name! You can use the + operator
for string concatenation and the language is weakly typed and will convert automatically between numbers and strings
based on the context.
nCount = 10 # Global variable
Func Main
nID = 1 # Local variable
See "Count = " + nCount + nl + " ID = " + nID

3.4 Trying to be natural

Ring is not case-sensitive

See "Enter your name ? "
Give name
See "Hello " + Name # Name is the same as name

The list index starts from 1

aList = ["one","two","three"]
See aList[1] # print one

Call functions before definition

one()
two()
three()
Func one
See "One" + nl
Func two
See "two" + nl
Func three
See "three" + nl

The assignment operator uses Deep copy (no references in this operation)
aList = ["one","two","three"]
aList2 = aList
aList[1] = 1
see alist[1] # print 1
see aList2[1] # print one

Pass numbers and strings by value, but pass lists and objects by reference. The for in loop can update the list items.
Func Main
aList = [1,2,3]
update(aList)
see aList # print one two three

Func update aList

for x in aList
switch x
on 1 x = "one"
on 2 x = "two"
on 3 x = "three"
off
next

3.4. Trying to be natural 17

 Ring Documentation, Release 1.4.1

Using Lists during definition

aList = [ [1,2,3,4,5] , aList[1] , aList[1] ]
see aList # print 1 2 3 4 5 1 2 3 4 5 1 2 3 4 5

Exit from more than one loop

for x = 1 to 10
for y = 1 to 10
see "x=" + x + " y=" + y + nl
if x = 3 and y = 5
exit 2 # exit from 2 loops
ok
next
next

3.5 Encourage Organization

The language encourage organization, Forget bad days using languages where the programmer start with function then
class then function and a strange mix between things!
Each source file follow the next structure
Load Files
Statements and Global Variables
Functions
Packages and Classes
This enable us to use Packages, Classes and Functions without the need to use a keyword to end these components.
We can write one line comments and multi-line comments The comment starts with # or // Multi-line comments are
written between /* and */
/*
Program Name : My first program using Ring
Date : 2015.05.08
*/

See "What is your name? " # print message on screen

give cName # get input from the user
see "Hello " + cName # say hello!

// See "Bye!"

3.6 Transparent Implementation

Ring comes with transparent implementation. We can know what is happening in each compiler stage and what is
going on during the run-time by the Virtual Machine Example : ring helloworld.ring -tokens -rules -ic
See "Hello, World!"

Output

3.5. Encourage Organization 18

 Ring Documentation, Release 1.4.1

==================================================================
Tokens - Generated by the Scanner
==================================================================

Keyword : SEE
Literal : Hello, World!
EndLine

==================================================================

==================================================================
Grammar Rules Used by The Parser
==================================================================

Rule : Program --> {Statement}

Line 1
Rule : Factor --> Literal
Rule : Range --> Factor
Rule : Term --> Range
Rule : Arithmetic --> Term
Rule : BitShift --> Arithmetic
Rule : BitAnd --> BitShift
Rule : BitOrXOR --> BitAnd
Rule : Compare --> BitOrXOR
Rule : EqualOrNot --> Compare
Rule : LogicNot -> EqualOrNot
Rule : Expr --> LogicNot
Rule : Statement --> 'See' Expr

==================================================================

==================================================================
Byte Code - Before Execution by the VM
==================================================================

PC OPCode Data

1 FuncExE
2 PushC Hello, World!
3 Print
4 ReturnNull

==================================================================

Hello, World!

3.7 Visual Implementation

The Ring programming language is designed using the PWCT visual programming tool and you will find the visual
source of the language in the folder visualsrc - *.ssf files and the generated source code (In the C Language) in the
src folder and the include folder.
The next screen shot from the ring_vm.ssf file (Generate ring_vm.c and ring_vm.h)

3.7. Visual Implementation 19

 Ring Documentation, Release 1.4.1

The next screen shot from the ring_list.ssf file (Generate ring_list.c and ring_list.h)

3.8 Compact Syntax

The language is not line sensitive, you dont need to write ; after statements, also you dont need to press ENTER or
TAB, so we can write the next code
See "The First Message" See " Another message in the same line! " + nl
See "Enter your name?" Give Name See "Hello " + Name

3.8. Compact Syntax 20

 Ring Documentation, Release 1.4.1

The next code create a class called Point contains three attributes X,Y and Z. No keywords is used to end the pack-
age/class/function definition. Also, we can write the attributes names directly below the class name.
Class Point X Y Z

We can use classes and functions before their definition, In this example we will create new object, set the object
attributes then print the object values.
o1 = New point o1.x=10 o1.y=20 o1.z=30 See O1 Class Point X Y Z

Instead of using the dot . operator to access the object attributes and methods we can use braces { } to access the
object, then we can use the object attributes and methods.
o1 = New point { x=10 y=20 z=30 } See O1 Class Point X Y Z

Now we will call a method after accessing the object using { }

oPerson = new Person
{
Name = "Somebody"
Address = "Somewhere"
Phone = "0000000"
Print() # here we call the Print() method
}
Class Person Name Address Phone
Func Print
See "Name :" + name + nl +
"Address :" + Address + nl +
"Phone : " + phone + nl

When we use { } to access the object then write any attribute name, the language will check the class for any set-
ter/getter methods that will be called automatically.
New Number {
See one # Execute GetOne()
See two # Execute GetTwo()
See three # Execute GetThree()
}
Class Number one two three
Func GetOne
See "Number : One" + nl
return 1
Func GetTwo
See "Number : Two" + nl
return 2
Func GetThree
See "Number : Three" + nl
return 3

3.9 Define Natural Statements

After the object access using { } if the class contains a method called BraceEnd() it will be executed!
TimeForFun = new journey
# The first surprise!
TimeForFun {
Hello it is me # What a beatiful programming world!
}

3.9. Define Natural Statements 21

 Ring Documentation, Release 1.4.1

# Our Class
Class journey
hello=0 it=0 is=0 me=0
func GetHello
See "Hello" + nl
func braceEnd
See "Goodbye!" + nl

We can execute code written in strings using the Eval() function

cCode = "See 'Code that will be executed later!' "
Eval(cCode) # execute the code to print the message

We can create a list then execute code generated from that list
aWords = ["hello","it","is","me"]
for word in aWords cCode=word+"=0" eval(cCode) next

We can read text files using the Read(cFileName) function and we can write files using the Write(cFileName,cString)
function.
See "Enter File Name:" Give cFileName See Read(cFileName) # Print the file content

The next example presents how to create a class that defines two instructions The first instruction is : I want window
The second instruction is : Window title = Expression Also keywords that can be ignored like the the keyword
New App
{
I want window
The window title = "hello world"
}

Class App

# Attributes for the instruction I want window

i want window
nIwantwindow = 0
# Attributes for the instruction Window title
# Here we don't define the window attribute again
title
nWindowTitle = 0
# Keywords to ignore, just give them any value
the=0

func geti
if nIwantwindow = 0
nIwantwindow++
ok

func getwant
if nIwantwindow = 1
nIwantwindow++
ok

func getwindow
if nIwantwindow = 2
nIwantwindow= 0
see "Instruction : I want window" + nl
ok

3.9. Define Natural Statements 22

 Ring Documentation, Release 1.4.1

if nWindowTitle = 0
nWindowTitle++
ok

func settitle cValue

if nWindowTitle = 1
nWindowTitle=0
see "Instruction : Window Title = " + cValue + nl
ok

To complete the previous example, use read() to get the content of a file that contains
I want window
The window title = "hello world"

Then use eval() to execute the content of that file!. Also, you can update the methods GetWindow() and SetTitle() to
create Real windows using the GUI Library

3.10 Define Declarative Languages

We learned how to use Natural statements to execute our code and using the same features we can use nested structures
to execute our code.
The next example from the Web library, generate HTML document using the Bootstrap library. No HTML code is
written directly in this example, we created a similar language (just as example) Then using this declarative language
that uses nested structures, we generated the HTML Document.. The idea in this example is that the GetDiv() and
GetH1() methods return an object that we can access using {} and after each object access the method BraceEnd() will
be executed to send the generated HTML to the parent object until we reach to the root where BraceEnd() will print
the output.
Load "weblib.ring"
Import System.Web

Func Main

BootStrapWebPage()
{
div
{
classname = :container
div
{
classname = :jumbotron
H1 { text("Bootstrap Page") }
}
div
{
classname = :row
for x = 1 to 3
div
{
classname = "col-sm-4"
H3 { html("Welcome to the Ring programming language") }
P { html("Using a scripting language is very fun!") }
}
next
}

3.10. Define Declarative Languages 23

 Ring Documentation, Release 1.4.1

}
}

The classes that power the declarative interface looks like this
Class Link from ObjsBase
title link
Func braceend
cOutput = nl+GetTabs() + "<a href='" +
Link + "'> "+ Title + " </a> " + nl

Class Div from ObjsBase

Func braceend
cOutput += nl+'<div'
addattributes()
AddStyle()
getobjsdata()
cOutput += nl+"</div>" + nl
cOutput = TabMLString(cOutput)

3.11 Smart Garbage Collector

Avoid memory problems :-

Invalid Memory Access
Memory leaks
Uninitialized Memory Access
Dangling pointer
Rules :-
Global variables always stay in the memory, until you delete these variables using the assignment statement.
Local variables always deleted after the end of the function.
The programmer have full control on when to delete the variable from the memory using the Assignment state-
ment.
Example:
aList = [1,2,3,4,5]
aList = "nice"

After the second line directly, The list [1,2,3,4,5] will be deleted from the memory and we will have a string nice
The programmer can call the function callgc() to force running the garbage collector.
If we have a reference to a variable (when we pass objects and lists to functions), then deleting variables will be
based on reference counting, if no references everything will be deleted, but if we have a reference, the data will
stay in memory.

3.11. Smart Garbage Collector 24

 CHAPTER

FOUR

WHAT IS NEW IN RING 1.4.1?

In this chapter we will learn about the changes in Ring 1.4.1 release.
Ring 1.4.1 is a little update to Ring 1.4

4.1 List of changes and new features

Ring 1.4.1 comes with the next changes

Better Scripts for Building from Source Code
Better Colors for the Modern Style in Ring Notepad
Better StdLib
Better RingQt
New Sample : Sixteen Puzzle

4.2 Better Scripts for Building from Source Code

The scripts are updated for building from source code.

Tested using Windows, Ubuntu Linux, Linux Mint and MacOS X.
Screen Shot:

25
 Ring Documentation, Release 1.4.1

4.3 Better Colors for the Modern Style in Ring Notepad

In Ring Notepad - the (Modern) Style colors are updated

Screen Shot:

4.3. Better Colors for the Modern Style in Ring Notepad 26

 Ring Documentation, Release 1.4.1

4.4 Better StdLib

The StdLib is updated to include the next functions

TrimLeft()
TrimRight()
TrimAll()
EpochTime()

4.5 Better RingQt

The next functions are updated to display the dialogs on the top of other windows.
SetDialogIcon(cIconFile)
MsgInfo(cTitle,cMessage)
ConfirmMsg(cTitle,cMessage)
InputBox(cTitle,cMessage)
InputBoxInt(cTitle,cMessage)
InputBoxNum(cTitle,cMessage)
InputBoxPass(cTitle,cMessage)

4.6 New Sample : Sixteen Puzzle

The Sixteen Puzzle is added to the Applications folder.

Screen Shot:

4.4. Better StdLib 27

 Ring Documentation, Release 1.4.1

4.6. New Sample : Sixteen Puzzle 28

 CHAPTER

FIVE

WHAT IS NEW IN RING 1.4?

In this chapter we will learn about the changes and new features in Ring 1.4 release.

5.1 List of changes and new features

Ring 1.4 comes with many new features

Change: Basic Extensions are separated from RingVM
The Natural Library
New Style is added to Ring Notepad
RingREPL
Convert between Numbers and Bytes
Better StdLib
Better WebLib
Better RingQt
Qt Class Convertor

5.2 Change: Basic Extensions are separated from RingVM

In Ring 1.4 the next libraries are separated from RingVM

RingODBC
RingMySQL
RingSQLite
RingOpenSSL
RingInternet
To use these libraries, Use the Load command.
load "odbclib.ring"
# use ODBC Functions

load "mysqllib.ring"
# use MySQL Functions

29
 Ring Documentation, Release 1.4.1

load "sqlitelib.ring"
# use SQLite Functions

load "openssllib.ring"
# use OpenSSL Functions ( Hash and Security functions)

load "internetlib.ring"
# use Internet Functions ( Download() and SendEmail() )

If you will use all of these libraries, You can just use stdlib.ring And the stdlib.ring will load odbclib.ring, mysqllib.ring,
sqlitelib.ring, opensslib.ring and internetlib.ring files.
load "stdlib.ring"

5.3 The Natural Library

Ring 1.4 comes with the Natural Library to quickly define a language that contains a group of commands.
We will write the natural code in a Text file, for example program.txt
File: program.txt
Welcome to the Ring programming language!
What you are reading now is not comments, I swear!

After many years of programming I decided to think different about

programming and solve the problems in a better way.

We are writing commands or code and the Ring language is reading

it to understand us! Sure, What you are seeing now is
just ***part of the code - Not the Complete Program***
You have to write little things before and after this
part to be able to run it!

It is the natural part of our code where we can write in English,

Arabic or any Natural Language Then we will tell the computer
through the Ring language what must happens! in a way that we can scale
for large frameworks and programs.

Just imagine what will happens to the world of programming once

we create many powerful frameworks using the Ring language that
uses this way (Natural Programming).

For example When we say Hello to the Machine, It can reply! and when we
say count from 1 to 5 it will understand us, Also if
we said count from 5 to 1 it will
understand us too! You can see the Output window!

This Goal is not new, but the Ring language comes

with an innovative solution to this problem.

Output:
Hello, Sire!

The Numbers!

5.3. The Natural Library 30

 Ring Documentation, Release 1.4.1

I will count Again!

To execute the natural code, We have start.ring

In start.ring we define the language and the commands.
File: start.ring
load "stdlib.ring"
load "naturallib.ring"

New NaturalLanguage {
SetLanguageName(:MyLanguage)
SetCommandsPath(CurrentDir()+"/../command")
SetPackageName("MyLanguage.Natural")
UseCommand(:Hello)
UseCommand(:Count)
RunFile("program.txt")
}

We defined a language called MyLanguage, We have folder for the language commands.
Each command will define a class that belong to the MyLanguage.Natural package.
We will define two commands, Hello and Count.
So we must have two files for defining the commands in the CurrentDir()+/../command folder
File: hello.ring
DefineNaturalCommand.SyntaxIsKeyword([
:Package = "MyLanguage.Natural",
:Keyword = :hello,
:Function = func {
See "Hello, Sire!" + nl + nl
}
])

File: count.ring

5.3. The Natural Library 31

 Ring Documentation, Release 1.4.1

DefineNaturalCommand.SyntaxIsKeywordNumberNumber([
:Package = "MyLanguage.Natural",
:Keyword = :count,
:Function = func {
if not isattribute(self,:count_times) {
AddAttribute(self,:count_times)
Count_Times = 0
}
if Expr(1) > Expr(2) {
nStep = -1
else
nStep = 1
}
if Count_Times = 0 {
see nl+"The Numbers!" + nl
Count_Times++
else
see nl + "I will count Again!" +nl
}
for x = Expr(1) to Expr(2) step nStep {
see nl+x+nl
}
CommandReturn(fabs(Expr(1)-Expr(2))+1)
}
])

5.4 New Style is added to Ring Notepad

In Ring Notepad - From View - Styles - Select the (Modern) Style

Screen Shot:

5.4. New Style is added to Ring Notepad 32

 Ring Documentation, Release 1.4.1

5.5 RingREPL

In the application folder, You will find RingREPL (Read-Eval-Print-Loop)

Also you can run it from Ring Notepad (Menubar - Tools)
Screen Shot:

5.6 Convert between Numbers and Bytes

Ring 1.4 comes with the next functions to convert between Numbers and Bytes.
Int2Bytes()
Float2Bytes()
Double2Bytes()
Bytes2Int()
Bytes2Float()

5.5. RingREPL 33
 Ring Documentation, Release 1.4.1

Bytes2Double()
Example:
see "Test Int2Bytes() and Bytes2Int() - Value : 77" + nl
r = Int2Bytes(77)
see "Int Size : " + len(r) + nl
see r + nl
see Bytes2Int(r) + nl
see "Test Float2Bytes() and Bytes2Float() - Value 77.12" + nl
r = Float2Bytes(77.12)
see "Float Size : " + len(r) + nl
see r + nl
see Bytes2Float(r) + nl
see "Test Double2Bytes() and Bytes2Double() - Value 9999977.12345" + nl
r = Double2Bytes(9999977.12345)
see "Double Size : " + len(r) + nl
see r + nl
decimals(5)
see Bytes2Double(r) + nl

5.7 Better StdLib

The StdLib is updated to include the next functions

FSize()
The print() function is updated to accept local variables.
load "stdlib.ring"

func main
print("Enter your name : ") ;
Name = getString() ;
print( "Hello : #{Name} ") ;
return ;

5.8 Better WebLib

The web library is updated

Provide better error message
1. Error (WebLib-1) : REQUEST_METHOD is empty ! - Run this script from the browser
2. Error (DataLib-1) : Cant connect to the database server!
Better Template() function - can accept NULL instead of object as the second paramter.
html(template("main.rhtml",NULL))

The Form Class is updated to support the target attribute.

BootStrapWebPage()
{
Title = "The Ring Programming Language"
html(template("main.rhtml",NULL))

5.7. Better StdLib 34

 Ring Documentation, Release 1.4.1

div {
classname = :container
div
{
id = "div3"
color = "black"
backgroundcolor = "white"
width = "100%"
form
{
method = "POST"
Action = website
Target = "codeoutput"
input { type="hidden" name="page" value=1 }
Table
{
style = stylewidth("100%") +
stylegradient(3)
TR
{

TD { align="center"
WIDTH="10%"
text("Code :")
}
TD {
html(`
<textarea name = "cCode"
rows="5"
style="width : 100%; ">
See "Hello, World!" + nl
</textarea>`)
}
}
}
Input { type = "submit"
classname="btn btn-primary btn-block"
value = "Execute" }
Table
{
style = stylewidth("100%") +
stylegradient(34)
TR
{

TD { align="center"
WIDTH="10%"
text("Output :")
}
TD {
html(`
<iframe name="codeoutput"
width="100%"
style="background-color:white;">
</iframe>`)
}
}
}

5.8. Better WebLib 35

 Ring Documentation, Release 1.4.1

}
}

}
html(template("footer.rhtml",NULL))
}

5.9 Better RingQt

The next functions are added to RingQt

SetDialogIcon(cIconFile)
MsgInfo(cTitle,cMessage)
ConfirmMsg(cTitle,cMessage)
InputBox(cTitle,cMessage)
InputBoxInt(cTitle,cMessage)
InputBoxNum(cTitle,cMessage)
InputBoxPass(cTitle,cMessage)
The next classes are added to RingQt
QToolButton
QSerialPort
QSerialPortInfo

5.10 Qt Class Convertor

Ring 1.4 comes with a simple tool that help in porting Qt classes to RingQt.
You will find it in ring/samples/tools/QtClassConverter
Online : https://github.com/ring-lang/ring/tree/master/samples/tools/QtClassConverter
Screen Shot:

5.9. Better RingQt 36

 Ring Documentation, Release 1.4.1

5.10. Qt Class Convertor 37