String Operations

The following functions manipulate and manage string data:

ARRAY ASSIGN	Assign a number of values to successive elements of an array.
ARRAY DELETE	Delete a single item from a given array.
ARRAY INSERT	Insert a single item into a given array.
ARRAY SCAN	Scan all or part of an array for a given value.
ARRAY SORT	Sort all or part of a given array.
BIN$	Return a string with the binary (base 2) representation of a value.
BITS$	Copies string contents without modification.
BUILD$	Concatenate multiple strings with high efficiency.
CHOOSE$	Return one of several values, based upon the value of an index.
CHR$	Convert one or more character codes into ASCII character(s).
CHR$$	Convert one or more character codes into Unicode character(s).
CHRBYTES	Determine the size of a single character in a string variable.
CHRTOOEM$	Translates a string of ANSI/WIDE characters to OEM byte characters
ChrToUtf8$	Translates a string of ANSI/WIDE characters to UTF-8 byte characters.
CLIP$	Deletes characters from a string.
CLSID$	Return a 16-byte (128-bit) GUID string containing a CLSID.
COMM LINE	Receive a CR/LF terminated "line" of data from a serial port.
COMM PRINT	Send a "line" of binary data through a serial port.
COMM RECV	Receive binary data from a serial port.
COMM SEND	Send a string of binary data through a serial port.
COMMAND$	Return the command-line used to start the program.
CSET	Center a string within the space of another string or UDT.
CSET$	Return a string containing a centered (padded) string.
CURDIR$	Return the current directory for a given drive.
DATA	Declare an array of constants to be read by READ$.
DATACOUNT	Return the total count of the number of local data items.
DATE$	Set and retrieve the system date.
DEC$	Convert an integral value to a decimal string.
DIM	Declare and dimension arrays, scalar variables, and pointers.
DIR$	Return a filename that matches the given mask.
DIR$ CLOSE	Force the release the operating system FindNext handle.
ENVIRON	Modify the current program's environment table.
ENVIRON$	Retrieve strings from the operating system's environment table.
ERASE	Deallocate array memory.
ERL$	Return the last label, line number, or procedure name executed prior to the most recent error.
ERROR$	Return a string containing the descriptive name of an error.
EXTRACT$	Return up to the first occurrence of a specified character.
EXE	Return the path and/or name of the executing program.
FIELD	Bind a field string to a file buffer or dynamic string variable.
FIELD RESET	Reset the FIELD string to a nul (zero-length) dynamic string.
FIELD STRING	Change the FIELD string to a dynamic string, but first assigns the current sub-section data to it.
FILENAME$	Return the file-system name of an open file.
FORMAT$	Return a string containing formatted numeric data.
FUNCNAME$	Return the name of the current Sub/Function.
GET	Read a record from a random-access file.
GET$	Reads an ANSI string from a file opened in binary mode.
GET$$	Reads WIDE string data from a file opened in binary mode.
GRAPHIC SPLIT	Splits a string into two parts for display on a graphic target.
GUID$	Return a 16-byte (128-bit) Globally Unique Identifier GUID.
GUIDTXT$	Return a 38-byte human-readable GUID/UUID string.
HEX$	Hexadecimal (base 16) string representation of an argument.
IIF$	Return one of two values based upon a True/False evaluation.
INKEY$	Read a keyboard or mouse event from the console input buffer.
INPUT#	Load variables with data from a sequential file.
INSTR	Search a string for the first occurrence of a character or string.
ISNOTNULL	Determine if a string is not nul (contains 1 or more characters).
ISNULL	Determine if a string is nul (zero-length).
IStringBuilderA.Add	Appends an ANSI string to the object.
IStringBuilderA.Capacity <Get>	Retrieves the size of the internal buffer.
IStringBuilderA.Capacity <Set>	Sets the size of the internal buffer.
IStringBuilderA.Char <Get>	Returns the numeric character code of the character at the specified position.
IStringBuilderA.Char <Set>	Changes the numeric character code of the character at the specified position.
IStringBuilderA.Clear	All data in the object is erased.
IStringBuilderA.Delete	Deletes a specified number of characters starting at a specified position.
IStringBuilderA.Insert	Inserts a string at a specified position.
IStringBuilderA.Len	Returns the number of characters stored in the object.
IStringBuilderA.String	The ANSI string stored in the object is returned to the caller.
IStringBuilderW.Add	Appends an WIDE string to the object.
IStringBuilderW.Capacity <Get>	Retrieves the size of the internal buffer.
IStringBuilderW.Capacity <Set>	Sets the size of the internal buffer.
IStringBuilderW.Char <Get>	Returns the numeric character code of the character at the specified position.
IStringBuilderW.Char <Set>	Changes the numeric character code of the character at the specified position.
IStringBuilderW.Clear	All data in the object is erased.
IStringBuilderW.Delete	Deletes a specified number of characters starting at a specified position.
IStringBuilderW.Insert	Inserts a string at a specified position.
IStringBuilderW.Len	Returns the number of characters stored in the object.
IStringBuilderW.String	The WIDE string stored in the object is returned to the caller.
JOIN$	Return a string consisting of all of the strings in a string array.
LCASE$	Return a lowercase version of a string argument.
LEFT$	Return the left-most n characters of a string.
LEN	Return the logical length of a variable, UDT, or Union.
LET	Assign a string or string array to a Variant.
LINE INPUT	Read an entire line from the keyboard into a string variable.
LINE INPUT#	Read line(s) from a sequential file into a string variable or array.
LPRINT	Output text and data to a printer device.
LPRINT$	Return the current printer device used for LPRINT operations.
LSET	Left-align a string within the space of another string or UDT.
LSET$	Return a string containing a left-justified (padded) string.
LTRIM$	Return a string with leading characters or strings removed.
MAX$	Return the argument with the largest (maximum) value.
MCASE$	Return a mixed case version of a string argument.
MID$	Return a portion of a string.
MID$	Replace characters in a string with characters from another string.
MIN$	Return the argument with the smallest (minimum) value.
MKBYT$	Convert a Byte value into a binary encoded string.
MKCUR$	Convert a Currency value into a binary encoded string.
MKCUX$	Convert an Extended Currency value into a binary encoded string.
MKD$	Convert a Double-precision value into a binary encoded string.
MKDWD$	Convert a Double-word value into a binary encoded string.
MKE$	Convert an Extended-precision value into a binary encoded string.
MKI$	Convert a integral value into a binary encoded string.
MKL$	Convert a Long-integer value into a binary encoded string.
MKQ$	Convert a Quad-integer value into a binary encoded string.
MKS$	Convert a Single-precision value into a binary encoded string.
MKWRD$	Convert a Word value into a binary encoded string.
MKDIR	Create a subdirectory/folder (like the DOS MKDIR command).
NUL$	Return a string containing a specified number of $NUL characters.
OBJRESULT$	Returns a string which describes an OBJRESULT (hResult) code.
OCT$	Return a string that is a octal (base 8) representation of a value.
OemToChr$	Translates a byte string of OEM characters into ANSI/WIDE characters.
PARSE	Parse a string and extract all delimited fields into an array.
PARSE$	Return a delimited field from a string expression.
PARSECOUNT	Return the count of delimited fields in a string expression.
PATHNAME$	Parse a path/file name to extract component parts.
PATHSCAN$	Find a file on disk and return the path and/or file name parts.
PEEK$	Returns consecutive 1-byte characters starting at a specific memory location.
PEEK$$	Returns consecutive 2-byte wide characters starting at a specific memory location.
POKE$	Store a sequence of bytes starting at a specific memory location.
POKE$$	Store a sequence as 2-byte wide characters starting at a specific memory location.
PRINT	Write data to the current console text page (screen).
PRINT#	Write a complete array to a sequential file.
PROGID$	Return the alphanumeric PROGID string (text) of a given CLSID.
PUT	Write a record to a random-access file or variable to a binary file.
PUT$	Writes an ANSI string to a file opened in binary mode.
PUT$$	Writes a WIDE Unicode string to a file opened in binary mode.
READ$	Retrieve string data from a local DATA list.
RE GEXPR	Scan a string for a matching "wildcard" or regular expression.
REGREPL	Scan a "wildcard" match in a string with a new string.
REMAIN$	Returns the portion of a string which follows the first occurrence of a character or group of characters.
REMOVE$	Return a copy of a string with characters or strings removed.
REPEAT$	Return a string consisting of multiple copies of a specified string.
REPLACE	Replace all occurrences of one string with another string.
RESET	Clear a string, string array subscript, or an entire array.
RESOURCE$	Returns predefined resource data.
RETAIN$	Return a string with all non-specified characters removed.
RIGHT$	Return the rightmost n characters of a string.
RSET	Right justify a string into the space of a string variable or UDT.
RSET$	Return a string containing a right-justified (padded) string.
RTRIM$	Return a copy of a string with trailing characters/strings removed.
SHRINK$	Shrinks a string to use a consistent single character delimiter.
SIZEOF	Return the total or physical length of any PowerBASIC variable.
SPACE$	Return a string consisting of a specified number of spaces.
SPLIT	Splits a string into two parts.
STR$	Return the string representation of a number in printable form.
STRDELETE$	Delete a specified number of characters from a string expression.
STRING$	Returns a ANSI string consisting of multiple copies of a specified character.
STRING$$	Returns a WIDE string consisting of multiple copies of a specified character.
STRINSERT$	Insert a string at a specified position within another string.
STRPTR	Return the address of the data held by a variable length string.
STRREVERSE$	Reverse the contents of a string expression.
SWAP	Exchange the values of two strings, pointers, or pointer targets.
SWITCH$	Return one item of a series based upon a True/False evaluation.
TAB$	Return a string with TAB characters expanded with spaces.
TALLY	Count the number of occurrences of specified characters/strings.
TIME$	Read and/or set the system time.
TRIM$	Return a string with leading and trailing characters removed.
TYPE SET	Assign the value of a UDT or string expression to a UDT.
UCASE$	Return an all-uppercase (capitalized) version of a string.
UCODE$	Translate an ANSI string into a Unicode string.
UCODEPAGE	Set the default codepage used for ANSI / UNICODE conversions.
UNWRAP$	Removes paired characters from the beginning and end of a string.
USING$	Format string/numeric expressions using a mask string.
Utf8ToChr$	Translates a byte string of OEM characters into ANSI/WIDE characters.
VAL function	Return the numeric equivalent of a string argument.
VAL statement	Converts a text string to a numeric value with additional information.
VARIANT$	Return the ANSI dynamic string contained in a Variant variable.
VARIANT$$	Return the Unicode dynamic string contained in a Variant variable.
VARPTR	Return the 32-bit address of a string handle.
VERIFY	Determine if each character of a string is in another string.
WAITKEY$	Read a character or mouse event from the console input buffer.
WRAP$	Adds paired characters to the beginning and end of a string.