Utilities

Utilities

SplashKit provides some basic data manipulation functions to help make it easy to get some basic tasks performed.SplashKit random provides a simple implementation of random.SplashKit provides miscellaneous utilities for unclassified functionality.

Utilities Guides

Using Utilities Examples & Guides

Functions

Convert To Double

Convert the passed in string into a double. This can fail in an error if the value is not a number, consider using Is Number to check before converting a string.

Parameters

Name	Type	Description
text	String	The text to convert.

Return Type - Double

Signatures

C++

double convert_to_double(const string &text)

C#

public static double Utilities.ConvertToDouble(string text);
public static double SplashKit.ConvertToDouble(string text);

Python

def convert_to_double(text):

Pascal

function ConvertToDouble(const text: String): Double

---

Convert To Integer

Convert the passed in string into an integer. This can fail in an error if the value is not an integer, consider using Is Integer to check before converting a string.

Parameters

Name	Type	Description
text	String	The text to convert.

Return Type - Integer

Signatures

C++

int convert_to_integer(const string &text)

C#

public static int Utilities.ConvertToInteger(string text);
public static int SplashKit.ConvertToInteger(string text);

Python

def convert_to_integer(text):

Pascal

function ConvertToInteger(const text: String): Integer

---

Is Double

Checks if a string contains a number.

Parameters

Name	Type	Description
text	String	The text to check.

Return Type - Boolean

Signatures

C++

bool is_double(const string &text)

C#

public static bool Utilities.IsDouble(string text);
public static bool SplashKit.IsDouble(string text);

Python

def is_double(text):

Pascal

function IsDouble(const text: String): Boolean

---

Is Integer

Checks if a string contains an integer value.

Parameters

Name	Type	Description
text	String	The text to check.

Return Type - Boolean

Signatures

C++

bool is_integer(const string &text)

C#

public static bool Utilities.IsInteger(string text);
public static bool SplashKit.IsInteger(string text);

Python

def is_integer(text):

Pascal

function IsInteger(const text: String): Boolean

---

Is Number

Checks if a string contains a number.

Parameters

Name	Type	Description
text	String	The text to check.

Return Type - Boolean

Signatures

C++

bool is_number(const string &text)

C#

public static bool Utilities.IsNumber(string text);
public static bool SplashKit.IsNumber(string text);

Python

def is_number(text):

Pascal

function IsNumber(const text: String): Boolean

---

To Lowercase

Return a lowercase version of the passed in string.

Parameters

Name	Type	Description
text	String	The text to convert.

Return Type - String

Signatures

C++

string to_lowercase(const string &text)

C#

public static string Utilities.ToLowercase(string text);
public static string SplashKit.ToLowercase(string text);

Python

def to_lowercase(text):

Pascal

function ToLowercase(const text: String): String

---

To Uppercase

Return a UPPERCASE version of the passed in string.

Parameters

Name	Type	Description
text	String	The text to convert.

Return Type - String

Signatures

C++

string to_uppercase(const string &text)

C#

public static string Utilities.ToUppercase(string text);
public static string SplashKit.ToUppercase(string text);

Python

def to_uppercase(text):

Pascal

function ToUppercase(const text: String): String

---

Trim

Return a new string that removes the spaces from the start and end of the input string.

Parameters

Name	Type	Description
text	String	The string to trim.

Return Type - String

Signatures

C++

string trim(const string &text)

C#

public static string Utilities.Trim(string text);
public static string SplashKit.Trim(string text);

Python

def trim(text):

Pascal

function Trim(const text: String): String

---

Rnd

Note

This function is overloaded. The following versions exist:

• Rnd (min: int, max: int, )
• Rnd ()
• Rnd (ubound: int, )

Rnd

Generates a random number between ‘min’ and max, including ‘min’ and ‘max’.

Parameters

Name	Type	Description
min	Integer	the Integer representing of minimum bound.
max	Integer	the Integer representing of maximum bound.

Return Type - Integer

Signatures

C++

int rnd(int min, int max)

C#

public static int Random.Rnd(int min, int max);
public static int SplashKit.Rnd(int min, int max);

Python

def rnd_range(min, max):

Pascal

function Rnd(min: Integer; max: Integer): Integer

---

Rnd

Generates a random number between 0 and 1

Return Type - Float

Signatures

C++

float rnd()

C#

public static float Random.Rnd();
public static float SplashKit.Rnd();

Python

def rnd():

Pascal

function Rnd(): Single

---

Rnd

Generates a random number between 0 and ubound.

Parameters

Name	Type	Description
ubound	Integer	the Integer representing the upper bound.

Return Type - Integer

Signatures

C++

int rnd(int ubound)

C#

public static int Random.Rnd(int ubound);
public static int SplashKit.Rnd(int ubound);

Python

def rnd_int(ubound):

Pascal

function Rnd(ubound: Integer): Integer

---

Current Ticks

Gets the number of milliseconds that have passed since the program was started.

Return Type - undefined

Signatures

C++

unsigned int current_ticks()

C#

public static uint Utilities.CurrentTicks();
public static uint SplashKit.CurrentTicks();

Python

def current_ticks():

Pascal

function CurrentTicks(): Cardinal

---

Delay

Puts the program to sleep for a specified number of milliseconds. If this is larger than 1 second, SplashKit will check to see if the user tries to quit during the delay. If the user does quit, the delay function returns without waiting.

Parameters

Name	Type	Description
milliseconds	Integer	The number of milliseconds to wait

Signatures

C++

void delay(int milliseconds)

C#

public static void Utilities.Delay(int milliseconds);
public static void SplashKit.Delay(int milliseconds);

Python

def delay(milliseconds):

Pascal

procedure Delay(milliseconds: Integer)

---

Display Dialog

Display a dialog to the screen with a message for the user.

Parameters

Name	Type	Description
title	String	The title of the dialog window.
msg	String	The message for the dialog window.
output_font	Font	The font for the dialog text
font_size	Integer	The size of the font for the dialog text

Signatures

C++

void display_dialog(const string &title, const string &msg, font output_font, int font_size)

C#

public static void Utilities.DisplayDialog(string title, string msg, Font outputFont, int fontSize);
public static void SplashKit.DisplayDialog(string title, string msg, Font outputFont, int fontSize);

Python

def display_dialog(title, msg, output_font, font_size):

Pascal

procedure DisplayDialog(const title: String; const msg: String; outputFont: Font; fontSize: Integer)

---

File As String

Return a SplashKit resource of Resource Kind with name filename as a string.

Parameters

Name	Type	Description
filename	String	The filename of the resource.
kind	Resource Kind	The kind of resource.

Return Type - String

Signatures

C++

string file_as_string(string filename, resource_kind kind)

C#

public static string Utilities.FileAsString(string filename, ResourceKind kind);
public static string SplashKit.FileAsString(string filename, ResourceKind kind);

Python

def file_as_string(filename, kind):

Pascal

function FileAsString(filename: String; kind: ResourceKind): String

---