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.

Functions

Contains

Returns true if the string contains the substring.

Parameters:

Name	Type	Description
text	String	The text to search
subtext	String	The substring to search for

Return Type: Boolean

Signatures:

C++

bool contains(const string &text, const string &subtext)

C#

public static bool Utilities.Contains(string text, string subtext);
public static bool SplashKit.Contains(string text, string subtext);

Python

def contains(text, subtext):

Pascal

function Contains(const text: String; const subtext: String): Boolean

---

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

---

Index Of

Returns the index of the first occurrence of the substring in the text.

Parameters:

Name	Type	Description
text	String	The text to search
subtext	String	The substring to search for

Return Type: Integer

Signatures:

C++

int index_of(const string &text, const string &subtext)

C#

public static int Utilities.IndexOf(string text, string subtext);
public static int SplashKit.IndexOf(string text, string subtext);

Python

def index_of(text, subtext):

Pascal

function IndexOf(const text: String; const subtext: 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

---

Length Of

Returns the length of a string in characters.

Parameters:

Name	Type	Description
text	String	The text to get the length of

Return Type: Integer

Signatures:

C++

int length_of(const string &text)

C#

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

Python

def length_of(text):

Pascal

function LengthOf(const text: String): Integer

---

Replace All

Replace all occurrences of a substring in a string with another string.

Parameters:

Name	Type	Description
text	String	The text to search
substr	String	The substring to find and replace
newText	String	The string to replace the substring with

Return Type: String

Signatures:

C++

string replace_all(const string &text, const string &substr, const string &newText)

C#

public static string Utilities.ReplaceAll(string text, string substr, string newtext);
public static string SplashKit.ReplaceAll(string text, string substr, string newtext);

Python

def replace_all(text, substr, newText):

Pascal

function ReplaceAll(const text: String; const substr: String; const newtext: String): String

---

Split

Split a string into an array of strings based on a delimiter.

Parameters:

Name	Type	Description
text	String	The text to split
delimiter	Char	The character to split the text on

Return Type: Vector

Signatures:

C++

vector<string> split(const string &text, char delimiter)

C#

public static List<string> Utilities.Split(string text, char delimiter);
public static List<string> SplashKit.Split(string text, char delimiter);

Python

def split(text, delimiter):

Pascal

function Split(const text: String; delimiter: Char): ArrayOfString

---

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

---