Core Function DotNet

From Sputnik Wiki
Jump to: navigation, search 
%Name

Contents

Description

Create/use .NET objects and call instance/static method and get/set properties.

Sputnik is made in C# and C# is a .NET language.

Sputnik keeps all the .NET stuff hidden away and out of view and provides its own functions and features for you to use.

However if you wish to use something from .NET Sputnik has a special operator that lets you do that.

You can use the % operator with an Identifier to specify the creation/use of a .NET class see the examples below.

This .NET object support is by no means complete it is never meant to be 100% since if you wanted 100% you wouldn't be using Sputnik however it is good enough to provide a layer of support should you think Sputnik is missing something that can be provided by something within the .NET library.

Of course you can look into DLLImport() (To call functions within DLLs and WinAPIs etc) to extend Sputniks feature set should you think something is missing.

As for .NET DLLs you will have to specify them with Use() and create the objects using the % operator.

Remarks

This is to be considered experimental it may cause crashes/slowness or may give weird errors with no real information on what the hell just happened or even where it happened.

It will get better over time but for now it is useable as shown in the examples.

To use .NET stuff you must first define where the object in question can be found in .NET you do that using the use() function.

Then you can create the object using the % opeator.

The .NET objects you create support their operator overloads such as += *= etc so this makes using .NET classes much easier almost seamless.

If you place a .NET DLL you compiled in C#/VB etc in the Sputnik folder and set the proper information in the Use() function you can then create/use the classes and methods etc in that DLL just like you can with all the examples below.

Alternatively you can use Sputnik to compile (see the function Compile()) some C# code into a DLL and use that instead.

Note - When you use strings it uses Sputnik escapes and not C#/.NET ones (Which is fine since Sputnik has them all anyway and a lot more).

Capabilities & Limitations

This will always contain the current limitations of this stuff for Sputnik it may change over time.

Example

Example of using .NETs Console.WriteLine() function 

use("System");
%Console->WriteLine("Hello World!");
// Prints: Hello World!

Example of using .NETs StringBuilder class 

use("System");
use("System.Text");
//$sb = %StringBuilder->new(100); // We could pre-allocate
$sb = %StringBuilder->new();
$sb->Append("Cat");
$sb->Append("Dog");
 
%Console->WriteLine("StringBuilder Text: " . $sb);
%Console->WriteLine("StringBuilder Length: " . $sb->$Length);
// Prints:
// StringBuilder Text: CatDog
// StringBuilder Length: 6
 
// Now lets edit it
$sb[0] = 'P';
say("Character 0 = " . $sb[0]);
say("Character 3 = " . $sb[3]);
%Console->WriteLine("StringBuilder Text: " . $sb);
%Console->WriteLine("StringBuilder Length: " . $sb->$Length);
// Prints
// Character 0 = P
// Character 3 = D
// StringBuilder Text: PatDog
// StringBuilder Length: 6

Example of using .NETs Static Environment class 

use("System");
$CurDir = %Environment->$CurrentDirectory;
echo "CurDir is: $CurDir\n";

Example of using .NETs Point Class 

use("System.Drawing");
 
$a = %Point->new(2, 4);
say($a->ToString());
$a->$X = 77;
$a->$Y = 20;
say( "Value is: " . $a->$X );
say( "Value is: " . $a->$Y );
// Prints:
// {X=2,Y=4}
// Value is: 77
// Value is: 20

Example of using .NETs Char[] 

use("System");
 
$chars = %Char[]->new(3);
$chars[0] = 'A';
$chars[1] = 'B';
$chars[2] = 'C';
printf("Char is: %s\n", $chars[0]);
printf("Char is: %s\n", $chars[1]);
printf("Char is: %s\n", $chars[2]);
$str = %String->new($chars);
printf("String: %s\n", $str);
// Finally make a .NET String from the Char[]
$a = %String->new($chars);
printf("String value is %s\n", $a);
printf("StringLen value is %d\n", $a->$Length);
// Prints
// Char is: A
// Char is: B
// Char is: C
// String: ABC
// String value is ABC
// StringLen value is 3
Retrieved from "http://ubersoft.org/Sputnik/wiki/index.php/Core_Function_DotNet"
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox