The greatest programming language to ever bless this Earth!

Have you ever had to worry, or even consider what datatype a variable is that you declared decades ago? Let that worry wash away! Strang makes all datatypes string!

This programming language is the closest you can get to perfection in the world!!

Download Interpreter:

Latest release here

Table Of Contents:

• Supported Datatypes
• Declaration
• Debugging
• String Literals
• Basic Arithmetic
• Basic Operators
• Naming
• Operators
• Selection
• Loops
• Functions
• Installation
• Conclusion

Supported Datatypes:

Here is an extensive list of all datatypes Strang supports:

• string

The very mention of other datatypes will make string jealous, so I will 'whisper' other datatypes.

Declaration:

Declaring a variable is as easy as using the let keyword. You cannot have 'null' variables, so you must assign the variable to a value.

let variable = "value";

There are no constant variables, so all variables are mutable. To change the value of a variable, do not use let!

let test = "Lorem";
test = "Ipsum";

Debugging

In Strang, the ? keyword is used for logging.

let test = "test";
?test; //test

The more ? you use, the more severe the debug log will be.

?"I LOVE STRANG";                //[LOG] I LOVE STRANG
??"WE ALL LOVE STRANG";          //[WARNING] WE ALL LOVE STRANG
???"IT'S POWER IS TOO GREAT!!!"; //[ERROR] IT'S POWER IS TOO GREAT!!!
// thrown 'IT'S POWER IS TOO GREAT!!!'

For logs of severity WARNING and above, Strang will add info about where the error was found.

01 ??"Where is this problem happening?"
// [WARNING] at line 01
// 'Where is this problem happening?'

String Literals:

Most programming languages define strings using " quote marks. Some with ' single quote marks. In Strang, you can use any amount of quotation marks, as long as if the start and end quotes add up the same.

'LEGAL'
""LEGAL""
''''LEGAL""
""''"'LEGAL"''"'"

• But if the amount of quotes are mismatched, it is an illegal string definition.

"ILLEGAL'
"ILLEGAL"'

Even no quotation marks! But only when assigning to a variable. All whitespace before the first character are omitted.

let string `= I HAVE NO STRINGS ON ME!;
?string; //I HAVE NO STRINGS ON ME!

Why use var `=? It's actually a simple way for declaring string variables of zero length!

let empty `=;
?empty; //

If you want to define a string using var `= and have the variable start with whitespace, put a \ and Strang will omit all whitespace up to that point.

let string `= \     SO MUCH WHITESPACE;
?string; //     SO MUCH WHITESPACE

Basic Arithmetic

Strang supports all arithmetic operators (+, -, *, /) and uses the string length as an 'integer' value. Arithmetic operations interpret string length using the ! character by convention.

// Addition
let example = "!!" + "!!!";
?example; // !!!!!

// Subtraction
let example = "!!!!!" - "!!";
?example; // !!!

// Multiplication
let example = "!!" * "!!!!";
?example; // !!!!!!!!

// Division
let example = "!!!!!!" / "!!";
?example; // !!!

You can parse a string positive number into a bunch of ! by putting ! after the string.

let ten = "10"!;
?ten; // !!!!!!!!!!

Basic Operators

Although the standard character for arithmetic length is ! you can still use other characters!

// Multiplication
let laugh = "ha" * "123";
?laugh; //hahaha

// Division
let example = "abcdef" / "AB";
?example; //abc

// Addition
let hallo = "Hello " + "World";
?hallo; //Hello World

Subtraction has 2 variants. The - operator acts identically to >-.

• >- Trim End
• -< Trim Start

// Subtraction (same as >-)
let subtract = "abcde" - "!!";
?subtract; //abc

// Trim End
let trimEnd = "HELP ME" >- "!!!";
?trimEnd; //HELP

// Trim Start
let trimStart = "Strang, not C Is Goated" -< "!!!!!!!!!!!!";
?trimStart; //C Is Goated

Naming:

Variables and functions can include digits.

let 5 = "5";
let 2 = "2";
let ans = 5 + 2;

Which makes this result true.

let 10 = "8"!;
let 4 = "4"!;
?4 + 4 == 10; //true

Operators:

Check out all the operator definitions here!

'Int'eger

Strang itself doesn't support the 'int' datatype, but there are still some 'int' operators that use the string length instead.

• "9"! Int Parse

?"6"!; //!!!!!! 

• "target"["!!"] Char Of

?"apple"["!!!"]; //l

String Manipulation

Strang offers plenty of operators for string manipulation, built straight in.

• # Interweave:

?"abc" # "xy"; //axaybxbycxcy

• ^ , ^^ To Lower and To Upper:

?"HIGH"^; //high
?"low"^^; //LOW

• -- , --- Remove Substring and Remove Characters:

?"hello world" -- "lo";  //hel world
?"hello world" --- "lo"; //he wrd

• >- , -< Trim End and Trim Start:

?"abcde" >- "!!";  //abc
?"abcde" -< "!!";  //cde

• % Truncate:

?"ABCDEFGHIJKLMNOP" % "GHI";  //ABCDEF
?"3.14159265" % "15";  //3.14

'Bool'ean Operators

Strang doesn't support the 'boolean' datatype, so Strang uses string literals of "true" and "false".
Unlike most programming languages, Strang much prefers to use, beautiful, juicy words instead of grotesque symbols.

• AND
• OR
• XOR
• XAND

But we like ! to be 'not' instead of NOT. Why? i dont know.

let bobobolo = !"true";
?bobobolo; //false

If you use a 'boolean' operator on a non-'boolean' string, such as TRUTH, instead of throwing, we follow what the best of the best do.
maybe

let what = !"TRUTH";
?what; //maybe

Why stop there?

If you try performing 'boolean' operators on maybe, you get:

?!"maybe"; //possibly

This doesn't stop at possibly! Just like Strang!

?!"maybe"; //possibly
?!"possibly"; //probably
?!"probably"; //probably not
?!"probably not"; //quite frankly
?!"quite frankly"; //could potentially
?!"could potentially"; //okay this is the last one

Who said you could stop at that!

?!"okay this is the last one"; //i lied

Relational Operators

• == Equals (not length)

?"apple" == "apple"; //true
?"apple" == "zebra"; //false

• != Not Equals (not length)

?"apple" != "apple"; //false
?"apple" != "zebra"; //true

• = Loosely Equals (length)

?"apple" = "zebra"; //true
?"3"! = "3"!;       //true
?"6"! = "3"!;       //false

• < , > Less Than and Greater Than (length)

?"banana" > "apple"; //true
?"5"! < "8"!;        //true

• <= , >= (Less Than and Greater Than) Or Equals (length)

?"3"! > "3"!;  //false
?"3"! >= "3"!; //true

Extra Operators

• << , >> Starts With and Ends With

?"banana" << "ba"; //true
?"banana" >> "ba"; //false
?"banana" >> "na"; //true

• ~ Contains

?"hello world" ~ "lo"; //true
?"apple" ~ "z"; //false

Selection

Strang has the if , if...else and if...else if keywords for selection, and expect the conditional to be "true" or "false".

if ("5"! > "2"!)
{
    ?"5 is bigger than 2!";
}
else
{
    ???"how did you manage that";
}

If Strang gets a non-'boolean' string, it will throw. I was considering adding another keyword, like grasp to use for non-'boolean's, and it will probably be implemented in the close future!

Loops

In Strang, the for loop doesn't exist. Our beloved string hates that guy. Instead we have the replacement foreach.
foreach loops through each individual character, and declares the character you currently index at.

let target = "test";
foreach (let c in target)
{
    ?c;
}

//t
//e
//s
//t

We also have while, which acts similarly to if, except it loops. Like most programming languages...

while ("true")
{
    ?"BEWARE THE MAN WHO SPEAKS IN HANDS";
}

Functions

Strang has some built-in functions, which are listed here.

Functions are declared using either of these keywords: func , funcstr

• func doesn't expect a return value,
  
• funcstr expect a return value.

func Test()
{
    ?"you called?";
}

funcstr Destroy()
{
    return "so you have chosen death...";
}

When declaring a function, the function arguments must have the let keyword for each argument.

funcstr Concat(let a, let b)
{
    return a + ' ' + b;
}

Calling the function is as simple as FunctionName() or if the function has arguments,

?Concat("Hello","World");

Installation

To install Strang, download the StrangSetup.zip which contains StrangSetup.exe where then you follow the installation wizard. You should be able to use in a new terminal:

strang help

To run a .strang file, in the terminal, provide the location of the file as the first argument:

strang folder\program.strang

If you do not have a .strang file to execute, you can use the terminal as a text editor

strang --t

strang --terminal

For whatever reason, you can get debug info by inserting --d at the end of the strang command

strang folder\program.strang --d

Conclusion

The best language ever! You should use it for your everyday programming! Convince your boss to switch to Strang now!

Here is a Strang program to help convince your boss to use Strang

let bossName = "[ENTER BOSS NAME]";
let yourName = "[ENTER YOUR NAME]";

?"Hello " + bossName + "!";
?"I have noticed our current programming language, lacks significant and necessary features, to help speed production.";
?"This proposal suggests the solution to our major decline in sales and investors! We don't use new innovate langauges!";
?"Very simple fix, get all your developers to transition into the greatest language ever, Strang!";
?"Kind Regards, " + yourName;

And if you need to prove your point even stronger, spam them!

let bossName = "[ENTER BOSS NAME]";
let yourName = "[ENTER YOUR NAME]";

while ("true")
{
    ?"Hello " + bossName + "!";
    ?"I have noticed our current programming language, lacks significant and necessary features, to help speed production.";
    ?"This proposal suggests the solution to our major decline in sales and investors! We don't use new innovate langauges!";
    ?"Very simple fix, get all your developers to transition into the greatest language ever, Strang!";
    ?"Kind Regards, " + yourName;
}

Extras:

Comments

Strang does have comments, and will ignore what's in it.

// single-line comment
/*
multi-line
comment
*/

If you're previous programming language used octothorpes for comments # , I urge you to get off Python.
// or ELAN

Examples:

To see examples go here

Licensing

Feel free to use, modify, and worship Strang responsibly.

_{The official Strang logo}