Hello World program

The same program can be written using different styles. Here is an example of the standard "Hello, World!" program using four different styles.

The first style:

see "Hello, World!"

The second style:

put "Hello, World!"

The third style:

load "stdlib.ring"
print("Hello, World!")

Another style: similar to xBase languages like Clipper and Visual FoxPro

? "Hello, World!"

Change the Keywords and Operators

Ring supports changing the language keywords and operators.

This could be done many times in the same source file, and is useful for

• Translating the keywords from English to other human languages (Non-English-based programming languages)
• Customizing the language for use of a favorite style
• Porting Legacy code written in other languages

Translate Ring keywords to Japanese

ChangeRingKeyword  See 手紙を出す
ChangeRingOperator + そして
改行 = nl
します。 = :します。

手紙を出す "こんにちは、世界" そして 改行 します。

ChangeRingKeyword 手紙を出す See // キーワードの復旧
ChangeRingOperator そして     + // 演算子の復旧

Translate Ring keywords to Arabic

ChangeRingKeyword  See إطبع

إطبع "Hello, World!"

ChangeRingKeyword إطبع See

Use style similar to the Pascal programming language

ChangeRingKeyword func function
ChangeRingKeyword see  write
begin = :begin

function main
begin
write("Hello, World!");
return 0;
end

ChangeRingKeyword function func
ChangeRingKeyword write see

^[23][24]

Loop Command

The Loop command can take an integer to apply the continue semantics to enclosing outer loops^[25]

changeRingKeyword loop continue
count = 2
for x in 1:5
    for y = 1 to 2
        if x = 3
            ? "About to execute 'loop', count = " + count
            continue count
        ok
        ? "x: " + x + ", y: " + y
    next
next

Object Oriented Programming

Ring supports Object Oriented Programming (Classes, Objects, Composition, Inheritance, Encapsulation, etc.)^[26]

new point {            # Create new object from the Point class the access the object using braces
x=10  y=20  z=30       # Set the object attributes
print()                # Call the print() method
}                      # end of object access using braces
class point            # Define the class
x y z                  # Define the attributes (x,y,z)
func print             # Define the print() method
? x + nl + y + nl + z  # Print the attributes values (nl means printing a new line)

In Ring classes can be defined at runtime using the Eval() function^[27]

? "Creating a new class dynamically..."
eval("class DynamicClass a b")

? "Printing the instance..."
? new DynamicClass {a=1 b=2}

Compiler and Virtual Machine

Ring VM implementation using PWCT - Virtual Machine Instructions

Ring VM implementation using PWCT - List Structure

Ring programs are not interpreted directly from the textual Ring file, but are compiled into bytecode, which is then run on the Ring virtual machine. The compilation process is typically invisible to the user and is performed at run-time, but it can be done offline in order to increase loading performance or reduce the memory footprint of the host environment by leaving out the compiler.

The Compiler and the Virtual Machine are designed using Visual Programming through the Programming Without Coding Technology software then the C code is generated.

Extensions

Online Form Designer (WebAssembly) - Using RingQt

Sokoban Implementation using Ring Game Engine for 2D Games

Using Qt3D through RingQt

The following are extensions that can be used immediately after the installation of the full installation version (with a file size of about 280 MB for Ring 1.12). Since these are officially provided and maintained on the Ring side, the users are not bothered by library dependencies that may cause problems in other languages, and there is a concern that they can not be used suddenly even if there are destructive language specification changes.

The extensions are implemented in approximately 500,000 lines of C and C++ code.

• RingAllegro (Allegro Game Library)
• RingConsoleColor (Text coloring library for command prompt or the terminal)
• RingCurl (CURL Library)
• RingFreeGLUT (FreeGLUT)
• RingInternet (Internet related library)
• RingLibUV (LibUV-asynchronous I / O library)
• RingMurMurHash (Hash Function Library)
• RingMySQL (MySQL)
• RingODBC (Open Database Connectivity)
• RingOpenGL (OpenGL 1.1-4.6)
• RingOpenSSL (OpenSSL)
• RingPostgreSQL (PostgreSQL)
• RingQt (Qt framework)
• RingRayLib (raylib)
• RingSDL (SDL-Simple DirectMedia Layer Library)
• RingSQLite (SQLite)
• RingWinAPI (Windows API)
• RingWinCREG (Windows Registry)
• RingZIP (zip file processing library)

^[28]

Libraries

Ring comes with libraries written in Ring itself, such as libraries related to web and game development.

^[29][30]

Applications

Gold Magic 800 Game - Using RingAllegro and RingOpenGL

Online Othello Game (WebAssembly) - Using RingQt

Ring is distributed with over 60 applications written in the language.

Some of these applications are

• Analog Clock application
• Calculator application
• The Checkers Game
• The Chess Game
• Fifteen Puzzle 3D Game
• Game 2048
• Knight Tour Game
• Minesweeper Game
• Othello Game
• Sokoban Game
• Sudoku Game
• Tic-tac-toe 3D Game
• Video Music Player application
• Windows Startup Manager application

^[31][32]

Tools

Running the Tetris game using the Ring Package Manager

Ring is distributed with a Standard IDE that includes the following tools:

• Ring REPL (Read–eval–print loop)
• Ring2EXE (Distributing executable applications)
• RingPM (The Ring Package manager)
• Ring Notepad (Source-code editor)
• Form Designer (WYSIWYG GUI designer)

Ring is also distributed with extensions for many code editors such as Emacs, Notepad++, Geany, Atom, Sublime Text 2, and Visual Studio Code.

Documentation

Ring is distributed with documentation written using Sphinx. A Japanese translation of the documentation is also available.^[33]

Popularity

Ring had a rapid rise and fall in popularity as measured by the TIOBE Programming Community Index. In February 2018, Ring broke into the top 50 for the first time (position 45).^[34] As of October 2020, Ring holds position 93 on the TIOBE index.^[35] Ring is listed by GitHub in the list of programming languages that are actively developed.^[36]

Criticism

Ring critics pointed to some features in Ring that are not common in widely used programming languages.^[37]

• The list index starts from 1 instead of 0 (See: Zero-based numbering)
• Implicit type conversions (See: Implicit type conversions and "type punning")

cName = "Ring"
? cName[1]      # print R
aList = ["One","Two","Three"]
? aList[1]      # print One

/*
** Rules:
** <NUMBER> + <STRING> --> <NUMBER>
** <STRING> + <NUMBER> --> <STRING>
*/

x    = 10                # x is a number
y    = "20"              # y is a string
nSum = x + y             # nSum is a number (y will be converted to a number)
cMsg = "Sum = " + nSum   # cMsg is a string (nSum will be converted to a string)