string_functions.zh

Functions

int	NumCharsOf(char32[] ptr, char32 chr)
int	NumCharsOf(char32[] ptr, int pos, char32 chr)
bool	isControlCode(char32 chr)
bool	isNumber(char32 chr)
bool	isAlphabetic(char32 chr)
bool	isAlphaNumeric(char32 chr)
bool	isHex(char32 chr)
bool	isUpperCase(char32 chr)
bool	isLowerCase(char32 chr)
bool	isSpace(char32 chr)
bool	isVowel(char32 chr)
bool	ContainsChar(char32 chr, char32[] buffer)
int	ContainsCharPos(char32 chr, char32[] buffer)
bool	ContainsChar(char32 chr, int pos, char32[] buffer)
int	ContainsCharPos(char32 chr, int pos, char32[] buffer)
char32	UpperToLower(char32 chr)
char32	LowerToUpper(char32 chr)
char32	ConvertCase(char32 chr)
void	memset(untyped[] ptr, int pos, untyped value, int n)
void	memset(untyped[] ptr, untyped value, int n)
void	memcpy(untyped[] dest, int dpos, untyped[] src, int spos, int n)
void	memcpy(untyped[] dest, untyped[] src, int n)
void	memcpy(untyped[] dest, untyped[] src)
untyped	memmove(untyped[] dest, int dpos, untyped[] src, int spos, int n)
void	arrayset(untyped[] a, untyped[] args, untyped varargs …)
void	strcpy(int[] dest, int dpos, int[] src, int spos)
void	strncpy(int[] dest, int dpos, int[] src, int spos, int n)
void	strncpy(int[] dest, int[] src, int n)
void	remchr(char32[] ptr, int pos)
void	remchr(char32[] ptr)
void	remnchr(char32[] ptr, int pos, int n)
void	strcat(int[] dest, int[] src, int spos)
void	strncat(int[] dest, int[] src, int spos, int n)
void	strncat(int[] dest, int[] src, int n)
int	strchr(char32[] ptr, int pos, char32 chr)
int	strrchr(char32[] ptr, int pos, char32 chr)
int	strstr(char32[] ptr, int pos, char32[] sub)
int	strspn(char32[] ptr, int pos, char32[] keys)
int	strcspn(char32[] ptr, int pos, char32[] keys)
int	strcmp(char32[] ptr1, int pos1, char32[] ptr2, int pos2)
int	strncmp(char32[] ptr1, int pos1, char32[] ptr2, int pos2, int n)
int	atoi(char32[] ptr, int pos)
int	ilen(char32[] ptr, int pos)
int	xtoi(char32[] ptr, int pos)
int	xlen(char32[] ptr, int pos = 0)
int	atof(char32[] ptr, int pos = 0)
int	flen(char32[] ptr, int pos = 0)
int	aton(char32[] ptr, int pos = 0)
int	nlen(char32[] ptr, int pos = 0)
int	itoa(char32[] ptr, int pos, int num)
int	xtoa(char32[] ptr, int pos, int num, bool upper)
int	xtoa(char32[] ptr, int num, bool upper)
int	ftoa(char32[] ptr, int pos, int num, bool printall)
int	ftoa(char32[] ptr, int num, bool printall)
int	ftoa(char32[] ptr, int pos, int num)
int	ftoa(char32[] ptr, int num)
int	ntoa(char32[] ptr, int pos, int num)
int	ntoa(char32[] ptr, int num)
void	strcatf(int[] dest, untyped arg, int format)
void	strncatf(int[] dest, untyped arg, int format, int n)
bool	sprintf_isMFCode(char32 chr)
int	sprintf_MFCodeToInt(char32 chr)
int	ReturnStringCharPos(char32[] ptr, char32 chr)
int	ReturnStringCharPos(char32[] ptr, int pos, char32 chr)
int	ReturnStringCharPosRev(char32[] ptr, char32 chr)
int	ReturnStringCharPosRev(char32[] ptr, int pos, char32 chr)
char32	IsChar(char32 chr)
bool	IsChar(char32 chr, char32 comp)
void	ScreenPrint(char32[] s, untyped v, int[] args)
int	strcmp(char32[] ptr1, char32[] ptr2)
int	strncmp(char32[] ptr1, char32[] ptr2, int n)
int	strlen(char32[] ptr)
void	strcpy(char32[] dest, char32[] src)
int	atoi(char32[] ptr)
void	strcat(char32[] dest, char32[] src)
int	strchr(char32[] ptr, char32 chr)
int	strrchr(char32[] ptr, char32 chr)
int	strspn(char32[] ptr, char32[] keys)
int	strcspn(char32[] ptr, char32[] keys)
int	strstr(char32[] ptr, char32[] sub)
int	ilen(char32[] ptr)
int	xtoi(char32[] ptr)
int	itoa(char32[] ptr, int num)
int	xtoa(char32[] ptr, int num)
int	sprintf(char32[] ret, char32[] formatstr, int a0 = 0, int a1 = 0, int a2 = 0, int a3 = 0, int a4 = 0, int a5 = 0, int a6 = 0, int a7 = 0, int a8 = 0, int a9 = 0, int aa = 0, int ab = 0, int ac = 0, int ad = 0, int ae = 0, int af = 0) deprecated
void	printf(char32[] formatstr, int a0 = 0, int a1 = 0, int a2 = 0, int a3 = 0, int a4 = 0, int a5 = 0, int a6 = 0, int a7 = 0, int a8 = 0, int a9 = 0, int aa = 0, int ab = 0, int ac = 0, int ad = 0, int ae = 0, int af = 0) deprecated

Function descriptions

int NumCharsOf(char32[] ptr, char32 chr) 🔗 Source

ZScript string handling functions, akin to those found in C Returns the number of chracters of a given type in a specified string.

---

int NumCharsOf(char32[] ptr, int pos, char32 chr) 🔗 Source

---

bool isControlCode(char32 chr) 🔗 Source

Single character functions Returns true if ‘chr’ is in the control code range of ascii characters

---

bool isNumber(char32 chr) 🔗 Source

Returns true if ‘chr’ is in the range of ascii characters ‘0’ to ‘9’

---

bool isAlphabetic(char32 chr) 🔗 Source

Returns true if ‘chr’ is an alphabetic character

---

bool isAlphaNumeric(char32 chr) 🔗 Source

Returns true if ‘chr’ is an alphanumeric character

---

bool isHex(char32 chr) 🔗 Source

Returns true if ‘chr’ is in the set { ‘0’-‘9’, ‘A’-‘F’ , ‘a’-‘f’ }

---

bool isUpperCase(char32 chr) 🔗 Source

Returns true if ‘chr’ is an upper-case character

---

bool isLowerCase(char32 chr) 🔗 Source

Returns true if ‘chr’ is a lower-case character

---

bool isSpace(char32 chr) 🔗 Source

Retruns true if a ‘chr’ is a blank space.

---

bool isVowel(char32 chr) 🔗 Source

Returns true if ‘chr’ is a vowel.

---

bool ContainsChar(char32 chr, char32[] buffer) 🔗 Source

Returns true if the string contains a specific character.

---

int ContainsCharPos(char32 chr, char32[] buffer) 🔗 Source

Returns first character position if the string contains a specific character, else -1.

---

bool ContainsChar(char32 chr, int pos, char32[] buffer) 🔗 Source

Returns true if the string contains a specific character.

---

int ContainsCharPos(char32 chr, int pos, char32[] buffer) 🔗 Source

Returns first character position if the string contains a specific character, else -1.

---

char32 UpperToLower(char32 chr) 🔗 Source

Converts all upper case characters to lower case, leaving non-alphabetic characters unchanged

---

char32 LowerToUpper(char32 chr) 🔗 Source

Converts all lower case characters to upper case, leaving non-alphabetic characters unchanged

---

char32 ConvertCase(char32 chr) 🔗 Source

Converts lower case to upper case and upper case to lower case

---

void memset(untyped[] ptr, int pos, untyped value, int n) 🔗 Source

Memory Manipulation Memory Set Sets block of memory of size ‘n’ pointed by ‘ptr’ to ‘value’

---

void memset(untyped[] ptr, untyped value, int n) 🔗 Source

---

void memcpy(untyped[] dest, int dpos, untyped[] src, int spos, int n) 🔗 Source

Memory Copy Copys block of memory pointed by ‘src’ of size ‘n’ to ‘dest’

---

void memcpy(untyped[] dest, untyped[] src, int n) 🔗 Source

---

void memcpy(untyped[] dest, untyped[] src) 🔗 Source

---

untyped memmove(untyped[] dest, int dpos, untyped[] src, int spos, int n) 🔗 Source

Memory Move As memcpy, but uses a buffer so memory space can overlap

---

void arrayset(untyped[] a, untyped[] args, untyped varargs …) 🔗 Source

Array Set Assign all elements of array.

---

void strcpy(int[] dest, int dpos, int[] src, int spos) 🔗 Source

String Manipulation String Copy Copys string ‘src’ into string ‘dest’ without checking for overflow in ‘dest’

---

void strncpy(int[] dest, int dpos, int[] src, int spos, int n) 🔗 Source

As strcpy, but only takes the first ‘n’ characters from src

---

void strncpy(int[] dest, int[] src, int n) 🔗 Source

---

void remchr(char32[] ptr, int pos) 🔗 Source

Remove Characters Remove all characters starting from pointer ‘string’

---

void remchr(char32[] ptr) 🔗 Source

---

void remnchr(char32[] ptr, int pos, int n) 🔗 Source

Remove ‘n’ characters and shift string back to pointer ‘string’

---

void strcat(int[] dest, int[] src, int spos) 🔗 Source

String Concatenate Appends string ‘src’ onto string ‘dest’ (assuming dest has enough extra memory allocated to allow the operation)

---

void strncat(int[] dest, int[] src, int spos, int n) 🔗 Source

strcat up to ‘n’ characters in src

---

void strncat(int[] dest, int[] src, int n) 🔗 Source

---

int strchr(char32[] ptr, int pos, char32 chr) 🔗 Source

String Searching String Character Returns the position of the first occurence of ‘character’ in ‘string’, or -1 if none are found

---

int strrchr(char32[] ptr, int pos, char32 chr) 🔗 Source

String Reverse Character Returns the position of the last occurence of ‘character’ in ‘string’ starting from the end, or -1 if none are found

---

int strstr(char32[] ptr, int pos, char32[] sub) 🔗 Source

String Sub-String Returns the position of the first occurence of sub-string ‘sub’ in ‘string’, or -1 if sub is not found

---

int strspn(char32[] ptr, int pos, char32[] keys) 🔗 Source

String Span Returns the length of characters in ‘ptr’ before a character not contained in ‘keys’ is found

---

int strcspn(char32[] ptr, int pos, char32[] keys) 🔗 Source

String Complement Span Returns the length of characters in ‘ptr’ before a character contained in ‘keys’ is found

---

int strcmp(char32[] ptr1, int pos1, char32[] ptr2, int pos2) 🔗 Source

String Comparison String Compare Iterates through ptr1 and ptr2 until a character is found which is not the same in both strings, and then returns > 0 if the character is larger in ptr1, and < 0 if it is larger in ptr2. Returns 0 if the strings are equal

---

int strncmp(char32[] ptr1, int pos1, char32[] ptr2, int pos2, int n) 🔗 Source

strcmp up to ‘n’ characters

---

int atoi(char32[] ptr, int pos) 🔗 Source

Converting between variables and strings ASCII to Integer Returns the decimal integer pointed by ‘string’

---

int ilen(char32[] ptr, int pos) 🔗 Source

Integer Length Returns the length of characters of the decimal integer pointed by ‘string’

---

int xtoi(char32[] ptr, int pos) 🔗 Source

Hexadecimal ASCII to Integer Returns the (positive) hexadecimal integer pointed by ‘string’

---

int xlen(char32[] ptr, int pos = 0) 🔗 Source

Hexadecimal Length Returns the length of characters of the (positive) hexadecimal integer pointed by ‘string’

---

int atof(char32[] ptr, int pos = 0) 🔗 Source

ASCII to Float Returns the floating point number pointed by ‘string’

---

int flen(char32[] ptr, int pos = 0) 🔗 Source

Float Length Returns the length of characters of the floating point number pointed by ‘string’

---

int aton(char32[] ptr, int pos = 0) 🔗 Source

ASCII to Number Calls either atoi or atof depending on context

---

int nlen(char32[] ptr, int pos = 0) 🔗 Source

Number Length Calls either flen or ilen depending on context

---

int itoa(char32[] ptr, int pos, int num) 🔗 Source

Integer to ASCII Places integer ‘num’ into string ‘string’ without checking for overflow, and returns the number of characters used

---

int xtoa(char32[] ptr, int pos, int num, bool upper) 🔗 Source

Hexadecimal Integer to ASCII Places integer ‘num’ into string ‘string’ in base 16 without checking for overflow, and returns the number of characters used

---

int xtoa(char32[] ptr, int num, bool upper) 🔗 Source

---

int ftoa(char32[] ptr, int pos, int num, bool printall) 🔗 Source

Float to ASCII Places float ‘num’ into string ‘string’ without checking for overflow, and returns the number of characters used. If ‘printall’ is true, it will add 4 decimal places regardless of the most significant digit

---

int ftoa(char32[] ptr, int num, bool printall) 🔗 Source

---

int ftoa(char32[] ptr, int pos, int num) 🔗 Source

---

int ftoa(char32[] ptr, int num) 🔗 Source

---

int ntoa(char32[] ptr, int pos, int num) 🔗 Source

Number to ASCII Checks whether ‘num’ is an integer or not, and calls the appropriate function

---

int ntoa(char32[] ptr, int num) 🔗 Source

---

void strcatf(int[] dest, untyped arg, int format) 🔗 Source

String Formating String Concatenate Format Appends ‘arg’ onto ‘dest’ as the MF_ constant passed into ‘format’

---

void strncatf(int[] dest, untyped arg, int format, int n) 🔗 Source

As strcatf, using only ‘n’ characters of ‘arg’

---

bool sprintf_isMFCode(char32 chr) 🔗 Source

Used by sprintf

---

int sprintf_MFCodeToInt(char32 chr) 🔗 Source

---

int ReturnStringCharPos(char32[] ptr, char32 chr) 🔗 Source

---

int ReturnStringCharPos(char32[] ptr, int pos, char32 chr) 🔗 Source

---

int ReturnStringCharPosRev(char32[] ptr, char32 chr) 🔗 Source

---

int ReturnStringCharPosRev(char32[] ptr, int pos, char32 chr) 🔗 Source

---

char32 IsChar(char32 chr) 🔗 Source

---

bool IsChar(char32 chr, char32 comp) 🔗 Source

---

void ScreenPrint(char32[] s, untyped v, int[] args) 🔗 Source

Prints a formatted string to the screen. int v can be a string, a float, or an int and is inserted to the string using the tokens %s, %f, and %d respectively. int args is an array literal with the following format required: { LAYER, X, Y, FONT, TEXT_COLOUR, TEXT_BG_COLOUR, FORMAT, OPCITY }

---

int strcmp(char32[] ptr1, char32[] ptr2) 🔗 Source

Now an internal function. -Z ( 15th May, 2019 )

---

int strncmp(char32[] ptr1, char32[] ptr2, int n) 🔗 Source

Now an internal function. -Z ( 15th May, 2019 )

---

int strlen(char32[] ptr) 🔗 Source

Internal as of 2.55 Alpha 23, 15th may, 2019 String Length Returns the length of string ‘string’

---

void strcpy(char32[] dest, char32[] src) 🔗 Source

---

int atoi(char32[] ptr) 🔗 Source

---

void strcat(char32[] dest, char32[] src) 🔗 Source

---

int strchr(char32[] ptr, char32 chr) 🔗 Source

---

int strrchr(char32[] ptr, char32 chr) 🔗 Source

---

int strspn(char32[] ptr, char32[] keys) 🔗 Source

---

int strcspn(char32[] ptr, char32[] keys) 🔗 Source

---

int strstr(char32[] ptr, char32[] sub) 🔗 Source

---

int ilen(char32[] ptr) 🔗 Source

---

int xtoi(char32[] ptr) 🔗 Source

---

int itoa(char32[] ptr, int num) 🔗 Source

---

int xtoa(char32[] ptr, int num) 🔗 Source

---

int sprintf(char32[] ret, char32[] formatstr, int a0 = 0, int a1 = 0, int a2 = 0, int a3 = 0, int a4 = 0, int a5 = 0, int a6 = 0, int a7 = 0, int a8 = 0, int a9 = 0, int aa = 0, int ab = 0, int ac = 0, int ad = 0, int ae = 0, int af = 0) 🔗 Source

Prints string ‘formatstr’ into ‘ret’ according to the arguments inputted (see C function for reference) Maximum 16 arguments

Warning

Deprecated! Use the internal sprintf() instead.

---

void printf(char32[] formatstr, int a0 = 0, int a1 = 0, int a2 = 0, int a3 = 0, int a4 = 0, int a5 = 0, int a6 = 0, int a7 = 0, int a8 = 0, int a9 = 0, int aa = 0, int ab = 0, int ac = 0, int ad = 0, int ae = 0, int af = 0) 🔗 Source

Uses a buffer to print the results of sprintf(formatstr,…) straight to allegro.log

Warning

Deprecated! Use the internal printf() instead.