doc1.14/faq.html



<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>Frequently Asked Questions (FAQ) &mdash; Ring 1.14 documentation</title>
  

  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="_static/css/custom.css" type="text/css" />

  
  <!--[if lt IE 9]>
    <script src="_static/js/html5shiv.min.js"></script>
  <![endif]-->
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
        <script src="_static/jquery.js"></script>
        <script src="_static/underscore.js"></script>
        <script src="_static/doctools.js"></script>
        <script src="_static/language_data.js"></script>
    
    <script type="text/javascript" src="_static/js/theme.js"></script>

    
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
    <link rel="next" title="Building From Source Code" href="sourcecode.html" />
    <link rel="prev" title="Using Other Code Editors" href="codeeditors.html" /> 
</head>

<body class="wy-body-for-nav">

   
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
          

            <a href="index.html">
          

            <img src="_static/ringdoclogo.jpg" class="logo" alt="Logo"/>
          
          </a>

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        
        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="ringapps.html">Applications developed in a few hours</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringnotepad.html">Using Ring Notepad</a></li>
<li class="toctree-l1"><a class="reference internal" href="getting_started.html">Getting Started - First Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="getting_started2.html">Getting Started - Second Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="getting_started3.html">Getting Started - Third Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">Variables</a></li>
<li class="toctree-l1"><a class="reference internal" href="operators.html">Operators</a></li>
<li class="toctree-l1"><a class="reference internal" href="controlstructures.html">Control Structures - First Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="controlstructures2.html">Control Structures - Second Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="controlstructures3.html">Control Structures - Third Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="getinput.html">Getting Input</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">Functions - First Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions2.html">Functions - Second Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions3.html">Functions - Third Style</a></li>
<li class="toctree-l1"><a class="reference internal" href="programstructure.html">Program Structure</a></li>
<li class="toctree-l1"><a class="reference internal" href="lists.html">Lists</a></li>
<li class="toctree-l1"><a class="reference internal" href="strings.html">Strings</a></li>
<li class="toctree-l1"><a class="reference internal" href="dateandtime.html">Date and Time</a></li>
<li class="toctree-l1"><a class="reference internal" href="checkandconvert.html">Check Data Type and Conversion</a></li>
<li class="toctree-l1"><a class="reference internal" href="mathfunc.html">Mathematical Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="files.html">Files</a></li>
<li class="toctree-l1"><a class="reference internal" href="systemfunc.html">System Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="evaldebug.html">Eval() and Debugging</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo.html">Demo Programs</a></li>
<li class="toctree-l1"><a class="reference internal" href="odbc.html">ODBC Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="mysql.html">MySQL Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="sqlite.html">SQLite Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="postgresql.html">PostgreSQL Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="secfunc.html">Security and Internet Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="oop.html">Object Oriented Programming (OOP)</a></li>
<li class="toctree-l1"><a class="reference internal" href="fp.html">Functional Programming (FP)</a></li>
<li class="toctree-l1"><a class="reference internal" href="metaprog.html">Reflection and Meta-programming</a></li>
<li class="toctree-l1"><a class="reference internal" href="declarative.html">Declarative Programming using Nested Structures</a></li>
<li class="toctree-l1"><a class="reference internal" href="natural.html">Natural language programming</a></li>
<li class="toctree-l1"><a class="reference internal" href="naturallibrary.html">Using the Natural Library</a></li>
<li class="toctree-l1"><a class="reference internal" href="scope.html">Scope Rules for Variables and Attributes</a></li>
<li class="toctree-l1"><a class="reference internal" href="scope2.html">Scope Rules for Functions and Methods</a></li>
<li class="toctree-l1"><a class="reference internal" href="syntaxflexibility.html">Syntax Flexibility</a></li>
<li class="toctree-l1"><a class="reference internal" href="typehints.html">The Type Hints Library</a></li>
<li class="toctree-l1"><a class="reference internal" href="debug.html">The Trace Library and the Interactive Debugger</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringemb.html">Embedding Ring Language in Ring Programs</a></li>
<li class="toctree-l1"><a class="reference internal" href="stdlib.html">Stdlib Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="stdlibclasses.html">Stdlib Classes</a></li>
<li class="toctree-l1"><a class="reference internal" href="qt.html">Desktop, WebAssembly and Mobile development using RingQt</a></li>
<li class="toctree-l1"><a class="reference internal" href="formdesigner.html">Using the Form Designer</a></li>
<li class="toctree-l1"><a class="reference internal" href="qt3d.html">Graphics Programming using RingQt3D</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringqtobjects.html">Objects Library for RingQt Application</a></li>
<li class="toctree-l1"><a class="reference internal" href="multilanguage.html">Multi-language Applications</a></li>
<li class="toctree-l1"><a class="reference internal" href="qtmobile.html">Building RingQt Applications for Mobile</a></li>
<li class="toctree-l1"><a class="reference internal" href="qtwebassembly.html">Building RingQt Applications for WebAssembly</a></li>
<li class="toctree-l1"><a class="reference internal" href="web.html">Web Development (CGI Library)</a></li>
<li class="toctree-l1"><a class="reference internal" href="deployincloud.html">Deploying Web Applications in the Cloud</a></li>
<li class="toctree-l1"><a class="reference internal" href="allegro.html">Graphics and 2D Games programming using RingAllegro</a></li>
<li class="toctree-l1"><a class="reference internal" href="gameengine.html">Demo Project - Game Engine for 2D Games</a></li>
<li class="toctree-l1"><a class="reference internal" href="gameengineandorid.html">Building Games For Android</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringraylib.html">Developing Games using RingRayLib</a></li>
<li class="toctree-l1"><a class="reference internal" href="usingopengl.html">Using RingOpenGL and RingFreeGLUT for 3D Graphics</a></li>
<li class="toctree-l1"><a class="reference internal" href="usingopengl2.html">Using RingOpenGL and RingAllegro for 3D Graphics</a></li>
<li class="toctree-l1"><a class="reference internal" href="goldmagic800.html">Demo Project - The Gold Magic 800 Game</a></li>
<li class="toctree-l1"><a class="reference internal" href="tilengine.html">Using RingTilengine</a></li>
<li class="toctree-l1"><a class="reference internal" href="performancetips.html">Performance Tips</a></li>
<li class="toctree-l1"><a class="reference internal" href="compiler.html">Command Line Options</a></li>
<li class="toctree-l1"><a class="reference internal" href="distribute.html">Distributing Ring Applications (Manual)</a></li>
<li class="toctree-l1"><a class="reference internal" href="distribute_ring2exe.html">Distributing Ring Applications using Ring2EXE</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringpm.html">The Ring Package Manager (RingPM)</a></li>
<li class="toctree-l1"><a class="reference internal" href="zerolib.html">ZeroLib Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="foxringfuncsdoc.html">FoxRing Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="bignumber.html">BigNumber Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="libcurl.html">Using RingLibCurl</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringlibcurlfuncsdoc.html">RingLibCurl Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="socket.html">Using RingSockets</a></li>
<li class="toctree-l1"><a class="reference internal" href="threads.html">Using RingThreads</a></li>
<li class="toctree-l1"><a class="reference internal" href="libui.html">Using RingLibui</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringzip.html">Using RingZip</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringlibzipfuncsdoc.html">RingLibZip Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringmurmurhashfuncsdoc.html">RingMurmurHash Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringconsolecolorsfuncsdoc.html">RingConsoleColors Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringallegrofuncsdoc.html">RingAllegro Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="libsdl.html">Using RingLibSDL</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringlibsdlfuncsdoc.html">RingLibSDL Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="libuv.html">Using Ringlibuv</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringlibuvfuncsdoc.html">RingLibuv Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringfreeglutfuncsdoc.html">RingFreeGLUT Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringstbimage.html">RingStbImage Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringopengl32funcsdoc.html">RingOpenGL (OpenGL 3.2) Functions Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="qtclassesdoc.html">RingQt Classes and Methods Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="lowlevel.html">Low Level Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="extension_tutorial.html">Tutorial: Ring Extensions in C/C++</a></li>
<li class="toctree-l1"><a class="reference internal" href="extension.html">Extension using the C/C++ languages</a></li>
<li class="toctree-l1"><a class="reference internal" href="embedding.html">Embedding Ring Language in C/C++ Programs</a></li>
<li class="toctree-l1"><a class="reference internal" href="codegenerator.html">Code Generator for wrapping C/C++ Libraries</a></li>
<li class="toctree-l1"><a class="reference internal" href="ringbeep.html">Create your first extension using the Code Generator</a></li>
<li class="toctree-l1"><a class="reference internal" href="languagedesign.html">Release Notes: Version 1.0</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew.html">Release Notes: Version 1.1</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew2.html">Release Notes: Version 1.2</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew3.html">Release Notes: Version 1.3</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew4.html">Release Notes: Version 1.4</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew5.html">Release Notes: Version 1.5</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew6.html">Release Notes: Version 1.6</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew7.html">Release Notes: Version 1.7</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew8.html">Release Notes: Version 1.8</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew9.html">Release Notes: Version 1.9</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew10.html">Release Notes: Version 1.10</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew11.html">Release Notes: Version 1.11</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew12.html">Release Notes: Version 1.12</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew13.html">Release Notes: Version 1.13</a></li>
<li class="toctree-l1"><a class="reference internal" href="whatisnew14.html">Release Notes: Version 1.14</a></li>
<li class="toctree-l1"><a class="reference internal" href="codeeditors.html">Using Other Code Editors</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Frequently Asked Questions (FAQ)</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#why-do-we-need-yet-another-programming-language-yapl">Why do we need Yet Another Programming Language (YAPL)?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-is-the-ring-architecture">What is the Ring Architecture?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-about-memory-management-in-ring">What about Memory Management in Ring?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-about-data-representation-in-ring">What about Data Representation in Ring?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-is-ring-weakly-typed">Why is Ring weakly typed?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-are-the-advantages-to-using-ring-over-lisp-or-smalltalk">What are the advantages to using Ring over Lisp or Smalltalk?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-is-ring-largely-focussed-on-ui-creation">Why is Ring largely focussed on UI creation?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#is-ring-some-sort-of-an-improvement-of-php">Is Ring some sort of an improvement of PHP?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-are-the-advantages-of-using-ring-over-native-c-or-c">What are the advantages of using Ring over native C or C++?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-is-the-difference-between-ring-and-python-and-is-ring-open-source">What is the difference between Ring and Python? And is Ring Open Source?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-are-the-advantages-to-using-ring-over-perl-php-python-or-ruby">What are the advantages to using Ring over Perl, PHP, Python or Ruby?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-are-the-advantages-to-using-ring-over-tcl-or-lua">What are the advantages to using Ring over Tcl or Lua?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-are-the-advantages-to-using-ring-over-c-or-java">What are the advantages to using Ring over C# or Java?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#the-documentation-says-functional-programming-is-supported-but-then-this-happens">The documentation says functional programming is supported, but then this happens?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-the-ability-to-define-your-own-languages-instead-of-just-handing-over-the-syntax-so-you-can-parse-it-using-whatever-code-you-like">Why the ability to define your own languages Instead of just handing over the syntax so you can parse it using whatever code you like?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-you-can-specify-the-number-of-loops-you-want-to-break-out-of">Why you can specify the number of loops you want to break out of?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-ring-uses-see-give-but-and-ok-keywords">Why Ring uses ‘See’, ‘Give’, ‘But’ and ‘Ok’ Keywords?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-is-the-philosophy-behind-data-types-in-ring">What is the philosophy behind data types in Ring?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-about-the-boolean-values-in-ring">What about the Boolean values in Ring?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-is-the-goal-of-including-the-main-function-in-ring">What is the goal of including the “Main” function in Ring?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-the-list-index-start-from-1-in-ring">Why the list index start from 1 in Ring?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-ring-is-not-case-sensitive">Why Ring is not case-sensitive?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-the-assignment-operator-uses-deep-copy">Why the Assignment operator uses Deep Copy?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#is-there-constructor-methods-in-ring">Is there constructor methods in Ring?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-happens-when-we-create-a-new-object">What happens when we create a new object?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#can-we-use-the-attributes-by-accessing-the-getter-and-setter-methods">Can we use the attributes by accessing the Getter and Setter methods?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-should-a-search-of-global-names-be-made-while-defining-the-class-attributes">Why should a search of global names be made while defining the class attributes?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-ring-doesn-t-avoid-the-conflict-between-global-variables-and-class-attributes-names">Why Ring doesn’t avoid the conflict between Global Variables and Class Attributes Names?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#where-can-i-write-a-program-and-execute-it">Where can I write a program and execute it?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-get-the-file-size-using-ftell-and-fseek-functions">How to get the file size using ftell() and fseek() functions?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-get-the-current-source-file-path">How to get the current source file path?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-about-predefined-parameters-or-optional-parameters-in-functions">What about predefined parameters or optional parameters in functions?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-print-keys-or-values-only-in-list-dictionary">How to print keys or values only in List/Dictionary?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-i-get-a-strange-result-when-printing-nl-with-lists">Why I get a strange result when printing nl with lists?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#could-you-explain-the-output-of-the-strcmp-function">Could you explain the output of the StrCmp() function?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-use-many-source-code-files-in-the-project">How to use many source code files in the project?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-this-example-use-the-getchar-twice">Why this example use the GetChar() twice?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-use-null-and-isnull-function">How to use NULL and ISNULL() function?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-print-lists-that-contains-objects">How to print lists that contains objects?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-insert-an-item-to-the-first-position-in-the-list">How to insert an item to the first position in the list?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-print-new-lines-and-other-characters">How to print new lines and other characters?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-we-don-t-use-after-the-qapp-class-name">Why we don’t use () after the QApp class name?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-the-window-title-bar-is-going-outside-the-screen">Why the window title bar is going outside the screen?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-create-an-array-of-buttons-in-gui-applications">How to create an array of buttons in GUI applications?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-close-a-window-then-displaying-another-one">How to Close a window then displaying another one?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-create-a-modal-window">How to create a Modal Window?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-can-i-disable-maximize-button-and-resize-window">How can I disable maximize button and resize window?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-use-sqlite-using-odbc">How to use SQLite using ODBC?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#can-i-connect-to-dbase-harbour-database">Can I connect to dbase/harbour database?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-setclickevent-doesn-t-see-the-object-methods-directly">Why setClickEvent() doesn’t see the object methods directly?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#why-i-get-calling-function-without-definition-error">Why I get Calling Function without definition Error?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#can-ring-work-on-windows-xp">Can Ring work on Windows XP?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-extend-ringqt-and-add-more-classes">How to extend RingQt and add more classes?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-add-combobox-and-other-elements-to-the-cells-of-a-qtablewidget">How to add Combobox and other elements to the cells of a QTableWidget?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-perform-some-manipulations-on-selected-cells-in-qtablewidget">How to perform some manipulations on selected cells in QTableWidget?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#which-of-3-coding-styles-are-commonly-used-or-recommended-by-the-community">Which of 3 coding styles are commonly used or recommended by the community?</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="sourcecode.html">How to Compile Ring From Source Code?</a></li>
<li class="toctree-l1"><a class="reference internal" href="contribute.html">How to contribute?</a></li>
<li class="toctree-l1"><a class="reference internal" href="reference.html">Language Specification</a></li>
<li class="toctree-l1"><a class="reference internal" href="resources.html">Resources</a></li>
</ul>

            
        </div>
        
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="index.html">Ring</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          
<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
        
      <li>Frequently Asked Questions (FAQ)</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
            
      </li>
    
  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="frequently-asked-questions-faq">
<span id="index-0"></span><h1>Frequently Asked Questions (FAQ)<a class="headerlink" href="#frequently-asked-questions-faq" title="Permalink to this headline">¶</a></h1>
<div class="section" id="why-do-we-need-yet-another-programming-language-yapl">
<span id="index-1"></span><h2>Why do we need Yet Another Programming Language (YAPL)?<a class="headerlink" href="#why-do-we-need-yet-another-programming-language-yapl" title="Permalink to this headline">¶</a></h2>
<p>The language comes with better support for natural language programming and declarative
programming. The innovation comes in supporting these paradigms with new practical techniques
on the top of object-oriented programming and functional programming. Ring provides the programmers
with the tools required to build a natural language like Supernova or a declarative language
like REBOL and QML without the need to know anything about (compilers and parsing). You get
the language constructs ready for use to create domain-specific languages in a fraction of time.</p>
<p>Take a look at the Supernova programming language, in this language you can type:
(I want window and the window title is hello world.) and it will create a GUI window
with “Hello, World!” as the window title. When I created Supernova language in 2010, i discovered
that using the natural code can be (similar to English and without limits and we can use the power
of human language in programming) but to implement that you need a new language that has:</p>
<ol class="arabic simple">
<li><p>General Purpose</p></li>
<li><p>Practical</p></li>
<li><p>Can create natural languages very quickly.</p></li>
</ol>
<p>So we can get a system that can increase ease of use and productivity to the maximum level.</p>
<p>So I created Ring because it was the best way to achieve this goal.</p>
<p>Supernova was just a test of the idea, it helped getting a better view of the advantages and
the disadvantages of the idea. And After testing the new ideas you are provided with something
practical. So now we have Ring after Supernova. A story that is maybe similar to having Python
after ABC.Where Python avoids the problems of ABC, but keeps the advantages of ABC. Also, Ring
learns from Ruby and ROR’s story. The language power could appear in frameworks better than the
direct usage as a general purpose language. Also Ring comes with a clear goal/motivation;
(Creating a new version of the PWCT Software) something that was learned from the design the
C language in a certain way to create the Unix Operating System. In other words, you have a
goal that directs you in each design decision.</p>
<p>You will understand the value of our decisions once you start trying to solve the problem
that we will use Ring to solve. The questions is: could you enable any one in the world
without knowledge about computer programming concepts to create very powerful software?
Scientifically the answer is (visual Programming) and (natural Programming).
In practice we are still away from switching to these paradigms without introducing
other problems. Ring is designed to solve this problem.
It is designed to provide natural programming in a practical way. And to create a powerful
visual programming tool. Ring is designed to be a new world of programming after 10 years
of research in visual programming and natural languages.</p>
<p>The Ring Programming Language (Compiler+VM) is developed 100% using visual programming without
writing a single line of code. I used my tool (Programming Without Coding Technology) to design
everything and get the C code generated for me.</p>
<p>Advantages ?</p>
<ol class="arabic simple">
<li><p>Faster</p></li>
<li><p>No Syntax Errors</p></li>
<li><p>Easy to understand and manage the code because the abstraction level is higher</p></li>
<li><p>No critical disadvantages because you can control everything as writing your code.</p></li>
</ol>
<p>Using my experience in using visual programming for 10 years and natural programming for 5 years,
I designed Ring to move the knowledge to mainstream programmers by providing a practical language
that supports these ideas.</p>
<p>I agree that each programmer/developer has the freedom to form his opinions about any software
including programming languages. Ring is not an exception but you may miss the idea behind the
language. It is innovative and may help you to think differently about how to solve your problems.
Maybe this is not clear to many programmers because It is a practical language and includes many
features known to programmers and when a programmer looks at the language they maight think that
nothing new because it’s familiar. I created Ring to solve problems in a different way. Where I
will start programming just by describing the software using new natural interfaces that I will
implement later when I move from the design stage to the implementation stage.
(I don’t determine the time to switch between stages, You are free to use Agile methods).
Since Ring is a new language you have 3 options:</p>
<ol class="arabic simple">
<li><p>To not care at all for now.</p></li>
<li><p>Think of the future of the language and help us if you understand the idea and want to contribute.</p></li>
<li><p>Wait and come back again in the future to use it.</p></li>
</ol>
<p>Summary:</p>
<ul class="simple">
<li><p>Ring is designed based on a need to develop a new version of the PWCT software.</p></li>
</ul>
<p>Once we finish PWCT 2.0 we will have good and large software developed using Ring.</p>
<ul class="simple">
<li><p>We will push declarative and natural paradigms many steps forward. Also in next versions</p></li>
</ul>
<p>we have a plan to present a new paradigm for network programming and concurrency. We tested this
new paradigm through simple prototypes during the last years and we will integrate it with Ring
in future releases.</p>
</div>
<div class="section" id="what-is-the-ring-architecture">
<span id="index-2"></span><h2>What is the Ring Architecture?<a class="headerlink" href="#what-is-the-ring-architecture" title="Permalink to this headline">¶</a></h2>
<p>We have the next architecture</p>
<ol class="arabic simple">
<li><p>Ring Applications (Your Code)  - Written in Ring - See folder : ring/applications</p></li>
<li><p>Ring Libraries (StdLib, WebLib, GameEngine, etc) - Written in Ring - See folder : ring/libraries</p></li>
<li><p>Ring Extensions (RingAllegro, RingQt, etc) - Written in C/C++ (may include Ring code) - See folder : ring/extensions</p></li>
<li><p>Ring Virtual Machine (Ring VM) - Written in C language</p></li>
<li><p>Operating System (Current Platform) - (Windows, Linux, macOS, Android, etc)</p></li>
</ol>
<p>The extensions are just dynamic libraries (DLL, So, Dylib)
You can update the extensions without the need to update your code.</p>
<p>Folder (ring/extensions/libdepwin) ====&gt; C libraries used for building Ring Extensions (written in C) on Windows platform</p>
<p>Folder (ring/libraries)  ====&gt; Ring libraries written in Ring itself (StdLib, WebLib, GameEngine, etc)</p>
<p>Folder (ring/language/visualsrc) ====&gt; The Visual Source Code of the Ring Compiler &amp; Ring VM developed using Programming Without Coding Technology (PWCT)</p>
<p>We use the term Ring Library —&gt; When the library code is written in Ring
We use the term Ring Extension —&gt; When the library code is Written in C or C++</p>
</div>
<div class="section" id="what-about-memory-management-in-ring">
<span id="index-3"></span><h2>What about Memory Management in Ring?<a class="headerlink" href="#what-about-memory-management-in-ring" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p>When we call function, we get a new scope for this function, inside this scope we store variables.</p></li>
</ol>
<p>Also we get Temp. memory for this function. Inside this temp. memory we store temp. lists</p>
<p>All of this will be deleted directly after the end of the function call (end of scope)</p>
<ol class="arabic simple" start="2">
<li><p>In Ring to delete memory, you have the next options</p></li>
</ol>
<p>2.1 Wait until the end of the function scope</p>
<p>2.2 Use the Assignment operator</p>
<p>2.3 Use callgc() function (delete temp. lists only)</p>
<ol class="arabic simple" start="3">
<li><p>Ring Garbage Collector uses Escape Analysis and Reference Counting</p></li>
</ol>
<p>In 90% of cases, the Escape Analysis is used so we don’t waste time in running the garbage collector
We directly know what will be deleted and what will remain in the memory.</p>
<p><a class="reference external" href="https://en.wikipedia.org/wiki/Escape_analysis">https://en.wikipedia.org/wiki/Escape_analysis</a></p>
<p>In 10% of cases (or less than that) Ring may use Reference Counting.</p>
<p>For example when we pass a list and sub list to a function
Ring will pass the lists by reference, but what will happens if we deleted the Parent List?
In this case, the Sub List will use reference counting, and when deleting the Parent List, it will stay in memory until the end of the function.</p>
<p>Remember that Ring encourage us to avoid using references, and the
Assignment Operator will copy lists by value, so Ring usage of reference counting is
very limited to special cases and in most cases the Escape Analysis is enough which is very fast.</p>
<p>Starting from Ring 1.9 we extended the Reference Counting support to Ring Extensions and low level C pointers.
So we don’t have to care about using fclose() when we use fopen() for example. and the same for
other extensions like RingODBC, RingSQLite, RingMySQL, RingQt, etc.</p>
<p>All of the allocated resources will be cleaned by the Garbage Collector when we finish using it (when we lost the last reference).</p>
</div>
<div class="section" id="what-about-data-representation-in-ring">
<span id="index-4"></span><h2>What about Data Representation in Ring?<a class="headerlink" href="#what-about-data-representation-in-ring" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p>In Ring, The String is just (Array of bytes)</p></li>
</ol>
<p>Ring is 8-bit clean, Each character in the string is 8 bits (1 byte)</p>
<p>So these functions (Int2Bytes(), Float2Bytes() and Double2Bytes()) just return a string.</p>
<p>Also we can store binary data in strings</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">mystring</span> <span class="o">=</span> <span class="n">read</span><span class="p">(</span><span class="s">&quot;myfile.exe&quot;</span><span class="p">)</span>
</pre></div>
</div>
<ol class="arabic simple" start="2">
<li><p>Remember this, when you think about variables</p></li>
</ol>
<ul class="simple">
<li><p>Value —&gt; What we have (What we are storing in the computer memory as data) - Low Level Concept</p></li>
<li><p>Type  —&gt; What we can do with what we have or how we do things with what we have (Just a Logical Concept)</p></li>
</ul>
<p>Computer memory —-&gt; Just store [Bytes] - Each byte is 8-bit - (Here we avoid the memory word concept)</p>
<p>These bytes could be grouped together when moved between the memory and the processor registers.
Here we have (The register size) and things like 32-bit and 64-bit for example.
Also we have the bytes order.</p>
<p>Programming Languages —-&gt; Add Types (Just as a concept) to these bytes so we can determine what to do with them and how operations should be done.</p>
<p>And programming language could allow (Type Conversion) —&gt; Because the Type is a logical concept in most cases, What we really have is just data (Bytes, Bytes Count, Bytes Order, etc)</p>
<p>Ring Strings —-&gt; You have these bytes (each byte is 8-bit) and Ring know the string size (stored as number in the String structure)</p>
<p>So we don’t check the NULL character or add it to the end of the string (Not Required)</p>
<p>All operations inside Ring VM, will check the Ring size and deal with the string as binary data (each character is 8-bit)</p>
<p>In the C language —&gt; The normal case is adding NULL character (0) to the end of each string</p>
<p>And the string functions check this character, This is not suitable for binary data.</p>
<p>Signed vs Unsigned —&gt; Is a logical concept which is important when you do arithmetic operations on the data, but when storing the data, if you will include all of the (8-bits) and will not ignore any of them —&gt; Then don’t care.</p>
<p>In Ring, don’t think about these details, we are hiding it from you, so you can focus on your application and what you will do.</p>
<dl class="simple">
<dt>Think in C when you write C code which could be (based on need) low level code to have control on everything.</dt><dd><p>—-&gt; Good for performance and memory management</p>
</dd>
</dl>
<p>Think in Ring when you write Ring code which let you ignore a lot of details and concentrate only on the result
—–&gt; Good for productivity and delivering software quickly</p>
<p>The good news (We can mix between Ring and C in our projects)</p>
<ol class="arabic simple" start="3">
<li><p>The functions Int2Bytes(), Float2Bytes() and Double2Bytes()</p></li>
</ol>
<p>These function take input as (Number) —&gt; Convert it to group of bytes based on the number type (int|float|double) —&gt; Then return a Ring string that contains these bytes</p>
<p>Int2Bytes() —&gt; Ring string (Group of bytes) and the string size = sizeof(int)</p>
<p>Float2Bytes() —&gt; Ring string (Group of bytes) and the string size = sizeof(float)</p>
<p>Double2Bytes() —&gt; Ring string (Group of bytes) and the string size = sizeof(double)</p>
<p>Example:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="o">?</span> <span class="n">len</span><span class="p">(</span> <span class="n">int2bytes</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="p">)</span>
<span class="o">?</span> <span class="n">len</span><span class="p">(</span> <span class="n">float2bytes</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="p">)</span>
<span class="o">?</span> <span class="n">len</span><span class="p">(</span> <span class="n">double2bytes</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="p">)</span>
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>4
4
8
</pre></div>
</div>
<ol class="arabic simple" start="4">
<li><p>Storing Numbers</p></li>
</ol>
<p>When we use a number, Ring always use the (Double) data type for representing these numbers in memory.
This is important to know when we do arithmetic operations on numbers.</p>
<p>But when we convert the number to a String using “” + number  or using string(number) we get a string where each digit is represented in 1 byte (Not good idea for storage, but useful for string processing)</p>
<p>If you need the number to be represented in specific size (int|float|double) for storage then use bytes2int() , bytes2float() and bytes2double() when writing the data to binary files.</p>
<p>Ring Number (double) —-&gt; int2bytes()  - will cast the number from double to int then return the bytes —-&gt; 4 bytes (Ring String)</p>
<p>Ring Number (double) —-&gt; float2bytes()  - will cast the number from double to float then return the bytes —-&gt; 4 bytes (Ring String)</p>
<p>Ring Number (double) —-&gt; double2bytes()  - will use the number (double) to return the bytes —-&gt; 8 bytes (Ring String)</p>
<p>The (int) type is used only for internal Ring operations, but Ring applications|code will use only the (double) type for numbers.</p>
<ol class="arabic simple" start="5">
<li><p>The Unsigned() Function</p></li>
</ol>
<p>The function unsigned() expect the first and the second parameters as numbers</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">unsigned</span><span class="p">(</span><span class="n">nNumber1</span><span class="p">,</span><span class="n">nNumber2</span><span class="p">,</span><span class="n">cOperator</span><span class="p">)</span>
</pre></div>
</div>
<p>We can use the bytes2int() function to convert the bytes to a number</p>
<p>Example:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">B</span> <span class="o">=</span> <span class="kt">list</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>

<span class="k">for</span> <span class="n">k</span><span class="o">=</span><span class="mi">1</span> <span class="k">to</span> <span class="mi">4</span>
<span class="p">{</span>
        <span class="n">B</span><span class="o">[</span><span class="n">k</span><span class="o">]=</span> <span class="n">Space</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>
        <span class="k">for</span> <span class="n">kk</span><span class="o">=</span><span class="mi">1</span> <span class="k">to</span> <span class="mi">4</span> <span class="p">{</span> <span class="n">B</span><span class="o">[</span><span class="n">k</span><span class="o">][</span><span class="n">kk</span><span class="o">]=</span> <span class="n">char</span><span class="p">(</span><span class="mi">60</span><span class="o">+</span><span class="mi">4</span><span class="o">*</span><span class="n">k</span> <span class="o">+</span><span class="n">kk</span><span class="p">)</span> <span class="p">}</span>
        <span class="o">?</span> <span class="s">&quot; B&quot;</span> <span class="o">+</span><span class="n">k</span> <span class="o">+</span><span class="s">&quot;: &quot;</span> <span class="o">+</span><span class="n">B</span><span class="o">[</span><span class="n">k</span><span class="o">]</span>
<span class="p">}</span>

<span class="n">A12</span><span class="o">=</span> <span class="n">Space</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>     <span class="n">A12</span><span class="o">=</span> <span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">1</span><span class="o">]</span><span class="p">)</span> <span class="p">^</span> <span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">2</span><span class="o">]</span><span class="p">)</span>
<span class="o">?</span> <span class="s">&quot;A12: &quot;</span> <span class="o">+</span><span class="kt">string</span><span class="p">(</span><span class="n">A12</span><span class="p">)</span>
<span class="n">A34</span><span class="o">=</span> <span class="n">Space</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>     <span class="n">A34</span><span class="o">=</span> <span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">3</span><span class="o">]</span><span class="p">)</span> <span class="p">^</span> <span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">4</span><span class="o">]</span><span class="p">)</span>
<span class="o">?</span> <span class="s">&quot;A34: &quot;</span> <span class="o">+</span><span class="kt">string</span><span class="p">(</span><span class="n">A34</span><span class="p">)</span>
<span class="n">A12</span><span class="o">=</span> <span class="n">space</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>     <span class="n">A12</span><span class="o">=</span> <span class="n">Unsigned</span><span class="p">(</span><span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">1</span><span class="o">]</span><span class="p">),</span><span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">2</span><span class="o">]</span><span class="p">),</span><span class="s">&quot;^&quot;</span><span class="p">)</span>
<span class="o">?</span> <span class="s">&quot;unsigned A12: &quot;</span> <span class="o">+</span><span class="n">A12</span>
<span class="n">A34</span><span class="o">=</span> <span class="n">space</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>     <span class="n">A34</span><span class="o">=</span> <span class="n">Unsigned</span><span class="p">(</span><span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">3</span><span class="o">]</span><span class="p">),</span><span class="n">bytes2int</span><span class="p">(</span><span class="n">B</span><span class="o">[</span><span class="mi">4</span><span class="o">]</span><span class="p">),</span><span class="s">&quot;^&quot;</span><span class="p">)</span>
<span class="o">?</span> <span class="s">&quot;unsigned A34: &quot;</span> <span class="o">+</span><span class="n">A34</span>
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>B1: ABCD
B2: EFGH
B3: IJKL
B4: MNOP
A12: 201589764
A34: 470025220
unsigned A12: 201589764
unsigned A34: 470025220
</pre></div>
</div>
</div>
<div class="section" id="why-is-ring-weakly-typed">
<span id="index-5"></span><h2>Why is Ring weakly typed?<a class="headerlink" href="#why-is-ring-weakly-typed" title="Permalink to this headline">¶</a></h2>
<p>Because it’s faster and more natural, and this is important for the language’s goals. One
of the rules is: the data type at the beginning affects the final result.
For example, when you type “Print : ” + 5 , The String comes first, so 5
will be converted to a String. While when you type 5 + “10” The number comes first so “10”
will be converted to 10. This helps a lot to quickly convert between numbers and strings using
the same operator. If you want to prevent conversion (Write code that prevent conversion) In
these cases you will notice that what you are writing is less code (And can be removed).</p>
<p>Weakly typed = automatic conversion and <em>automatic</em> is <em>good thing</em> and is better than <em>manual</em>
if you know how to use it correctly.</p>
</div>
<div class="section" id="what-are-the-advantages-to-using-ring-over-lisp-or-smalltalk">
<span id="index-6"></span><h2>What are the advantages to using Ring over Lisp or Smalltalk?<a class="headerlink" href="#what-are-the-advantages-to-using-ring-over-lisp-or-smalltalk" title="Permalink to this headline">¶</a></h2>
<p>Smalltalk and Lisp are GREAT languages. I like many of the concepts behind them but I’m sure
that selecting the right programming language is based on the problem and comes after the problem’s
definition. I have a problem that I want to solve and these GREAT languages are not ideal for
this problem so I designed Ring.</p>
<p>When you design a new language, You can learn from the past but you must look forward and live
in the future. What you know about natural programming maybe based on the <em>old knowledge</em> about
the power of these paradigms in the practical world and I agree with you but I see other
techniques that can be applied to get this to work in practice. What you miss about
<em>natural language</em> is that they are <em>context sensitive</em> and this means we can use it and think
differently about how we can express our ideas.</p>
<p>Example : I want window contains 3 buttons.</p>
<p>In one sentence I created 4 objects (The window and the three buttons) and added the buttons
to the window. The idea of natural programming is to get many things done like that.</p>
</div>
<div class="section" id="why-is-ring-largely-focussed-on-ui-creation">
<span id="index-7"></span><h2>Why is Ring largely focussed on UI creation?<a class="headerlink" href="#why-is-ring-largely-focussed-on-ui-creation" title="Permalink to this headline">¶</a></h2>
<p>Yes UI creation is one of the important things in the language features because it is designed
to create a visual programming tool, But the language is a multi-paradigm language where we can
select the programming paradigm based on the problem.</p>
</div>
<div class="section" id="is-ring-some-sort-of-an-improvement-of-php">
<span id="index-8"></span><h2>Is Ring some sort of an improvement of PHP?<a class="headerlink" href="#is-ring-some-sort-of-an-improvement-of-php" title="Permalink to this headline">¶</a></h2>
<p>Ring is not designed to replace PHP, Lua or Smalltalk. Ring’s support for declarative
programming and natural language programming is very innovative and much better than staying
with procedural, object-oriented and functional languages. Ring see the future in programming
without code (using natural languages) and is designed to support that.</p>
</div>
<div class="section" id="what-are-the-advantages-of-using-ring-over-native-c-or-c">
<span id="index-9"></span><h2>What are the advantages of using Ring over native C or C++?<a class="headerlink" href="#what-are-the-advantages-of-using-ring-over-native-c-or-c" title="Permalink to this headline">¶</a></h2>
<p>Ring provides a better way to mix between different programming paradigms in solving problems.</p>
<p>The different programming paradigms play well together in the same language.</p>
<ol class="arabic simple">
<li><p>It’s easy to switch from one programming paradigm to another one because the language constructs use similar syntax for similar concepts.</p></li>
<li><p>The paradigms are provided to interact and used together in different layers in the software.</p></li>
</ol>
<p>for example you can create a game engine using object-oriented programming but write the game code using declarative programming or natural programming and behind the scenes your declarative or natural code will use the object-oriented classes.</p>
<ol class="arabic simple" start="3">
<li><p>Ring is more productive and natural than C/C++.</p></li>
<li><p>Ring is a dynamic language. We can generate and execute code during the runtime. Ring is dynamically typed and weakly typed for flexibility.</p></li>
<li><p>The Garbage collector is generational (escape analysis) and also uses reference counting. it’s very fast and still provides control to the programmer who can delete memory at any time.</p></li>
<li><p>Ring’s compiler and virtual machine are just 20,000 lines of ANSI C code that can be compiled and used in any platform.</p></li>
<li><p>You can use C/C++ libraries and Ring comes with code generator to create wrappers from C functions or C++ classes. so when you need more performance or when you need to use more libraries you can easily do that.</p></li>
</ol>
</div>
<div class="section" id="what-is-the-difference-between-ring-and-python-and-is-ring-open-source">
<span id="index-10"></span><h2>What is the difference between Ring and Python? And is Ring Open Source?<a class="headerlink" href="#what-is-the-difference-between-ring-and-python-and-is-ring-open-source" title="Permalink to this headline">¶</a></h2>
<p>Yes the language is Open Source (MIT license)</p>
<p>In general I like Python and Ruby but I was looking for a language more suitable for creating the next version of
the Programming Without Coding Technology (PWCT) software so I started the Ring design.</p>
<p>Some simple changes that matters for my goal are</p>
<ol class="arabic simple">
<li><p>Not case sensitive</p></li>
<li><p>The list index start from 1</p></li>
<li><p>You can call functions before definition</p></li>
<li><p>Don’t use Python syntax like (indentation, using self, :, pass &amp; _)</p></li>
<li><p>Weakly typed (convert automatically between types based on context)</p></li>
<li><p>The programs follow simple and constant structure (Statements then functions then packages and classes)</p></li>
<li><p>Using the ‘=’ operator for assignment and for testing values</p></li>
</ol>
<p>Critical changes are</p>
<ol class="arabic simple">
<li><p>Small Language : The Ring compiler + Virtual Machine = 15K lines of C code , the other 500K lines are related to libraries and are optional when we go for using the language in C/C++ programs.</p></li>
<li><p>The Garbage collector : Uses Escape Analysis/Reference counting and give the programmer the ability to determine when to delete memory using the assignment operator</p></li>
<li><p>Compact Syntax : Ring is not line sensitive, you don’t need to write ; or press ENTER to separate between statements</p></li>
<li><p>Using { } to access the object then using the object attributes and methods directly</p></li>
<li><p>Natural Programming : It’s very easy to create natural interfaces using Ring based on OOP</p></li>
<li><p>Declarative Programming using Nested Structure</p></li>
</ol>
<p>The Ring programming language is designed based on my experience from using many other
languages like C, C++, C#, Lua, PHP, Python, Ruby, Harbour, Basic and Supernova
And the language comes with innovative features added to achieve the language goal</p>
<ul class="simple">
<li><p>Applications programming language.</p></li>
<li><p>Productivity and developing high quality solutions that can scale.</p></li>
<li><p>Small and fast language that can be embedded in C/C++ projects.</p></li>
<li><p>Simple language that can be used in education and introducing Compiler/VM concepts.</p></li>
<li><p>General-Purpose language that can be used for creating domain-specific libraries, frameworks and tools.</p></li>
<li><p>Practical language designed for creating the next version of the Programming Without Coding Technology software.</p></li>
</ul>
</div>
<div class="section" id="what-are-the-advantages-to-using-ring-over-perl-php-python-or-ruby">
<span id="index-11"></span><h2>What are the advantages to using Ring over Perl, PHP, Python or Ruby?<a class="headerlink" href="#what-are-the-advantages-to-using-ring-over-perl-php-python-or-ruby" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p>Ring is New and Innovative. The language will let you think different about programming.</p></li>
<li><p>Ring is Smaller. (Lessons learned from the Lua language)</p></li>
<li><p>Ring is Simple. (Lessons learned from the BASIC and Clipper/Harbour languages)</p></li>
<li><p>Ring is more Natural. (Lessons learned from the Supernova language)</p></li>
<li><p>Ring is more Declarative. (Lessons learned from REBOL and QML languages)</p></li>
<li><p>Ring Implementation is Transparent, Visual and comes with Rich Features.</p></li>
</ol>
</div>
<div class="section" id="what-are-the-advantages-to-using-ring-over-tcl-or-lua">
<span id="index-12"></span><h2>What are the advantages to using Ring over Tcl or Lua?<a class="headerlink" href="#what-are-the-advantages-to-using-ring-over-tcl-or-lua" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p>Clean Code (More Natural)</p></li>
<li><p>More Features (A lot of useful programming paradigms)</p></li>
</ol>
</div>
<div class="section" id="what-are-the-advantages-to-using-ring-over-c-or-java">
<span id="index-13"></span><h2>What are the advantages to using Ring over C# or Java?<a class="headerlink" href="#what-are-the-advantages-to-using-ring-over-c-or-java" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p>Compact Code (Clean and Natural), More Productivity and Flexibility.</p></li>
<li><p>Better support for Declarative Programming and Natural Programming</p></li>
</ol>
</div>
<div class="section" id="the-documentation-says-functional-programming-is-supported-but-then-this-happens">
<span id="index-14"></span><h2>The documentation says functional programming is supported, but then this happens?<a class="headerlink" href="#the-documentation-says-functional-programming-is-supported-but-then-this-happens" title="Permalink to this headline">¶</a></h2>
<p>The question was about this code</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">f</span> <span class="o">=</span> <span class="k">func</span> <span class="p">{</span>
    <span class="n">a</span> <span class="o">=</span> <span class="mi">42</span>
    <span class="k">return</span> <span class="k">func</span> <span class="p">{</span> <span class="k">return</span> <span class="n">a</span> <span class="p">}</span>
<span class="p">}</span>

<span class="n">innerF</span> <span class="o">=</span> <span class="k">call</span> <span class="n">f</span><span class="p">()</span>
<span class="k">call</span> <span class="n">innerF</span><span class="p">()</span>
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Using uninitialized variable : a In function _ring_anonymous_func_16601()
</pre></div>
</div>
<p>The Answer:</p>
<ul class="simple">
<li><p>It’s Anonymous Functions, i.e. Not Closures.</p></li>
<li><p>Many developers asked about supporting Closures and during language development we may add new features that doesn’t go against the language goals or spirit.</p></li>
<li><p>You can use classes and objects when you want to merge between the state and functions to provide a clear solution.</p></li>
<li><p>You can use Lists and put the anonymous function inside the List then return the list that contains the state and the function. Pass the list to the function when you use it.</p></li>
<li><p>You can use eval() and substr() to add the variable value directly to the anonymous function before return.</p></li>
<li><p>We protect you from other scopes when you define the function. In Ring we provided the Three Scopes Rule where at each point you have only at maximum three scopes (Global, Object Scope and Local Scope).</p></li>
<li><p>We don’t get everything from everywhere to be like others! We don’t need to do that. If we will think like that then we will create a very complex language or we will save our time and use other languages.</p></li>
<li><p>When you think about learning or studying a new language concentrate about (What is new?) and (What is better in this language?) to know when to use it. Don’t compare a new language just released little months ago with languages started many years ago and expect to find everything that you used to have.</p></li>
<li><p>Each programming language miss features in other languages. The idea is not the Features. it’s the spirit and ability behind all of the features together.</p></li>
</ul>
</div>
<div class="section" id="why-the-ability-to-define-your-own-languages-instead-of-just-handing-over-the-syntax-so-you-can-parse-it-using-whatever-code-you-like">
<span id="index-15"></span><h2>Why the ability to define your own languages Instead of just handing over the syntax so you can parse it using whatever code you like?<a class="headerlink" href="#why-the-ability-to-define-your-own-languages-instead-of-just-handing-over-the-syntax-so-you-can-parse-it-using-whatever-code-you-like" title="Permalink to this headline">¶</a></h2>
<p>It’s innovation - You create natural statements without the need to learn about parsing.
You just use Classes which is intelligent decision (where later we can mix between classes to
support more statements based on the context - We can change and translate the defined
statements and many more!). Also the statements are added in Ring World where you can use
any Ring statement.</p>
</div>
<div class="section" id="why-you-can-specify-the-number-of-loops-you-want-to-break-out-of">
<span id="index-16"></span><h2>Why you can specify the number of loops you want to break out of?<a class="headerlink" href="#why-you-can-specify-the-number-of-loops-you-want-to-break-out-of" title="Permalink to this headline">¶</a></h2>
<p>The language supports programming in the small and programming in the large. The selection
of what features to use is based on what are you going to do. Any programmer can write
poorly code in any language if he/she wants to do that. The idea is what must be done in
the language design to prevent errors without causing other problems like killing flexibility.</p>
<p>Read some source code in the Linux Kernel and Ruby Implementation for example, You will find good
usage for GOTO as a practical example that General Rules are not for All Use Cases and great
programmers know when to break the rules. I’m not saying go and use GOTO or saying Ring add
things like that. But the ability to break more than one loop and/or the ability to break the
loop from sub functions is practical for small programs.</p>
<p>Anyway these are some of the small new things added by the language (Not the big idea).</p>
</div>
<div class="section" id="why-ring-uses-see-give-but-and-ok-keywords">
<span id="index-17"></span><h2>Why Ring uses ‘See’, ‘Give’, ‘But’ and ‘Ok’ Keywords?<a class="headerlink" href="#why-ring-uses-see-give-but-and-ok-keywords" title="Permalink to this headline">¶</a></h2>
<p>See and Give are selected not to be “opposite actions” but to reflect what I want to do as a programmer.</p>
<p>When I want to see something on the screen I use ‘See’.</p>
<p>When I want to give some input to the program I use ‘Give’.</p>
<p>My selection of “but” and “ok” is based on selecting keywords that can be written quickly.</p>
<p>Also using “but” is easy to remember than elseif/elif/elsif where each language select a different keyword.</p>
<p>In Ring 1.1 and later versions All of this is just an option.</p>
<p>You can use ‘Put’ and ‘Get’ instead of ‘See’ and ‘Give’</p>
<p>You can use ‘elseif’ and ‘end’ insetad of ‘But’ and ‘Ok’</p>
<p>It’s your choice. In Ring we have syntax flexibility where we provide more than one style.</p>
<p>Also you can change the language keywords and operators.</p>
<p>Also you can define new natural languages too.</p>
</div>
<div class="section" id="what-is-the-philosophy-behind-data-types-in-ring">
<span id="index-18"></span><h2>What is the philosophy behind data types in Ring?<a class="headerlink" href="#what-is-the-philosophy-behind-data-types-in-ring" title="Permalink to this headline">¶</a></h2>
<p>The Ring programming language is designed to be SMALL.
The language provides the basic constructs that you need to do anything!
One of the goals is to keep the basic constructs simple and small as possible.</p>
<p>Using Lists in Ring you can</p>
<ul class="simple">
<li><p>Create Arrays (one data type)</p></li>
<li><p>Create Lists (Mix of data types)</p></li>
<li><p>Create Tree (Nested arrays)</p></li>
<li><p>Use String Index (Looks like Dictionary/Hash Table)</p></li>
</ul>
<p>The same principle is applied to Numbers</p>
<ul class="simple">
<li><p>You can use the number for int value</p></li>
<li><p>You can use the number for double value</p></li>
<li><p>You can use the number for Boolean value (True/False)</p></li>
</ul>
<p>The sample principle is applied for Strings</p>
<ul class="simple">
<li><p>You can use the string for storing one character</p></li>
<li><p>You can use the string for storing text (one or many lines)</p></li>
<li><p>You can use the string for storing binary data</p></li>
<li><p>You can use the string for storing date</p></li>
<li><p>You can use the string for storing time</p></li>
<li><p>You can use the string for storing NULL values (empty strings)</p></li>
</ul>
<p>And we have Object Oriented Support + Operator Overloading where the programmer
can define new data types and use them as default types defined by the language</p>
<p>So We have</p>
<ul class="simple">
<li><p>A small and simple language that someone can pick in little days</p></li>
<li><p>A fast language that provide primitive types (String - Number - List - Object)</p></li>
<li><p>A flexible language that can be extended using OOP to add new types according to the application domain</p></li>
</ul>
</div>
<div class="section" id="what-about-the-boolean-values-in-ring">
<span id="index-19"></span><h2>What about the Boolean values in Ring?<a class="headerlink" href="#what-about-the-boolean-values-in-ring" title="Permalink to this headline">¶</a></h2>
<p>You can use true for 1 and false for 0</p>
<p>when you test the result of Boolean expressions in your code.</p>
<p>Just when you print the value using the see command you will see 1 for (true) and 0 for (false)</p>
<p>Why ?</p>
<p>Because Ring contains only 4 types of variables</p>
<ol class="arabic simple">
<li><p>Number</p></li>
<li><p>String</p></li>
<li><p>List</p></li>
<li><p>Object</p></li>
</ol>
<p>The first type (Number) is used to represent int, double and Boolean values.</p>
<p>The second type (String) is used to represent char, array of characters, date and time.</p>
<p>The third type (List) is used to represent Arrays of one type, Arrays of more than one type, Hash (Dictionary), Tree, etc.</p>
<p>The object can be an object created from a Ring class (Any Class) or just a C Pointer that we get from calling a C/C++ function/method.</p>
<p>Why ?</p>
<p>The Ring is designed to give the programmer/developer the most simple constructs that can be used to do everything.
The programmer/developer can customize the language by creating new classes (and use operator overloading) to get more types that he care about according to the problem domain.</p>
<p>Why ?</p>
<p>Because simple is better, and easy to learn and remember!
And this provide flexibility to convert between high level types that can be represented using the same basic type</p>
</div>
<div class="section" id="what-is-the-goal-of-including-the-main-function-in-ring">
<span id="index-20"></span><h2>What is the goal of including the “Main” function in Ring?<a class="headerlink" href="#what-is-the-goal-of-including-the-main-function-in-ring" title="Permalink to this headline">¶</a></h2>
<p>The main function is very important, you need it when you want to write statements that uses
local variables instead of the Global scope.</p>
<p>Example:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">x</span> <span class="o">=</span> <span class="mi">10</span>
<span class="n">myfunc</span><span class="p">()</span>
<span class="k">See</span> <span class="s">&quot;X value = &quot;</span> <span class="o">+</span> <span class="n">X</span>  <span class="c"># here I expect that x will be (10)</span>
                      <span class="c"># but I will get another value (6) because myfunc() uses x !</span>
<span class="k">Func</span> <span class="n">myfunc</span>
   <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">5</span>
       <span class="k">See</span> <span class="n">x</span> <span class="o">+</span> <span class="n">nl</span>
   <span class="k">next</span>
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="mi">1</span>
<span class="mi">2</span>
<span class="mi">3</span>
<span class="mi">4</span>
<span class="mi">5</span>
<span class="n">X</span> <span class="n">value</span> <span class="o">=</span> <span class="mi">6</span>
</pre></div>
</div>
<p>Now using the Main function</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Func</span> <span class="n">Main</span>
   <span class="n">x</span> <span class="o">=</span> <span class="mi">10</span>
   <span class="n">myfunc</span><span class="p">()</span>
   <span class="k">See</span> <span class="s">&quot;X value = &quot;</span> <span class="o">+</span> <span class="n">X</span>

<span class="k">Func</span> <span class="n">myfunc</span>
   <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">5</span>
       <span class="k">See</span> <span class="n">x</span> <span class="o">+</span> <span class="n">nl</span>
   <span class="k">next</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="mi">1</span>
<span class="mi">2</span>
<span class="mi">3</span>
<span class="mi">4</span>
<span class="mi">5</span>
<span class="n">X</span> <span class="n">value</span> <span class="o">=</span> <span class="mi">10</span>
</pre></div>
</div>
</div>
<div class="section" id="why-the-list-index-start-from-1-in-ring">
<span id="index-21"></span><h2>Why the list index start from 1 in Ring?<a class="headerlink" href="#why-the-list-index-start-from-1-in-ring" title="Permalink to this headline">¶</a></h2>
<p>It's about how we count in the real world, when we have three apples in our hand</p>
<p>we say 1 2 3</p>
<p>We don't start from 0</p>
<p>The question must be why the other languages start from 0 ?</p>
<p>The answer is, because this is related to the machine and how we deal with values and memory address.</p>
<p>Example</p>
<p>we have array called myarray[5]</p>
<p>In memory : myarray will have an address</p>
<p>The first item will be stored in that address</p>
<p>The second item will come after that address and so on</p>
<p>Now when we need to point to the first item we need the address of myarray</p>
<p>So we type myarray[0] because myarray + 0 result will still point to the first item</p>
<p>for the second item myarray[1] because myarray + 1 result will point to the second item and so on</p>
<p>In Low Level languages or languages near to the machine it's good to be like this</p>
<p>But for high level language designed for applications it's better to be natural</p>
<p>Example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">mylist</span> <span class="o">=</span> <span class="o">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="o">]</span>
<span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="n">len</span><span class="p">(</span><span class="n">mylist</span><span class="p">)</span>
        <span class="k">see</span> <span class="n">x</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">next</span>
</pre></div>
</div>
<p>In the previous example we start from 1 to the length of the array
if the index starts from 0 we will write</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">0</span> <span class="k">to</span> <span class="n">len</span><span class="p">(</span><span class="n">mylist</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span>
</pre></div>
</div>
<p>or remember the for loop in other languages</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">for</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="mi">0</span> <span class="p">;</span> <span class="n">x</span><span class="o">&lt;</span><span class="n">nMax</span> <span class="p">;</span> <span class="n">x</span><span class="o">++</span> <span class="p">)</span>
</pre></div>
</div>
<p>You will use the &lt; operator !</p>
</div>
<div class="section" id="why-ring-is-not-case-sensitive">
<span id="index-22"></span><h2>Why Ring is not case-sensitive?<a class="headerlink" href="#why-ring-is-not-case-sensitive" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p>To be more human-friendly</p></li>
<li><p>Like Ada, SQL, Pascal, Delphi, Visual Basic, Visual FoxPro, etc.</p></li>
<li><p>To help in supporting Natural Language Programming.</p></li>
<li><p>To be able to select your favorite style when writing the language keywords</p></li>
</ol>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">see</span> <span class="s">&quot;lower case!&quot;</span>
</pre></div>
</div>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">SEE</span> <span class="s">&quot;UPPER case!&quot;</span>
</pre></div>
</div>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="s">&quot;First Letter is UPPER case!&quot;</span>
</pre></div>
</div>
<ol class="arabic simple" start="5">
<li><p>To avoid getting error message when writing quick tests then type “variable” instead of “Variable”.</p></li>
<li><p>To avoid getting error message when you type “Dosomething()” instead of “doSomething()”</p></li>
<li><p>In Ring, No conflict between Variables, Method Names &amp; Classes Names</p></li>
</ol>
<p>We can write person as variable name and Person as class name.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">person</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Person</span>
<span class="k">class</span> <span class="n">Person</span>
        <span class="n">name</span> <span class="n">address</span> <span class="n">phone</span>
</pre></div>
</div>
</div>
<div class="section" id="why-the-assignment-operator-uses-deep-copy">
<span id="index-23"></span><h2>Why the Assignment operator uses Deep Copy?<a class="headerlink" href="#why-the-assignment-operator-uses-deep-copy" title="Permalink to this headline">¶</a></h2>
<p>“Because it’s a poor tradeoff to add complexity for dubious performance gains, a good
approach to deep vs. shallow copies is to prefer deep copies until proven otherwise.”</p>
<blockquote>
<div><p>, Steve McConnell, Code Complete</p>
</div></blockquote>
<ol class="arabic simple">
<li><p>It’s more natural, When you use the assignment operator, You expect a deep copy.</p></li>
<li><p>If you don’t need a deep copy, Just don’t use it!</p></li>
<li><p>The Ring language is designed to reduce references usage as much as possible.</p></li>
<li><p>The Ring language is designed to make using references simple and possible in special cases where this make sense.</p></li>
<li><dl class="simple">
<dt>We have references when this is natural, like passing lists and objects to functions,</dt><dd><p>creating objects (Like GUI Objects) from a C/C++ library, returning an object stored
inside a list.</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>It is a feature, We can use it to create pure functions. The Value() function in the</dt><dd><p>stdlib uses this feature to pass lists &amp; objects by value when we need this.</p>
</dd>
</dl>
</li>
<li><p>When we need references, It’s recommended to create a class that manage sharing lists and objects.</p></li>
<li><p>It’s more safe at the application level to avoid many logical errors.</p></li>
<li><dl class="simple">
<dt>In Ring, we start without thinking about the little details and concentrate on the application, You</dt><dd><p>don’t have to write the type (Dynamic Typing), You don’t have to write explicit
conversions between numbers and strings (Weakly Typed) and you don’t have to select
between using values or references, You don’t have to write the scope (Lexical Scoping).</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>In Ring, we have smart garbage collector (Simple &amp; Fast), We can delete the memory directly</dt><dd><p>at any time using the Assignment operator too. Reducing references usage or using them through
managers helps a lot to achieve this goal. by doing this we have full control.</p>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>If you want to create references and avoid creating a manager,</dt><dd><p>You can use Object2Pointer() and Pointer2Object() functions
But It’s not the Ring way “Spirit” to do things.</p>
</dd>
</dl>
</li>
</ol>
</div>
<div class="section" id="is-there-constructor-methods-in-ring">
<span id="index-24"></span><h2>Is there constructor methods in Ring?<a class="headerlink" href="#is-there-constructor-methods-in-ring" title="Permalink to this headline">¶</a></h2>
<p>When you create new object for example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">new</span> <span class="n">point</span>
</pre></div>
</div>
<p>1 - Ring will allocate dynamic memory space to be used for the new object attributes that Ring doesn’t know anything about them.</p>
<p>2 - Ring will change the current local scope and the current object scope to use the object state created in step (1)</p>
<p>3 - Ring will move the execution to the class Region (After the class name and before any methods)</p>
<p>4 - Any Instructions/Code in the class region will be executed as any Ring code</p>
<p>5 - Control is moved from the class region to the location of (new point) once we reach the end of the class region or we uses a Return command.</p>
<p>So All attributes that added to the object are dynamic attributes, this mean that you can control what attributes will be added through the runtime.</p>
<p>Example:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span>$3D = False
see  new point
$3D = True
see new point

class point
        x y
        if not $3D return ok
        z
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>x: NULL
y: NULL
x: NULL
y: NULL
z: NULL
</pre></div>
</div>
<p>You have an option to call init() method directly when you create a new object</p>
<p>This method can do anything with the object attributes as it will be called after creating the object and executing the class region code.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">p1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">point3d</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="mi">200</span><span class="p">,</span><span class="mi">300</span><span class="p">)</span>
<span class="k">see</span> <span class="n">p1</span>

<span class="k">class</span> <span class="n">point3d</span>
        <span class="n">x</span> <span class="n">y</span> <span class="n">z</span>
        <span class="k">func</span> <span class="n">init</span> <span class="n">p1</span><span class="p">,</span><span class="n">p2</span><span class="p">,</span><span class="n">p3</span>
                <span class="n">x</span><span class="o">=</span><span class="n">p1</span> <span class="n">y</span><span class="o">=</span><span class="n">p2</span> <span class="n">z</span><span class="o">=</span><span class="n">p3</span>
</pre></div>
</div>
</div>
<div class="section" id="what-happens-when-we-create-a-new-object">
<span id="index-25"></span><h2>What happens when we create a new object?<a class="headerlink" href="#what-happens-when-we-create-a-new-object" title="Permalink to this headline">¶</a></h2>
<p>1- When you create an object, the class region code will be executed and you will have the object attributes based on the code in that region</p>
<p>2- Ring don’t care about the object methods until you start calling a method</p>
<p>3- When you call a method, Ring will check the object class and the class parent (if you are using inheritance) and will collect the methods for you to be used now or later from any object that belong to the same class.</p>
<p>4- Since methods are dynamic and each object get the method from the class, you can after creating objects, add new methods and use it with the object or any object created or will be created from the same class.</p>
<p>Example:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">o1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">point</span> <span class="p">{</span><span class="n">x</span><span class="o">=</span><span class="mi">10</span> <span class="n">y</span><span class="o">=</span><span class="mi">20</span> <span class="n">z</span><span class="o">=</span><span class="mi">30</span><span class="p">}</span>
<span class="n">o2</span> <span class="o">=</span> <span class="k">new</span> <span class="n">point</span> <span class="p">{</span><span class="n">x</span><span class="o">=</span><span class="mi">100</span> <span class="n">y</span><span class="o">=</span><span class="mi">200</span> <span class="n">z</span> <span class="o">=</span><span class="mi">300</span><span class="p">}</span>

<span class="n">addmethod</span><span class="p">(</span><span class="n">o1</span><span class="p">,</span><span class="s">&quot;print&quot;</span><span class="p">,</span> <span class="k">func</span> <span class="p">{</span> <span class="k">see</span> <span class="n">x</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span> <span class="n">y</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span> <span class="n">z</span> <span class="o">+</span> <span class="n">nl</span> <span class="p">}</span> <span class="p">)</span>

<span class="n">o1</span><span class="p">.</span><span class="n">print</span><span class="p">()</span>
<span class="n">o2</span><span class="p">.</span><span class="n">print</span><span class="p">()</span>

<span class="k">class</span> <span class="n">point</span> <span class="n">x</span> <span class="n">y</span> <span class="n">z</span>
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>10
20
30
100
200
300
</pre></div>
</div>
</div>
<div class="section" id="can-we-use-the-attributes-by-accessing-the-getter-and-setter-methods">
<span id="index-26"></span><h2>Can we use the attributes by accessing the Getter and Setter methods?<a class="headerlink" href="#can-we-use-the-attributes-by-accessing-the-getter-and-setter-methods" title="Permalink to this headline">¶</a></h2>
<p>Yes we can, The setter/getter methods are called automatically when you start using the attributes from outside the class
Also you can call the methods instead of using the attributes. It’s your choice.</p>
<p>Example:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">o1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Developer</span>
<span class="n">o1</span><span class="p">.</span><span class="n">name</span> <span class="o">=</span> <span class="s">&quot;Mahmoud&quot;</span>  <span class="k">see</span> <span class="n">o1</span><span class="p">.</span><span class="n">name</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">o1</span> <span class="p">{</span> <span class="n">name</span> <span class="o">=</span> <span class="s">&quot;Gal&quot;</span>  <span class="k">see</span> <span class="n">name</span> <span class="p">}</span>
<span class="n">o1</span> <span class="p">{</span> <span class="n">name</span> <span class="o">=</span> <span class="s">&quot;Bert&quot;</span>  <span class="k">see</span> <span class="n">name</span> <span class="p">}</span>

<span class="n">o1</span><span class="p">.</span><span class="n">setname</span><span class="p">(</span><span class="s">&quot;Marino&quot;</span><span class="p">)</span>
<span class="k">see</span> <span class="n">o1</span><span class="p">.</span><span class="n">getname</span><span class="p">()</span>

<span class="k">Class</span> <span class="n">Developer</span>

                <span class="n">name</span> <span class="n">language</span> <span class="o">=</span> <span class="s">&quot;Ring Programming Language&quot;</span>

                <span class="k">func</span> <span class="n">setname</span> <span class="n">value</span>
                                <span class="k">see</span> <span class="s">&quot;Message from SetName() Function!&quot;</span> <span class="o">+</span> <span class="n">nl</span>
                                <span class="n">name</span> <span class="o">=</span> <span class="n">value</span> <span class="o">+</span> <span class="s">&quot; - &quot;</span> <span class="o">+</span> <span class="n">language</span>

                <span class="k">func</span> <span class="n">getname</span>
                                <span class="k">see</span> <span class="s">&quot;Message from GetName() Function!&quot;</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span> <span class="n">nl</span>
                                <span class="k">return</span> <span class="s">&quot;Mr. &quot;</span> <span class="o">+</span> <span class="n">name</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Message from SetName() Function!
Message from GetName() Function!

Mr. Mahmoud - Ring Programming Language

Message from SetName() Function!
Message from GetName() Function!

Mr. Gal - Ring Programming Language
Message from SetName() Function!
Message from GetName() Function!

Mr. Bert - Ring Programming Language
Message from SetName() Function!
Message from GetName() Function!

Mr. Marino - Ring Programming Language
</pre></div>
</div>
</div>
<div class="section" id="why-should-a-search-of-global-names-be-made-while-defining-the-class-attributes">
<span id="index-27"></span><h2>Why should a search of global names be made while defining the class attributes?<a class="headerlink" href="#why-should-a-search-of-global-names-be-made-while-defining-the-class-attributes" title="Permalink to this headline">¶</a></h2>
<p>The question is why we don’t avoid conflicts with global variable names when we
define the class attributes ?</p>
<p>At first remember that using the optional $ mark in the global variables names solve
the problem. Also using the Main function and avoiding global variables may help.</p>
<p>The Answer:</p>
<p>Ring is a dynamic language</p>
<p>We can in the run-time determine the class attributes (Add/Remove)</p>
<p>We can execute (any code) while defining the class attributes</p>
<p>Example (1)</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">oPerson</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Person</span>
<span class="k">Class</span> <span class="n">Person</span>
   <span class="k">See</span> <span class="s">&quot;Welcome to the Ring language&quot;</span>
</pre></div>
</div>
<p>Example (2)</p>
<p>Customize attributes based on global variable value</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="o">$</span><span class="n">debug</span> <span class="o">=</span> <span class="kp">true</span>
<span class="n">oPerson</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Person</span>
<span class="k">see</span> <span class="n">oPerson</span>
<span class="k">Class</span> <span class="n">Person</span>
    <span class="k">if</span> <span class="o">$</span><span class="n">debug</span>  <span class="n">date</span><span class="o">=</span><span class="n">date</span><span class="p">()</span>  <span class="n">time</span><span class="o">=</span><span class="n">time</span><span class="p">()</span> <span class="k">ok</span>
</pre></div>
</div>
<p>In the previous example when we have the $debug flag set to true, we will add the Date and Time
attributes to the object state.</p>
<p>Example (3)</p>
<p>Store the object index based on global variable</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="o">$</span><span class="n">ObjectsCount</span> <span class="o">=</span> <span class="mi">0</span>
<span class="n">oPerson</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Person</span>
<span class="k">see</span> <span class="n">oPerson</span>
<span class="n">oPerson2</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Person</span>
<span class="k">see</span> <span class="n">oPerson2</span>
<span class="k">Class</span> <span class="n">Person</span>
      <span class="o">$</span><span class="n">ObjectsCount</span><span class="o">++</span>
      <span class="n">nIndex</span> <span class="o">=</span> <span class="o">$</span><span class="n">ObjectsCount</span>
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">nindex</span><span class="p">:</span> <span class="mf">1.000000</span>
<span class="n">nindex</span><span class="p">:</span> <span class="mf">2.000000</span>
</pre></div>
</div>
<p>Common Example:</p>
<ul class="simple">
<li><p>Connect to the database then get table columns (Using global Variable/Object).</p></li>
<li><p>Create class attributes based on the column names.</p></li>
<li><p>Later when you modify the database - you may don’t need to modify your code.</p></li>
</ul>
<p>It’s flexibility but remember that power comes with great responsibility.</p>
</div>
<div class="section" id="why-ring-doesn-t-avoid-the-conflict-between-global-variables-and-class-attributes-names">
<span id="index-28"></span><h2>Why Ring doesn’t avoid the conflict between Global Variables and Class Attributes Names?<a class="headerlink" href="#why-ring-doesn-t-avoid-the-conflict-between-global-variables-and-class-attributes-names" title="Permalink to this headline">¶</a></h2>
<p>In this use case we have</p>
<p>1 - Global Variable defined without a special mark like $</p>
<p>2 - Class contains Attributes defined using a special syntax (where we type the attribute name directly after the class)</p>
<p>3 - The Attributes are defined in the class region that allows writing code and using global variables</p>
<p>If I will accepted your proposal about changing how Ring find variables in the class region I must break one of the previous three features which will lead to more problems that are more important than this problem.</p>
<p>I don’t like changing the feature number (1) because I would like to keep Ring code more clean and let the programmer decide when to use $ or not.</p>
<p>I don’t like changing the feature number (2) because I like this feature and I don’t like forcing the programmer to type
self.attribute</p>
<p>I don’t like changing the feature number (3) because it’s very important in many applications to access global variables in the class region.</p>
<p>So what was my decision ?</p>
<p>I decided to leave this case for the programmer who will decide what to do to avoid this special case</p>
<p>1 - The programmer can avoid using global variables (Better) and can use the Main function (Optional)</p>
<p>2 - The programmer can use $ before the variable name or any mark like <a href="#id23"><span class="problematic" id="id24">global_</span></a> or <a href="#id25"><span class="problematic" id="id26">g_</span></a></p>
<p>3 - The programmer can use self.attribute after the class name to define the attributes</p>
<p>In general, for small programs you can use global variables and functions.
For large programs, use classes and objects and small number of global variables or avoid them at all.</p>
</div>
<div class="section" id="where-can-i-write-a-program-and-execute-it">
<span id="index-29"></span><h2>Where can I write a program and execute it?<a class="headerlink" href="#where-can-i-write-a-program-and-execute-it" title="Permalink to this headline">¶</a></h2>
<p>Run the Ring Notepad where you can write/execute programs.</p>
<p>If you want to run programs using the command line</p>
<p>Add Ring/bin folder to the path then</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>ring &lt;filename.ring&gt;|&lt;filename.ringo&gt;
</pre></div>
</div>
</div>
<div class="section" id="how-to-get-the-file-size-using-ftell-and-fseek-functions">
<span id="index-30"></span><h2>How to get the file size using ftell() and fseek() functions?<a class="headerlink" href="#how-to-get-the-file-size-using-ftell-and-fseek-functions" title="Permalink to this headline">¶</a></h2>
<p>The next function can be used to get the file size without reading the file!</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">func</span> <span class="n">getFileSize</span> <span class="n">fp</span>
       <span class="n">C_FILESTART</span> <span class="o">=</span> <span class="mi">0</span>
       <span class="n">C_FILEEND</span> <span class="o">=</span> <span class="mi">2</span>
       <span class="n">fseek</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="n">C_FILEEND</span><span class="p">)</span>
       <span class="n">nFileSize</span> <span class="o">=</span> <span class="n">ftell</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span>
       <span class="n">fseek</span><span class="p">(</span><span class="n">fp</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="n">C_FILESTART</span><span class="p">)</span>
       <span class="k">return</span> <span class="n">nFileSize</span>
</pre></div>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The previous function take the fp (file pointer) as parameter, We can get the fp from opening the file using fopen() function.</p>
</div>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">fp</span> <span class="o">=</span> <span class="n">fopen</span><span class="p">(</span><span class="s">&quot;filename&quot;</span><span class="p">,</span><span class="s">&quot;r&quot;</span><span class="p">)</span>

<span class="k">see</span>  <span class="s">&quot;File Size : &quot;</span> <span class="o">+</span> <span class="n">getFileSize</span><span class="p">(</span><span class="n">fp</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>Another solution (Read the file)</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">see</span> <span class="n">len</span><span class="p">(</span><span class="n">read</span><span class="p">(</span><span class="s">&quot;filename&quot;</span><span class="p">))</span>
</pre></div>
</div>
</div>
<div class="section" id="how-to-get-the-current-source-file-path">
<span id="index-31"></span><h2>How to get the current source file path?<a class="headerlink" href="#how-to-get-the-current-source-file-path" title="Permalink to this headline">¶</a></h2>
<p>We can use the next function to get the current source file path
then we can add the path variable to the file name</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">cPath</span> <span class="o">=</span> <span class="n">CurrentPath</span><span class="p">()</span>
<span class="k">func</span> <span class="n">currentpath</span>
        <span class="n">cFileName</span> <span class="o">=</span> <span class="n">filename</span><span class="p">()</span>
        <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="n">len</span><span class="p">(</span><span class="n">cFileName</span><span class="p">)</span> <span class="k">to</span> <span class="mi">1</span> <span class="k">step</span> <span class="o">-</span><span class="mi">1</span>
                <span class="k">if</span> <span class="n">cFileName</span><span class="o">[</span><span class="n">x</span><span class="o">]</span> <span class="o">=</span> <span class="s">&quot;/&quot;</span>
                        <span class="k">return</span> <span class="n">left</span><span class="p">(</span><span class="n">cFileName</span><span class="p">,</span><span class="n">x</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
                <span class="k">ok</span>
        <span class="k">next</span>
        <span class="k">return</span> <span class="n">cFileName</span>
</pre></div>
</div>
</div>
<div class="section" id="what-about-predefined-parameters-or-optional-parameters-in-functions">
<span id="index-32"></span><h2>What about predefined parameters or optional parameters in functions?<a class="headerlink" href="#what-about-predefined-parameters-or-optional-parameters-in-functions" title="Permalink to this headline">¶</a></h2>
<p>if you want to use predefined parameters or optional parameters
Just accept a list that works like hash/dictionary</p>
<p>Example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">sum</span><span class="p">(</span><span class="o">[</span> <span class="p">:</span><span class="n">a</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span> <span class="p">:</span><span class="n">b</span> <span class="o">=</span> <span class="mi">2</span><span class="o">]</span><span class="p">)</span>
<span class="n">sum</span><span class="p">(</span><span class="o">[</span> <span class="p">:</span><span class="n">a</span> <span class="o">=</span> <span class="mi">1</span> <span class="o">]</span><span class="p">)</span>
<span class="n">sum</span><span class="p">(</span><span class="o">[</span> <span class="p">:</span><span class="n">b</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">]</span><span class="p">)</span>
<span class="k">func</span> <span class="n">sum</span> <span class="n">pList</span>
        <span class="k">if</span> <span class="n">plist</span><span class="o">[</span><span class="p">:</span><span class="n">a</span><span class="o">]</span> <span class="o">=</span> <span class="kp">NULL</span> <span class="n">pList</span><span class="o">[</span><span class="p">:</span><span class="n">a</span><span class="o">]</span> <span class="o">=</span> <span class="mi">4</span> <span class="k">ok</span>
        <span class="k">if</span> <span class="n">plist</span><span class="o">[</span><span class="p">:</span><span class="n">b</span><span class="o">]</span> <span class="o">=</span> <span class="kp">NULL</span> <span class="n">pList</span><span class="o">[</span><span class="p">:</span><span class="n">b</span><span class="o">]</span> <span class="o">=</span> <span class="mi">5</span> <span class="k">ok</span>
        <span class="k">see</span> <span class="n">pList</span><span class="o">[</span><span class="p">:</span><span class="n">a</span><span class="o">]</span> <span class="o">+</span> <span class="n">pList</span><span class="o">[</span><span class="p">:</span><span class="n">b</span><span class="o">]</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>3
6
6
</pre></div>
</div>
</div>
<div class="section" id="how-to-print-keys-or-values-only-in-list-dictionary">
<span id="index-33"></span><h2>How to print keys or values only in List/Dictionary?<a class="headerlink" href="#how-to-print-keys-or-values-only-in-list-dictionary" title="Permalink to this headline">¶</a></h2>
<p>If you want to print keys only or values only just select the index of the item (one or two).</p>
<p>Example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">C_COUNTRY</span> <span class="o">=</span> <span class="mi">1</span>
<span class="n">C_CITY</span> <span class="o">=</span> <span class="mi">2</span>
<span class="n">mylist</span> <span class="o">=</span> <span class="o">[</span>
        <span class="p">:</span><span class="n">KSA</span> <span class="o">=</span> <span class="s">&quot;Riyadh&quot;</span> <span class="p">,</span>
        <span class="p">:</span><span class="n">Egypt</span> <span class="o">=</span> <span class="s">&quot;Cairo&quot;</span>
<span class="o">]</span>

<span class="k">for</span> <span class="n">x</span> <span class="k">in</span> <span class="n">mylist</span>
        <span class="k">see</span> <span class="n">x</span><span class="o">[</span><span class="n">C_COUNTRY</span><span class="o">]</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">next</span>

<span class="k">for</span> <span class="n">x</span> <span class="k">in</span> <span class="n">mylist</span>
        <span class="k">see</span> <span class="n">x</span><span class="o">[</span><span class="n">C_CITY</span><span class="o">]</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">next</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>ksa
egypt
Riyadh
Cairo
</pre></div>
</div>
</div>
<div class="section" id="why-i-get-a-strange-result-when-printing-nl-with-lists">
<span id="index-34"></span><h2>Why I get a strange result when printing nl with lists?<a class="headerlink" href="#why-i-get-a-strange-result-when-printing-nl-with-lists" title="Permalink to this headline">¶</a></h2>
<p>In the next code</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="kt">list</span> <span class="o">=</span> <span class="mi">1</span><span class="p">:</span><span class="mi">5</span>        <span class="c"># list = [1,2,3,4,5]</span>
<span class="k">see</span> <span class="kt">list</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>New Line will be added to the list then the list will be printed, the default print of the lists
will print a newline at the end, You added new newline and You have now 2 newlines to be printed.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="o">&lt;</span><span class="n">Expr</span><span class="o">&gt;</span>
</pre></div>
</div>
<p>The see command just print the final result of the expression, the expression will be evaluated as it</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">nl</span> <span class="o">=</span> <span class="n">char</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span> <span class="o">+</span> <span class="n">char</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span> <span class="c"># just a variable that you can change to anything !</span>
</pre></div>
</div>
<p>The + is an operator</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>string + string ---&gt; new string
string + number ---&gt; new string
number + number ---&gt; new number
number + string ---&gt; new number
</pre></div>
</div>
<p>list + item —&gt; nothing new will be created but the item will be added to the same list</p>
<p>Exception</p>
<p>number + nl -&gt; New String</p>
<p>This exception is added to easily print numbers then new line.</p>
<p>No need for this with printing lists because after printing the last item we already get a new line.</p>
</div>
<div class="section" id="could-you-explain-the-output-of-the-strcmp-function">
<span id="index-35"></span><h2>Could you explain the output of the StrCmp() function?<a class="headerlink" href="#could-you-explain-the-output-of-the-strcmp-function" title="Permalink to this headline">¶</a></h2>
<p>At first remember that you can check strings using ‘=’ operator directly.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">see</span> <span class="n">strcmp</span><span class="p">(</span><span class="s">&quot;hello&quot;</span><span class="p">,</span><span class="s">&quot;hello&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>
<span class="n">strcmp</span><span class="p">(</span><span class="s">&quot;abc&quot;</span><span class="p">,</span><span class="s">&quot;bcd&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>
<span class="n">strcmp</span><span class="p">(</span><span class="s">&quot;bcd&quot;</span><span class="p">,</span><span class="s">&quot;abc&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>if the two strings are the same then it returns 0</p>
<p>abc and bcd aren’t the same. in the second line it returns -1 and in the third line it returns 1</p>
<p>In the second line we compare between “abc” and “bcd”</p>
<p>Not equal because the first letter in “abc” = “a”
and the first letter in “bcd” = “b”</p>
<p>So we have “a” != “b” and “a” &lt; “b”</p>
<p>So we get output = -1</p>
<p>In the third line we have “bcd” and “abc”</p>
<p>the first letter in “bcd” is “b” and the first letter in “abc” is “a”</p>
<p>So we have “b” != “a” and “b” &gt; “a”</p>
<p>So we get output = 1</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>ASCII(“a”) = 97 and ASCII(“b”) = 98 So “a” &lt; “b” because 97 &lt; 98</p>
</div>
</div>
<div class="section" id="how-to-use-many-source-code-files-in-the-project">
<span id="index-36"></span><h2>How to use many source code files in the project?<a class="headerlink" href="#how-to-use-many-source-code-files-in-the-project" title="Permalink to this headline">¶</a></h2>
<p>Example:</p>
<p>I have the next folder</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>C:\LRing
</pre></div>
</div>
<p>Contains the next files</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>C:\LRing\t1.ring
C:\LRing\mylib.ring
C:\LRing\libs\mylib2.ring
</pre></div>
</div>
<p>The file t1.ring contains the next code</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">load</span> <span class="s">&quot;mylib.ring&quot;</span>
<span class="k">load</span> <span class="s">&quot;libs\mylib2.ring&quot;</span>
<span class="n">myfunc</span><span class="p">()</span>
<span class="n">test</span><span class="p">()</span>
</pre></div>
</div>
<p>The file mylib.ring contains the next code</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">func</span> <span class="n">myfunc</span>
        <span class="k">see</span> <span class="s">&quot;message from myfunc&quot;</span><span class="o">+</span><span class="n">nl</span>
</pre></div>
</div>
<p>The file libsmylib2.ring contains the next code</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">func</span> <span class="n">test</span>
        <span class="k">see</span> <span class="s">&quot;message from test&quot;</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>from the folder C:LRing</p>
<p>If Ring is not added to the path you can add it or use the next command</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>set path=%path%;c:\ring\bin;
</pre></div>
</div>
<p>Where c:ring is the Ring folder</p>
<p>Now run</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Ring t1.ring
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>message from myfunc
message from test
</pre></div>
</div>
</div>
<div class="section" id="why-this-example-use-the-getchar-twice">
<span id="index-37"></span><h2>Why this example use the GetChar() twice?<a class="headerlink" href="#why-this-example-use-the-getchar-twice" title="Permalink to this headline">¶</a></h2>
<p>The GetChar() function accept one character from the keyboard buffer</p>
<p>In this example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">While</span> <span class="kp">True</span>
        <span class="k">See</span> <span class="s">&quot;</span>
                <span class="n">Main</span> <span class="n">Menu</span>
                <span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="n">Say</span> <span class="n">Hello</span>
                <span class="p">(</span><span class="mi">2</span><span class="p">)</span> <span class="k">Exit</span>
        <span class="s">&quot;</span>
        <span class="n">Option</span> <span class="o">=</span> <span class="n">GetChar</span><span class="p">()</span>
        <span class="n">GetChar</span><span class="p">()</span> <span class="n">GetChar</span><span class="p">()</span>  <span class="c"># End of line</span>
        <span class="c"># the previous two lines can be replaced with the next line</span>
        <span class="c"># Give Option</span>

        <span class="k">if</span> <span class="n">Option</span> <span class="o">=</span> <span class="mi">1</span>
                <span class="k">see</span> <span class="s">&quot;Enter your name : &quot;</span> <span class="k">give</span> <span class="n">cName</span>
                <span class="k">see</span> <span class="s">&quot;Hello &quot;</span> <span class="o">+</span> <span class="n">cName</span>
        <span class="k">else</span>
                <span class="k">bye</span>
        <span class="k">ok</span>
<span class="k">End</span>
</pre></div>
</div>
<p>We uses GetChar() Three times</p>
<p>The first time we get the user option</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">Option</span> <span class="o">=</span> <span class="n">GetChar</span><span class="p">()</span>
</pre></div>
</div>
<p>But in the second and the third times (We accept the new line characters from the buffer)</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">GetChar</span><span class="p">()</span> <span class="n">GetChar</span><span class="p">()</span>  <span class="c"># End of line</span>
</pre></div>
</div>
<p>Example : when the user select the option number 1 then press ENTER</p>
<p>We have Three Characters</p>
<ul class="simple">
<li><p>The first character is : Number 1</p></li>
<li><p>The second character is : CHAR(13)</p></li>
<li><p>The third character is : CHAR(10)</p></li>
</ul>
<p>Because Windows uses CHAR(13) and CHAR(10) for each new line  ( i.e. CR+LF )</p>
</div>
<div class="section" id="how-to-use-null-and-isnull-function">
<span id="index-38"></span><h2>How to use NULL and ISNULL() function?<a class="headerlink" href="#how-to-use-null-and-isnull-function" title="Permalink to this headline">¶</a></h2>
<p>when we try to use uninitialized variable in the Ring programming language, we get a clear runtime error message</p>
<p>Example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="n">x</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Line 1 Error (R24) : Using uninitialized variable : x
in file tests\seeuninit.ring
</pre></div>
</div>
<p>The same happens when you try to access uninitialized attributes</p>
<p>Example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">o1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">point</span>
<span class="k">see</span> <span class="n">o1</span>
<span class="k">see</span> <span class="n">o1</span><span class="p">.</span><span class="n">x</span>
<span class="k">class</span> <span class="n">point</span> <span class="n">x</span> <span class="n">y</span> <span class="n">z</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>x: NULL
y: NULL
z: NULL

Line 3 Error (R24) : Using uninitialized variable : x
in file tests\seeuninit2.ring
</pre></div>
</div>
<p>if you want to check for the error, just use Try/Catch/End</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Try</span>
        <span class="k">see</span> <span class="n">x</span>
<span class="k">Catch</span>
        <span class="k">See</span> <span class="s">&quot;Sorry, We can&#39;t use x!&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">Done</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Sorry, We can&#39;t use x!
</pre></div>
</div>
<p>Now we will talk about NULL and ISNULL()</p>
<p>Since we get error message when we deal with uninitialized variables</p>
<p>We can check these errors using Try/Catch/Done, So we uses NULL and ISNULL() for dealing with Strings.</p>
<p>NULL is a variable contains an empty string</p>
<p>ISNULL() is a function that returns true (1) if the input is an empty string or just a string contains “NULL”</p>
<p>This because we need to test these values (empty strings) and strings contains “NULL” that sometimes come from external resource like DBMS.</p>
<p>Example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="n">IsNull</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>        <span class="c"># print 0</span>
<span class="n">IsNull</span><span class="p">(</span><span class="s">&quot;hello&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>      <span class="c"># print 0</span>
<span class="n">IsNull</span><span class="p">(</span><span class="o">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">5</span><span class="o">]</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>      <span class="c"># print 0</span>
<span class="n">IsNull</span><span class="p">(</span><span class="s">&quot;&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>           <span class="c"># print 1</span>
<span class="n">IsNull</span><span class="p">(</span><span class="s">&quot;NULL&quot;</span><span class="p">)</span>              <span class="c"># print 1</span>
</pre></div>
</div>
</div>
<div class="section" id="how-to-print-lists-that-contains-objects">
<span id="index-39"></span><h2>How to print lists that contains objects?<a class="headerlink" href="#how-to-print-lists-that-contains-objects" title="Permalink to this headline">¶</a></h2>
<p>In this example we will see how we can print a list contains objects.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">aList</span> <span class="o">=</span> <span class="o">[[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="o">]</span> <span class="p">,</span> <span class="k">new</span> <span class="n">point</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">),</span> <span class="k">new</span> <span class="n">point</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">)</span><span class="o">]</span>
<span class="k">see</span> <span class="s">&quot;print the list&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">see</span> <span class="n">alist</span>
<span class="k">see</span> <span class="s">&quot;print the item (object)&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">see</span> <span class="n">alist</span><span class="o">[</span><span class="mi">2</span><span class="o">]</span>
<span class="k">class</span> <span class="n">point</span> <span class="n">x</span> <span class="n">y</span> <span class="n">z</span>
        <span class="k">func</span> <span class="n">init</span> <span class="n">p1</span><span class="p">,</span><span class="n">p2</span><span class="p">,</span><span class="n">p3</span> <span class="n">x</span><span class="o">=</span><span class="n">p1</span> <span class="n">y</span><span class="o">=</span><span class="n">p2</span> <span class="n">z</span><span class="o">=</span><span class="n">p3</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>print the list
1
2
3
x: 1.000000
y: 2.000000
z: 3.000000
x: 1.000000
y: 2.000000
z: 3.000000
print the item (object)
x: 1.000000
y: 2.000000
z: 3.000000
</pre></div>
</div>
</div>
<div class="section" id="how-to-insert-an-item-to-the-first-position-in-the-list">
<span id="index-40"></span><h2>How to insert an item to the first position in the list?<a class="headerlink" href="#how-to-insert-an-item-to-the-first-position-in-the-list" title="Permalink to this headline">¶</a></h2>
<p>To insert an item we can use the insert(aList,nIndex,Value) function.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">aList</span> <span class="o">=</span> <span class="mi">1</span><span class="p">:</span><span class="mi">5</span>
<span class="n">insert</span><span class="p">(</span><span class="n">aList</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">)</span>
<span class="k">See</span> <span class="n">aList</span> <span class="c"># print numbers from 0 to 5</span>
</pre></div>
</div>
</div>
<div class="section" id="how-to-print-new-lines-and-other-characters">
<span id="index-41"></span><h2>How to print new lines and other characters?<a class="headerlink" href="#how-to-print-new-lines-and-other-characters" title="Permalink to this headline">¶</a></h2>
<p>To print new line we can use the nl variable.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="s">&quot;Hello&quot;</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>or we can use multi-line literal as in the next example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="s">&quot;Hello</span>

<span class="s">&quot;</span>
</pre></div>
</div>
<p>if we want to print other characters we can use the char(nASCII) function</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="n">char</span><span class="p">(</span><span class="mi">109</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span> <span class="o">+</span>    <span class="c"># print m</span>
    <span class="n">char</span><span class="p">(</span><span class="mi">77</span><span class="p">)</span>            <span class="c"># print M</span>
</pre></div>
</div>
</div>
<div class="section" id="why-we-don-t-use-after-the-qapp-class-name">
<span id="index-42"></span><h2>Why we don’t use () after the QApp class name?<a class="headerlink" href="#why-we-don-t-use-after-the-qapp-class-name" title="Permalink to this headline">¶</a></h2>
<p>When we use RingQt to create GUI application, we uses () after the
class name when we create new objects for example.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">new</span> <span class="n">qWidget</span><span class="p">()</span> <span class="p">{</span> <span class="n">setWindowTitle</span><span class="p">(</span><span class="s">&quot;Hello World&quot;</span><span class="p">)</span> <span class="n">resize</span><span class="p">(</span><span class="mi">400</span><span class="p">,</span><span class="mi">400</span><span class="p">)</span> <span class="n">show</span><span class="p">()</span> <span class="p">}</span>
</pre></div>
</div>
<p>but before doing that we create an object from the qApp class and we don’t use () after that</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Load</span> <span class="s">&quot;guilib.ring&quot;</span>
<span class="n">app</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qApp</span>
<span class="p">{</span>
    <span class="n">win</span><span class="o">=</span><span class="k">new</span> <span class="n">qWidget</span><span class="p">()</span>
    <span class="p">{</span>
        <span class="n">setwindowtitle</span><span class="p">(:</span><span class="n">test</span><span class="p">)</span>
        <span class="n">show</span><span class="p">()</span>
    <span class="p">}</span>
    <span class="n">exec</span><span class="p">()</span>
<span class="p">}</span>
</pre></div>
</div>
<p>Using () after the class name means calling the init() method in the class and passing parameters to this method.</p>
<p>If we used () while no init() method in the class we get the expected error message.</p>
<p>The class qApp don’t have this method while the other classes have it because they need it to
create an object using a function that return a pointer to that object and this pointer will
be stored in an attribute called pObject, for more information see ring_qt.ring file
which contains the classes.</p>
</div>
<div class="section" id="why-the-window-title-bar-is-going-outside-the-screen">
<span id="index-43"></span><h2>Why the window title bar is going outside the screen?<a class="headerlink" href="#why-the-window-title-bar-is-going-outside-the-screen" title="Permalink to this headline">¶</a></h2>
<p>When we write the next code</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Load</span> <span class="s">&quot;guilib.ring&quot;</span>
<span class="n">app</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qApp</span>
<span class="p">{</span>
        <span class="n">win</span><span class="o">=</span><span class="k">new</span> <span class="n">qWidget</span><span class="p">()</span>
        <span class="p">{</span>
              <span class="n">setwindowtitle</span><span class="p">(:</span><span class="n">test</span><span class="p">)</span>
              <span class="n">setGeometry</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">200</span><span class="p">,</span><span class="mi">200</span><span class="p">)</span>
              <span class="n">show</span><span class="p">()</span>
        <span class="p">}</span>
        <span class="n">exec</span><span class="p">()</span>
<span class="p">}</span>
</pre></div>
</div>
<p>I would expect that the window will run at the point (0,0) with (200,200) size but the actual
result is that the window title bar is going outside the screen.</p>
<p>This is related to the behavior of Qt framework.</p>
<p>The next code will avoid the problem</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">load</span> <span class="s">&quot;guilib.ring&quot;</span>
<span class="k">new</span> <span class="n">qApp</span> <span class="p">{</span>
        <span class="k">new</span> <span class="n">qWidget</span><span class="p">()</span> <span class="p">{</span>
                <span class="n">move</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">)</span>
                <span class="n">resize</span><span class="p">(</span><span class="mi">200</span><span class="p">,</span><span class="mi">200</span><span class="p">)</span>
                <span class="n">show</span><span class="p">()</span>
        <span class="p">}</span>
        <span class="n">exec</span><span class="p">()</span>
<span class="p">}</span>
</pre></div>
</div>
</div>
<div class="section" id="how-to-create-an-array-of-buttons-in-gui-applications">
<span id="index-44"></span><h2>How to create an array of buttons in GUI applications?<a class="headerlink" href="#how-to-create-an-array-of-buttons-in-gui-applications" title="Permalink to this headline">¶</a></h2>
<p>Check the next example:</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Load</span> <span class="s">&quot;guilib.ring&quot;</span>

<span class="n">App1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qApp</span> <span class="p">{</span>

        <span class="n">win1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qWidget</span><span class="p">()</span> <span class="p">{</span>
                <span class="n">move</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">)</span>
                <span class="n">resize</span><span class="p">(</span><span class="mi">500</span><span class="p">,</span><span class="mi">500</span><span class="p">)</span>
                <span class="k">new</span> <span class="n">qPushButton</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span>
                <span class="p">{</span>
                        <span class="n">settext</span><span class="p">(</span><span class="s">&quot;OK&quot;</span><span class="p">)</span>
                        <span class="n">setclickevent</span><span class="p">(</span><span class="s">&quot;click()&quot;</span><span class="p">)</span>
                <span class="p">}</span>
                <span class="n">btn1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qPushButton</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span>
                <span class="p">{</span>
                        <span class="n">setgeometry</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">30</span><span class="p">)</span>
                        <span class="n">settext</span><span class="p">(</span><span class="s">&quot;Button1&quot;</span><span class="p">)</span>
                <span class="p">}</span>

                <span class="n">btn2</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qPushButton</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span>
                <span class="p">{</span>
                        <span class="n">setgeometry</span><span class="p">(</span><span class="mi">200</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">30</span><span class="p">)</span>
                        <span class="n">settext</span><span class="p">(</span><span class="s">&quot;Button2&quot;</span><span class="p">)</span>
                <span class="p">}</span>

                <span class="n">button</span> <span class="o">=</span> <span class="o">[</span><span class="n">btn1</span><span class="p">,</span> <span class="n">btn2</span><span class="o">]</span>
                <span class="n">show</span><span class="p">()</span>
        <span class="p">}</span>

        <span class="n">exec</span><span class="p">()</span>

<span class="p">}</span>

<span class="k">func</span> <span class="n">click</span>

        <span class="n">button</span><span class="o">[</span><span class="mi">1</span><span class="o">]</span> <span class="p">{</span> <span class="n">settext</span> <span class="p">(</span><span class="s">&quot;Button3&quot;</span><span class="p">)</span> <span class="p">}</span>
        <span class="n">button</span><span class="o">[</span><span class="mi">2</span><span class="o">]</span> <span class="p">{</span> <span class="n">settext</span> <span class="p">(</span><span class="s">&quot;Button4&quot;</span><span class="p">)</span> <span class="p">}</span>
</pre></div>
</div>
</div>
<div class="section" id="how-to-close-a-window-then-displaying-another-one">
<span id="index-45"></span><h2>How to Close a window then displaying another one?<a class="headerlink" href="#how-to-close-a-window-then-displaying-another-one" title="Permalink to this headline">¶</a></h2>
<p>This example demonstrates how to close a window and show another one</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Load &quot;guilib.ring&quot;

app=new qApp
{
        frmBefore=new Qwidget()
        {
                setWindowTitle(&quot;before!&quot;)
                resize(300,320)
                move(200,200)

                button=new qPushButton(frmBefore)
                {
                        setText(&quot;Close&quot;)
                        setClickEvent(&quot;frmBefore.close() frmMain.show()&quot;)
                }

                show()
        }

        frmMain=new Qwidget()
        {
                setWindowTitle(&quot;After!&quot;)
                resize(300,320)
                move(200,200)
        }

        exec()

}
</pre></div>
</div>
</div>
<div class="section" id="how-to-create-a-modal-window">
<span id="index-46"></span><h2>How to create a Modal Window?<a class="headerlink" href="#how-to-create-a-modal-window" title="Permalink to this headline">¶</a></h2>
<p>This example demonstrates how to create a modal window</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">load</span> <span class="s">&quot;guilib.ring&quot;</span>
<span class="n">app</span><span class="o">=</span><span class="k">new</span> <span class="n">qApp</span>
<span class="p">{</span>
        <span class="n">frmStart</span><span class="o">=</span><span class="k">new</span> <span class="n">Qwidget</span><span class="p">()</span>
        <span class="p">{</span>
                <span class="n">setWindowTitle</span><span class="p">(</span><span class="s">&quot;The First Window&quot;</span><span class="p">)</span>
                <span class="n">resize</span><span class="p">(</span><span class="mi">300</span><span class="p">,</span><span class="mi">320</span><span class="p">)</span>
                <span class="n">move</span><span class="p">(</span><span class="mi">200</span><span class="p">,</span><span class="mi">200</span><span class="p">)</span>

                <span class="n">button</span><span class="o">=</span><span class="k">new</span> <span class="n">qPushButton</span><span class="p">(</span><span class="n">frmStart</span><span class="p">)</span>
                <span class="p">{</span>
                        <span class="n">setText</span><span class="p">(</span><span class="s">&quot;Show Modal Window&quot;</span><span class="p">)</span>
                        <span class="n">resize</span><span class="p">(</span><span class="mi">200</span><span class="p">,</span><span class="mi">30</span><span class="p">)</span>
                        <span class="n">setClickEvent</span><span class="p">(</span><span class="s">&quot;frmModal.show()&quot;</span><span class="p">)</span>
                <span class="p">}</span>

                <span class="k">new</span> <span class="n">qPushButton</span><span class="p">(</span><span class="n">frmStart</span><span class="p">)</span>
                <span class="p">{</span>
                        <span class="n">setText</span><span class="p">(</span><span class="s">&quot;Close Window&quot;</span><span class="p">)</span>
                        <span class="n">move</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">50</span><span class="p">)</span>
                        <span class="n">resize</span><span class="p">(</span><span class="mi">200</span><span class="p">,</span><span class="mi">30</span><span class="p">)</span>
                        <span class="n">setClickEvent</span><span class="p">(</span><span class="s">&quot;frmStart.Close()&quot;</span><span class="p">)</span>
                <span class="p">}</span>

                <span class="n">show</span><span class="p">()</span>
        <span class="p">}</span>

        <span class="n">frmModal</span> <span class="o">=</span><span class="k">new</span> <span class="n">Qwidget</span><span class="p">()</span>
        <span class="p">{</span>
                <span class="n">setWindowTitle</span><span class="p">(</span><span class="s">&quot;Modal Window&quot;</span><span class="p">)</span>
                <span class="n">resize</span><span class="p">(</span><span class="mi">300</span><span class="p">,</span><span class="mi">320</span><span class="p">)</span>
                <span class="n">move</span><span class="p">(</span><span class="mi">200</span><span class="p">,</span><span class="mi">200</span><span class="p">)</span>
                <span class="n">setparent</span><span class="p">(</span><span class="n">frmStart</span><span class="p">)</span>
                <span class="n">setwindowmodality</span><span class="p">(</span><span class="kp">true</span><span class="p">)</span>
                <span class="n">setwindowflags</span><span class="p">(</span><span class="n">Qt_Dialog</span><span class="p">)</span>
        <span class="p">}</span>

        <span class="n">exec</span><span class="p">()</span>

<span class="p">}</span>
</pre></div>
</div>
<p>Related Documents</p>
<ul class="simple">
<li><p><a class="reference external" href="http://doc.qt.io/qt-5/qtwidgets-widgets-windowflags-example.html">http://doc.qt.io/qt-5/qtwidgets-widgets-windowflags-example.html</a></p></li>
<li><p><a class="reference external" href="http://doc.qt.io/qt-5/qt.html#WindowType-enum">http://doc.qt.io/qt-5/qt.html#WindowType-enum</a></p></li>
<li><p><a class="reference external" href="http://doc.qt.io/qt-5/qwindow.html#setParent">http://doc.qt.io/qt-5/qwindow.html#setParent</a></p></li>
<li><p><a class="reference external" href="http://doc.qt.io/qt-5/qt.html#WindowModality-enum">http://doc.qt.io/qt-5/qt.html#WindowModality-enum</a></p></li>
</ul>
</div>
<div class="section" id="how-can-i-disable-maximize-button-and-resize-window">
<span id="index-47"></span><h2>How can I disable maximize button and resize window?<a class="headerlink" href="#how-can-i-disable-maximize-button-and-resize-window" title="Permalink to this headline">¶</a></h2>
<p>Use the method setWindowFlags()</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Load</span> <span class="s">&quot;guilib.ring&quot;</span>
<span class="n">app1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qapp</span> <span class="p">{</span>
                <span class="n">win1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qwidget</span><span class="p">()</span> <span class="p">{</span>
                                <span class="n">setwindowtitle</span><span class="p">(</span><span class="s">&quot;First&quot;</span><span class="p">)</span>
                                <span class="n">setgeometry</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">500</span><span class="p">,</span><span class="mi">500</span><span class="p">)</span>

                                <span class="k">new</span> <span class="n">qpushbutton</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span> <span class="p">{</span>
                                                <span class="n">setgeometry</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">30</span><span class="p">)</span>
                                                <span class="n">settext</span><span class="p">(</span><span class="s">&quot;close&quot;</span><span class="p">)</span>
                                                <span class="n">setclickevent</span><span class="p">(</span><span class="s">&quot;app1.quit()&quot;</span><span class="p">)</span>
                                <span class="p">}</span>

                                <span class="k">new</span> <span class="n">qpushbutton</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span> <span class="p">{</span>
                                                <span class="n">setgeometry</span><span class="p">(</span><span class="mi">250</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">30</span><span class="p">)</span>
                                                <span class="n">settext</span><span class="p">(</span><span class="s">&quot;Second&quot;</span><span class="p">)</span>
                                                <span class="n">setclickevent</span><span class="p">(</span><span class="s">&quot;second()&quot;</span><span class="p">)</span>
                                <span class="p">}</span>

                                <span class="n">showmaximized</span><span class="p">()</span>
                <span class="p">}</span>
                <span class="n">exec</span><span class="p">()</span>
<span class="p">}</span>

<span class="k">func</span> <span class="n">second</span>
                <span class="n">win2</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qwidget</span><span class="p">()</span> <span class="p">{</span>
                                <span class="n">setwindowtitle</span><span class="p">(</span><span class="s">&quot;Second&quot;</span><span class="p">)</span>
                                <span class="n">setgeometry</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">500</span><span class="p">,</span><span class="mi">500</span><span class="p">)</span>
                                <span class="n">setwindowflags</span><span class="p">(</span><span class="n">Qt_dialog</span><span class="p">)</span>
                                <span class="n">show</span><span class="p">()</span>
                <span class="p">}</span>
</pre></div>
</div>
</div>
<div class="section" id="how-to-use-sqlite-using-odbc">
<span id="index-48"></span><h2>How to use SQLite using ODBC?<a class="headerlink" href="#how-to-use-sqlite-using-odbc" title="Permalink to this headline">¶</a></h2>
<p>In Ring 1.1 and later versions we have native support for SQLite, so you don’t need to use it through ODBC.</p>
<p>Also we can access SQLite through RingQt.</p>
<p>The answer to your question</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="n">pODBC</span> <span class="o">=</span> <span class="n">odbc_init</span><span class="p">()</span>
<span class="n">odbc_connect</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;DRIVER=SQLite3 ODBC Driver;Database=mydb.db;LongNames=0;&quot;</span><span class="o">+</span>
                   <span class="s">&quot;Timeout=1000;NoTXN=0;SyncPragma=NORMAL;StepAPI=0;&quot;</span><span class="p">)</span>
<span class="n">odbc_execute</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;create table &#39;tel&#39; (&#39;ID&#39;,&#39;NAME&#39;,&#39;PHONE&#39;);&quot;</span><span class="p">)</span>
<span class="n">odbc_execute</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;insert into &#39;tel&#39; values (&#39;1&#39;,&#39;Mahmoud&#39;,&#39;123456&#39;);&quot;</span><span class="p">)</span>
<span class="n">odbc_execute</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;insert into &#39;tel&#39; values (&#39;2&#39;,&#39;Ahmed&#39;,&#39;123456&#39;);&quot;</span><span class="p">)</span>
<span class="n">odbc_execute</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;insert into &#39;tel&#39; values (&#39;3&#39;,&#39;Ibrahim&#39;,&#39;123456&#39;);&quot;</span><span class="p">)</span>
<span class="n">odbc_execute</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;select * from tel&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">nMax</span> <span class="o">=</span> <span class="n">odbc_colcount</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
<span class="k">See</span> <span class="s">&quot;Columns Count : &quot;</span> <span class="o">+</span> <span class="n">nMax</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">while</span> <span class="n">odbc_fetch</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
        <span class="k">See</span> <span class="n">nl</span>
        <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="n">nMax</span>
                <span class="k">see</span> <span class="n">odbc_getdata</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="n">x</span><span class="p">)</span>
                <span class="k">if</span> <span class="n">x</span> <span class="o">!=</span> <span class="n">nMax</span> <span class="k">see</span> <span class="s">&quot; - &quot;</span> <span class="k">ok</span>
        <span class="k">next</span>
<span class="k">end</span>
<span class="n">odbc_disconnect</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
<span class="n">odbc_close</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
</pre></div>
</div>
<p>Output:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Columns Count : 3

1 - Mahmoud - 123456
2 - Ahmed - 123456
3 - Ibrahim - 123456
</pre></div>
</div>
<p>The program will create the file : mydb.db</p>
<p>Note : when I print the odbc drivers I see the long list that includes</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>SQLite3 ODBC Driver - UsageCount=1
SQLite ODBC Driver - UsageCount=1
SQLite ODBC (UTF-8) Driver - UsageCount=1
</pre></div>
</div>
<p>And I’m using “SQLite3 ODBC Driver”.</p>
</div>
<div class="section" id="can-i-connect-to-dbase-harbour-database">
<span id="index-49"></span><h2>Can I connect to dbase/harbour database?<a class="headerlink" href="#can-i-connect-to-dbase-harbour-database" title="Permalink to this headline">¶</a></h2>
<p>You can connect to any database using ODBC</p>
<p>To connect to xbase files (<a href="#id1"><span class="problematic" id="id2">*</span></a>.DBF)</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="s">&quot;Using DBF Files using ODBC&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">pODBC</span> <span class="o">=</span> <span class="n">odbc_init</span><span class="p">()</span>
<span class="k">See</span> <span class="s">&quot;Connect to database&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">odbc_connect</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;Driver={Microsoft dBase Driver (*.dbf)};&quot;</span><span class="o">+</span>
                   <span class="s">&quot;datasource=dBase Files;DriverID=277&quot;</span><span class="p">)</span>
<span class="k">See</span> <span class="s">&quot;Select data&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">odbc_execute</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;select * from tel.dbf&quot;</span><span class="p">)</span>
<span class="n">nMax</span> <span class="o">=</span> <span class="n">odbc_colcount</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
<span class="k">See</span> <span class="s">&quot;Columns Count : &quot;</span> <span class="o">+</span> <span class="n">nMax</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">while</span> <span class="n">odbc_fetch</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
           <span class="k">See</span> <span class="s">&quot;Row data:&quot;</span> <span class="o">+</span> <span class="n">nl</span>
           <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="n">nMax</span>
                           <span class="k">see</span> <span class="n">odbc_getdata</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="n">x</span><span class="p">)</span> <span class="o">+</span> <span class="s">&quot; - &quot;</span>
           <span class="k">next</span>
<span class="k">end</span>
<span class="k">See</span> <span class="s">&quot;Close database...&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">odbc_disconnect</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
<span class="n">odbc_close</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Using DBF Files using ODBC
Connect to database
Select data
Columns Count : 3
Row data:
Ahmad - Egypt - 234567 - Row data:
Fady - Egypt - 345678 - Row data:
Shady - Egypt - 456789 - Row data:
Mahmoud - Egypt - 123456 - Close database...
</pre></div>
</div>
<p>Also you can connect to a Visual FoxPro database (requires installing Visual FoxPro driver)</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="s">&quot;ODBC test 6&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">pODBC</span> <span class="o">=</span> <span class="n">odbc_init</span><span class="p">()</span>
<span class="k">See</span> <span class="s">&quot;Connect to database&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">odbc_connect</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;Driver={Microsoft Visual FoxPro Driver};&quot;</span><span class="o">+</span>
        <span class="s">&quot;SourceType=DBC;SourceDB=C:\PWCT19\ssbuild\PWCTDATA</span><span class="se">\C</span><span class="s">H1\Data\mydata.dbc;&quot;</span><span class="p">)</span>
<span class="k">See</span> <span class="s">&quot;Select data&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">see</span> <span class="n">odbc_execute</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="s">&quot;select * from t38&quot;</span><span class="p">)</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">nMax</span> <span class="o">=</span> <span class="n">odbc_colcount</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
<span class="k">See</span> <span class="s">&quot;Columns Count : &quot;</span> <span class="o">+</span> <span class="n">nMax</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">while</span> <span class="n">odbc_fetch</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
        <span class="k">See</span> <span class="s">&quot;Row data:&quot;</span> <span class="o">+</span> <span class="n">nl</span>
        <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="n">nMax</span>
                <span class="k">see</span> <span class="n">odbc_getdata</span><span class="p">(</span><span class="n">pODBC</span><span class="p">,</span><span class="n">x</span><span class="p">)</span> <span class="o">+</span> <span class="s">&quot; - &quot;</span>
        <span class="k">next</span>
<span class="k">end</span>
<span class="k">See</span> <span class="s">&quot;Close database...&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="n">odbc_disconnect</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
<span class="n">odbc_close</span><span class="p">(</span><span class="n">pODBC</span><span class="p">)</span>
</pre></div>
</div>
</div>
<div class="section" id="why-setclickevent-doesn-t-see-the-object-methods-directly">
<span id="index-50"></span><h2>Why setClickEvent() doesn’t see the object methods directly?<a class="headerlink" href="#why-setclickevent-doesn-t-see-the-object-methods-directly" title="Permalink to this headline">¶</a></h2>
<p>setClickEvent(cCode) take a string contains code. The code will be executed when the event happens.</p>
<p>Ring support Many Programming Paradigms like Procedural, OOP, Functional and others.</p>
<p>But when you support many paradigms at the language level you can’t know which paradigm will be used so you have two options</p>
<ol class="arabic simple">
<li><p>Provide General Solutions that works with many programming paradigms.</p></li>
<li><p>Provide Many Specific solutions where each one match a specific paradigm.</p></li>
</ol>
<p>setClickEvent() and others belong to (General Solutions that works with many programming paradigms).</p>
<p>You just pass a string of code that will be executed without any care about classes and objects.</p>
<p>This code could be anything like calling a function, calling a method and setting variable value.</p>
<p>Some other languages force you to use OOP and call methods for events.
Also some other languages uses anonymous functions that may get parameters like the current object.</p>
<p>Now we have the general solution (not restricted with any paradigm), In the future we may
add specific solutions that match specific paradigms (OOP, Functional, Declarative and Natural).</p>
</div>
<div class="section" id="why-i-get-calling-function-without-definition-error">
<span id="index-51"></span><h2>Why I get Calling Function without definition Error?<a class="headerlink" href="#why-i-get-calling-function-without-definition-error" title="Permalink to this headline">¶</a></h2>
<p>Each program follow the next order</p>
<p>1 - Loading Files
2 - Global Variables and Statements
3 - Functions
4 - Packages, Classes and Methods</p>
<p>So what does that mean ?</p>
<ol class="arabic simple">
<li><p><a href="#id3"><span class="problematic" id="id4">**</span></a>** No Functions comes After Classes <a href="#id5"><span class="problematic" id="id6">**</span></a><a href="#id7"><span class="problematic" id="id8">**</span></a></p></li>
<li><p><a href="#id9"><span class="problematic" id="id10">**</span></a>** No command is required to end functions/methods/classes/packages <a href="#id11"><span class="problematic" id="id12">**</span></a><a href="#id13"><span class="problematic" id="id14">**</span></a></p></li>
</ol>
<p>Look at this example</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="s">&quot;Hello&quot;</span>
<span class="n">test</span><span class="p">()</span>
<span class="k">func</span> <span class="n">test</span>
    <span class="k">see</span> <span class="s">&quot;message from the test function!&quot;</span> <span class="o">+</span> <span class="n">nl</span>
<span class="k">class</span> <span class="n">test</span>
</pre></div>
</div>
<p>In the previous example we have a function called test() so we can call it directly using test()</p>
<p>In the next example, test() will become a method</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="s">See&quot;Hello&quot;</span>
<span class="n">test</span><span class="p">()</span>    <span class="c"># runtime error message</span>
<span class="k">class</span> <span class="n">test</span>
        <span class="k">func</span> <span class="n">test</span> <span class="c"># Test() now is a method (not a function)</span>
                <span class="k">see</span> <span class="s">&quot;message from the test method!&quot;</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
<p>The errors comes when you define a method then try calling it directly as a function.</p>
<p>The previous program must be</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="s">See&quot;Hello&quot;</span>
<span class="k">new</span> <span class="n">test</span> <span class="p">{</span> <span class="n">test</span><span class="p">()</span> <span class="p">}</span>   <span class="c"># now will call the method</span>
<span class="k">class</span> <span class="n">test</span>
        <span class="k">func</span> <span class="n">test</span> <span class="c"># Test() now is a method (not a function)</span>
                <span class="k">see</span> <span class="s">&quot;message from the test method!&quot;</span> <span class="o">+</span> <span class="n">nl</span>
</pre></div>
</div>
</div>
<div class="section" id="can-ring-work-on-windows-xp">
<span id="index-52"></span><h2>Can Ring work on Windows XP?<a class="headerlink" href="#can-ring-work-on-windows-xp" title="Permalink to this headline">¶</a></h2>
<p>Ring can work on Windows XP and load extensions without problems.</p>
<p>Just be sure that the extension can work on Windows XP and your compiler version support that (modern compilers requires some flags to support XP)</p>
<p>Check this topic
<a class="reference external" href="https://blogs.msdn.microsoft.com/vcblog/2012/10/08/windows-xp-targeting-with-c-in-visual-studio-2012/">https://blogs.msdn.microsoft.com/vcblog/2012/10/08/windows-xp-targeting-with-c-in-visual-studio-2012/</a></p>
<p>For example, We added</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>/link /SUBSYSTEM:CONSOLE,&quot;5.01&quot;
</pre></div>
</div>
<p>To the batch file to support Windows XP</p>
<p>See : <a class="reference external" href="https://github.com/ring-lang/ring/blob/master/language/src/buildvc.bat">https://github.com/ring-lang/ring/blob/master/language/src/buildvc.bat</a></p>
</div>
<div class="section" id="how-to-extend-ringqt-and-add-more-classes">
<span id="index-53"></span><h2>How to extend RingQt and add more classes?<a class="headerlink" href="#how-to-extend-ringqt-and-add-more-classes" title="Permalink to this headline">¶</a></h2>
<p>You have many options</p>
<p>In general you can extend Ring using C or C++ code</p>
<p>Ring from Ring code you can call C Functions or use C++ Classes &amp; Methods</p>
<p>This chapter in the documentation explains this part in the language
<a class="reference external" href="https://ring-lang.sourceforge.io/doc1.13/extension.html">https://ring-lang.sourceforge.io/doc1.13/extension.html</a></p>
<p>For example the next code in <em>.c file can be compiled to a DLL file using the Ring library (</em>.lib)</p>
<div class="highlight-c notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">&quot;ring.h&quot;</span><span class="cp"></span>

<span class="n">RING_FUNC</span><span class="p">(</span><span class="n">ring_ringlib_dlfunc</span><span class="p">)</span>
<span class="p">{</span>
        <span class="n">printf</span><span class="p">(</span><span class="s">&quot;Message from dlfunc&quot;</span><span class="p">);</span>
<span class="p">}</span>

<span class="n">RING_API</span> <span class="kt">void</span> <span class="n">ringlib_init</span><span class="p">(</span><span class="n">RingState</span> <span class="o">*</span><span class="n">pRingState</span><span class="p">)</span>
<span class="p">{</span>
        <span class="n">ring_vm_funcregister</span><span class="p">(</span><span class="s">&quot;dlfunc&quot;</span><span class="p">,</span><span class="n">ring_ringlib_dlfunc</span><span class="p">);</span>
<span class="p">}</span>
</pre></div>
</div>
<p>Then from Ring you can load the DLL file using LoadLib() function then call the C function that called dlfunc() as any Ring function.</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">See</span> <span class="s">&quot;Dynamic DLL&quot;</span> <span class="o">+</span> <span class="n">NL</span>
<span class="n">LoadLib</span><span class="p">(</span><span class="s">&quot;ringlib.dll&quot;</span><span class="p">)</span>
<span class="n">dlfunc</span><span class="p">()</span>
</pre></div>
</div>
<p>Output</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Dynamic DLL
Message from dlfunc
</pre></div>
</div>
<p>When you read the documentation you will know about how to get parameters like (strings, numbers, lists and objects)</p>
<p>And how to return a value (any type) from you function.</p>
<p>From experience, when we support a C library or C++ Library</p>
<p>We discovered that a lot of functions share a lot of code</p>
<p>To save our time, and to quickly generate wrappers for C/C++ Libraries to be used in Ring</p>
<p>We have this code generator</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/codegen/parsec.ring">https://github.com/ring-lang/ring/blob/master/extensions/codegen/parsec.ring</a></p>
<p>The code generator is just a Ring program &lt; 1200 lines of Ring code</p>
<p>The generator take as input a configuration file contains the C/C++ library information</p>
<p>like Functions Prototype, Classes and Methods, Constants, Enum, Structures and members , etc.</p>
<p>Then the generator will generate</p>
<p><a href="#id15"><span class="problematic" id="id16">*</span></a>.C File for C libraries (to be able to use the library functions)</p>
<p><a href="#id17"><span class="problematic" id="id18">*</span></a>.CPP File for C++ libraries (to be able to use C++ classes and methods)</p>
<p><a href="#id19"><span class="problematic" id="id20">*</span></a>.Ring File (to be able to use C++ classes as Ring classes)</p>
<p><a href="#id21"><span class="problematic" id="id22">*</span></a>.RH file (Constants)</p>
<p>To understand how the generator work check this extension for the Allegro game programming library</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/tree/master/extensions/ringallegro">https://github.com/ring-lang/ring/tree/master/extensions/ringallegro</a></p>
<p>At first we have the configuration file</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/allegro.cf">https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/allegro.cf</a></p>
<p>To write this file, i just used the Allegro documentation + the Ring code generator rules</p>
<p>Then after executing the generator using this batch file</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/gencode.bat">https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/gencode.bat</a></p>
<p>or using this script</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/gencode.sh">https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/gencode.sh</a></p>
<p>I get the generated source code file</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/ring_allegro.c">https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/ring_allegro.c</a></p>
<p>The generated source code file (ring_allegro.c) is around 12,000 Lines of code (12 KLOC)</p>
<p>While the configuration file is less than 1 KLOC</p>
<p>To build the library (create the DLL files)</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/buildvc.bat">https://github.com/ring-lang/ring/blob/master/extensions/ringallegro/buildvc.bat</a></p>
<p>Also you can check this extension for the LibSDL Library</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/tree/master/extensions/ringsdl">https://github.com/ring-lang/ring/tree/master/extensions/ringsdl</a></p>
<p>After this know you should know about</p>
<p>1 - Writing the configuration file</p>
<p>2 - Using the Code Generator</p>
<p>3 - Building your library/extension</p>
<p>4 - Using your library/extension from Ring code</p>
<p>Let us move now to you question about Qt</p>
<p>We have RingQt which is just an extension to ring (ringqt.dll)</p>
<p>You don’t need to modify Ring.</p>
<ol class="arabic simple">
<li><p>You just need to modify RingQt</p></li>
<li><p>Or extend Ring with another extension based on Qt (but the same Qt version)</p></li>
</ol>
<p>For the first option see the RingQt extension</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/tree/master/extensions/ringqt">https://github.com/ring-lang/ring/tree/master/extensions/ringqt</a></p>
<p>Configuration file</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringqt/classes/qt.cf">https://github.com/ring-lang/ring/blob/master/extensions/ringqt/classes/qt.cf</a></p>
<p>To generate the source code</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringqt/gencode.bat">https://github.com/ring-lang/ring/blob/master/extensions/ringqt/gencode.bat</a></p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringqt/gencode.sh">https://github.com/ring-lang/ring/blob/master/extensions/ringqt/gencode.sh</a></p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringqt/gencodeandroid.bat">https://github.com/ring-lang/ring/blob/master/extensions/ringqt/gencodeandroid.bat</a></p>
<p>To build the DLL/so/Dylib files</p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringqt/buildmingw32.bat">https://github.com/ring-lang/ring/blob/master/extensions/ringqt/buildmingw32.bat</a></p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringqt/buildgcc.sh">https://github.com/ring-lang/ring/blob/master/extensions/ringqt/buildgcc.sh</a></p>
<p><a class="reference external" href="https://github.com/ring-lang/ring/blob/master/extensions/ringqt/buildclang.sh">https://github.com/ring-lang/ring/blob/master/extensions/ringqt/buildclang.sh</a></p>
<p>Study RingQt</p>
<p>Learn about the options that you have</p>
<ol class="arabic simple">
<li><p>wrapping a Qt class directly</p></li>
<li><p>Creating a new class then wrapping your new class</p></li>
</ol>
<p>For the second option (in the previous two points or in the two points before that)</p>
<p>You will create new classes in C++ code</p>
<p>Then you merge these classes to RingQt or provide special DLL for them (your decision)</p>
<p>If your work is general (will help others) just put it to RingQt.</p>
<p>if your work is special (to specific application) just put it in another extension.</p>
</div>
<div class="section" id="how-to-add-combobox-and-other-elements-to-the-cells-of-a-qtablewidget">
<span id="index-54"></span><h2>How to add Combobox and other elements to the cells of a QTableWidget?<a class="headerlink" href="#how-to-add-combobox-and-other-elements-to-the-cells-of-a-qtablewidget" title="Permalink to this headline">¶</a></h2>
<p>Check the next code</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Load</span> <span class="s">&quot;guilib.ring&quot;</span>
<span class="k">New</span> <span class="n">qApp</span>
<span class="p">{</span>
        <span class="n">win1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qMainWindow</span><span class="p">()</span> <span class="p">{</span>
                <span class="n">setGeometry</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">1100</span><span class="p">,</span><span class="mi">370</span><span class="p">)</span>
                <span class="n">setwindowtitle</span><span class="p">(</span><span class="s">&quot;Using QTableWidget&quot;</span><span class="p">)</span>

                <span class="n">Table1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qTableWidget</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span> <span class="p">{</span>
                        <span class="n">setrowcount</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span> <span class="n">setcolumncount</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span>
                        <span class="n">setGeometry</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">800</span><span class="p">,</span><span class="mi">400</span><span class="p">)</span>
                        <span class="n">setselectionbehavior</span><span class="p">(</span><span class="n">QAbstractItemView_SelectRows</span><span class="p">)</span>

                        <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">10</span>
                                <span class="k">for</span> <span class="n">y</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">10</span>
                                        <span class="n">item1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qtablewidgetitem</span><span class="p">(</span><span class="s">&quot;R&quot;</span><span class="o">+</span><span class="n">X</span><span class="o">+</span><span class="s">&quot;C&quot;</span><span class="o">+</span><span class="n">Y</span><span class="p">)</span>
                                        <span class="n">setitem</span><span class="p">(</span><span class="n">x</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span><span class="n">y</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="n">item1</span><span class="p">)</span>
                                <span class="k">next</span>
                        <span class="k">next</span>

                        <span class="n">cmb</span> <span class="o">=</span> <span class="k">new</span> <span class="n">QComboBox</span><span class="p">(</span><span class="n">Table1</span><span class="p">)</span> <span class="p">{</span>
                                <span class="n">alist</span> <span class="o">=</span> <span class="o">[</span><span class="s">&quot;one&quot;</span><span class="p">,</span><span class="s">&quot;two&quot;</span><span class="p">,</span><span class="s">&quot;three&quot;</span><span class="p">,</span><span class="s">&quot;four&quot;</span><span class="p">,</span><span class="s">&quot;five&quot;</span><span class="o">]</span>
                                <span class="k">for</span> <span class="n">x</span> <span class="k">in</span> <span class="n">aList</span> <span class="n">additem</span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="mi">0</span><span class="p">)</span> <span class="k">next</span>
                        <span class="p">}</span>
                                <span class="n">setCellWidget</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="n">cmb</span><span class="p">)</span>
                <span class="p">}</span>

                <span class="n">setcentralwidget</span><span class="p">(</span><span class="n">table1</span><span class="p">)</span>
                <span class="n">show</span><span class="p">()</span>
        <span class="p">}</span>
        <span class="n">exec</span><span class="p">()</span>
<span class="p">}</span>
</pre></div>
</div>
</div>
<div class="section" id="how-to-perform-some-manipulations-on-selected-cells-in-qtablewidget">
<span id="index-55"></span><h2>How to perform some manipulations on selected cells in QTableWidget?<a class="headerlink" href="#how-to-perform-some-manipulations-on-selected-cells-in-qtablewidget" title="Permalink to this headline">¶</a></h2>
<p>Check the next sample</p>
<div class="highlight-ring notranslate"><div class="highlight"><pre><span></span><span class="k">Load</span> <span class="s">&quot;guilib.ring&quot;</span>

<span class="k">New</span> <span class="n">qApp</span> <span class="p">{</span>
        <span class="n">win1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qMainWindow</span><span class="p">()</span> <span class="p">{</span>
                <span class="n">setGeometry</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">800</span><span class="p">,</span><span class="mi">600</span><span class="p">)</span>
                <span class="n">setwindowtitle</span><span class="p">(</span><span class="s">&quot;Using QTableWidget&quot;</span><span class="p">)</span>
                <span class="n">Table1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qTableWidget</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span> <span class="p">{</span>
                        <span class="n">setrowcount</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span> <span class="n">setcolumncount</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span>
                        <span class="n">setGeometry</span><span class="p">(</span><span class="mi">10</span><span class="p">,</span><span class="mi">10</span><span class="p">,</span><span class="mi">400</span><span class="p">,</span><span class="mi">400</span><span class="p">)</span>
                        <span class="k">for</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">10</span>
                                <span class="k">for</span> <span class="n">y</span> <span class="o">=</span> <span class="mi">1</span> <span class="k">to</span> <span class="mi">10</span>
                                        <span class="n">item1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qtablewidgetitem</span><span class="p">(</span><span class="s">&quot;10&quot;</span><span class="p">)</span>
                                        <span class="n">setitem</span><span class="p">(</span><span class="n">x</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span><span class="n">y</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span><span class="n">item1</span><span class="p">)</span>
                                <span class="k">next</span>
                        <span class="k">next</span>
                <span class="p">}</span>
                <span class="n">btn1</span> <span class="o">=</span> <span class="k">new</span> <span class="n">qPushButton</span><span class="p">(</span><span class="n">win1</span><span class="p">)</span> <span class="p">{</span>
                        <span class="n">setText</span><span class="p">(</span><span class="s">&quot;Increase&quot;</span><span class="p">)</span>
                        <span class="n">setGeometry</span><span class="p">(</span><span class="mi">510</span><span class="p">,</span><span class="mi">10</span><span class="p">,</span><span class="mi">100</span><span class="p">,</span><span class="mi">30</span><span class="p">)</span>
                        <span class="n">setClickEvent</span><span class="p">(</span><span class="s">&quot;pClick()&quot;</span><span class="p">)</span>
                <span class="p">}</span>
                <span class="n">show</span><span class="p">()</span>
        <span class="p">}</span>
        <span class="n">exec</span><span class="p">()</span>
<span class="p">}</span>

<span class="k">func</span> <span class="n">pClick</span>
        <span class="k">for</span> <span class="n">nRow</span> <span class="o">=</span> <span class="mi">0</span> <span class="k">to</span> <span class="n">Table1</span><span class="p">.</span><span class="n">rowcount</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span>
                <span class="k">for</span> <span class="n">nCol</span> <span class="o">=</span> <span class="mi">0</span> <span class="k">to</span> <span class="n">Table1</span><span class="p">.</span><span class="n">columncount</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span>
                        <span class="n">Table1</span><span class="p">.</span><span class="n">item</span><span class="p">(</span><span class="n">nRow</span><span class="p">,</span><span class="n">nCol</span><span class="p">)</span>  <span class="p">{</span>
                                <span class="k">if</span> <span class="n">isSelected</span><span class="p">()</span>
                                        <span class="n">setText</span><span class="p">(</span> <span class="s">&quot;&quot;</span> <span class="o">+</span> <span class="p">(</span> <span class="mi">10</span> <span class="o">+</span> <span class="n">text</span><span class="p">())</span> <span class="p">)</span>
                                <span class="k">ok</span>
                        <span class="p">}</span>
                <span class="k">next</span>
        <span class="k">next</span>
</pre></div>
</div>
</div>
<div class="section" id="which-of-3-coding-styles-are-commonly-used-or-recommended-by-the-community">
<span id="index-56"></span><h2>Which of 3 coding styles are commonly used or recommended by the community?<a class="headerlink" href="#which-of-3-coding-styles-are-commonly-used-or-recommended-by-the-community" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><dl class="simple">
<dt>Just select any style of them but don’t mix between the different styles in the same project</dt><dd><p>or at least in the same context (Implementation, Tests, Scripts, etc)</p>
</dd>
</dl>
</li>
</ol>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>State the rules in the start of each project and follow it.</p>
</div>
<ol class="arabic simple" start="2">
<li><p>You can create your style (by changing keywords) - The idea is about customization and freedom.</p></li>
</ol>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>It’s better to change keywords and create new style only for a clear reason like using another natural  language (Arabic, French, etc.)</p>
</div>
<ol class="arabic" start="3">
<li><dl class="simple">
<dt>The First style is better (IMHO) for questions, tutorials and small applications/programs (Less than 5,000 LOC)</dt><dd><p>Example : Ring Book, Most of Ring Samples and Applications.</p>
</dd>
</dl>
</li>
<li><p>The Third style is better(IMHO) for large applications and mainstream programmers</p>
<blockquote>
<div><p>Example (Form Designer) : <a class="reference external" href="https://github.com/ring-lang/ring/tree/master/tools/formdesigner">https://github.com/ring-lang/ring/tree/master/tools/formdesigner</a></p>
</div></blockquote>
</li>
</ol>
</div>
</div>


           </div>
           
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="sourcecode.html" class="btn btn-neutral float-right" title="Building From Source Code" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
      
      
        <a href="codeeditors.html" class="btn btn-neutral float-left" title="Using Other Code Editors" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <p>
        
        &copy; Copyright 2016-2021, Ring Team

    </p>
  </div>
    
    
    Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
    
    <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
    
    provided by <a href="https://readthedocs.org">Read the Docs</a>. 

</footer>

        </div>
      </div>

    </section>

  </div>
  

  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(false);
      });
  </script>

  
</body>
</html>