com.scriptbasic.utility.functions

Class StringFunctions

java.lang.Object

com.scriptbasic.utility.functions.StringFunctions

public class StringFunctions
extends Object

This class implements string functions for the BASIC interpreter. Most of the methods implement a wrapper for the method of the same name in the class java.lang.String. These methods in the class java.lang.String are not static and therefore need a String object to work on. The wrapper methods are static and take the first argument as the String object to work on. In other words if in Java you would write

 s.xyz(parameterlist)
 

to call the method xyz() then in BASIC you will be able to call

 xyz(s, parameterlist)
 

The documentation of the methods implemented in java.langString are not repeared here. Other methods, that implement BASIC like string functions not implemented in the class java.lang.String are documented in this class.

Author:

Peter Verhas

Constructor Summary

Constructors

Constructor and Description
StringFunctions()

Method Summary

Methods

Modifier and Type	Method and Description
static String	charAt(String s1, int i) Returns a one character string that contains the character that is at the position i in the string s1.
static String	chomp(String s) Chop off the new line character(s) from the end of the string.
static int	codePointAt(String s1, int i)
static int	codePointBefore(String s1, int i)
static int	codePointCount(String s1, int i, int j)
static int	compareTo(String s1, String s2)
static int	compareToIgnoreCase(String s1, String s2)
static boolean	contains(String s1, String s2)
static boolean	endsWith(String s1, String s2)
static Long	index(String s1, String s2) Implements the functionality of the method s1.indexOf(s2)
static Long	indexAfter(String s1, String s2, int i) Implements the functionality of the method s1.indexOf(s2,i)
static boolean	isEmpty(String s1)
static Long	lastIndex(String s1, String s2) Implements the functionality of the method s1.lastIndexOf(s2)
static Long	lastIndexAfter(String s1, String s2, int i) Implements the functionality of the method s1.lastIndexOf(s2,i)
static String	lcase(String s) Return a string lower cased.
static String	ltrim(String s) Trim the white spaces from the start of the string.
static String	mid(String s, int start, int len) Return a substring from the string that starts at the position start and has a length of len.
static String	replaceAll(String s1, String regex, String s2)
static String	replaceFirst(String s1, String regex, String s2)
static String	right(String s, int len) Return len number of characters from the right (the end) of the string.
static String	rtrim(String s) Trim the white spaces from the end of the string.
static String	space(int len) Return a string that is len number of space characters.
static boolean	startsWith(String s1, String s2)
static String	string(int len, String s) Return a string that is len times the character in s.
static int	strlen(String s1)
static String	strreverse(String s) Return a string with the characters reversed.
static String	trim(String s)
static String	ucase(String s) Return a string upper cased.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StringFunctions

public StringFunctions()

Method Detail

chomp

public static String chomp(String s)

Chop off the new line character(s) from the end of the string. If there are more than one new line character at the end of the string then all of them are cut off.

If there are no new line characters at the end of the string then the unaltered string is returned.

Parameters:

s - the string to chomp

Returns:

the string without the trailing new lines

ltrim

public static String ltrim(String s)

Trim the white spaces from the start of the string.

Parameters:

s - the string to trim.

Returns:

the trimmed string

rtrim

public static String rtrim(String s)

Trim the white spaces from the end of the string.

Parameters:

s - the string to trim

Returns:

the trimmed string

mid

public static String mid(String s,
         int start,
         int len)

Return a substring from the string that starts at the position start and has a length of len.

Parameters:

s -

start -

len -

Returns:

right

public static String right(String s,
           int len)

Return len number of characters from the right (the end) of the string.

Parameters:

s -

len -

Returns:

space

public static String space(int len)

Return a string that is len number of space characters.

Parameters:

len -

Returns:

string

public static String string(int len,
            String s)

Return a string that is len times the character in s. If the string s contains more than one characters then only the first character is repeated.

Parameters:

len -

s -

Returns:

strreverse

public static String strreverse(String s)

Return a string with the characters reversed.

Parameters:

s -

Returns:

ucase

public static String ucase(String s)

Return a string upper cased.

Parameters:

s -

Returns:

lcase

public static String lcase(String s)

Return a string lower cased.

Parameters:

s -

Returns:

trim

public static String trim(String s)

index

public static Long index(String s1,
         String s2)

Implements the functionality of the method s1.indexOf(s2)

Parameters:

s1 -

s2 -

Returns:

lastIndex

public static Long lastIndex(String s1,
             String s2)

Implements the functionality of the method s1.lastIndexOf(s2)

Parameters:

s1 -

s2 -

Returns:

indexAfter

public static Long indexAfter(String s1,
              String s2,
              int i)

Implements the functionality of the method s1.indexOf(s2,i)

Parameters:

s1 -

s2 -

i -

Returns:

lastIndexAfter

public static Long lastIndexAfter(String s1,
                  String s2,
                  int i)

Implements the functionality of the method s1.lastIndexOf(s2,i)

Parameters:

s1 -

s2 -

i -

Returns:

charAt

public static String charAt(String s1,
            int i)

Returns a one character string that contains the character that is at the position i in the string s1.

Parameters:

s1 -

i -

Returns:

replaceAll

public static String replaceAll(String s1,
                String regex,
                String s2)

replaceFirst

public static String replaceFirst(String s1,
                  String regex,
                  String s2)

strlen

public static int strlen(String s1)

Parameters:

s1 -

Returns:

the length of the string

codePointAt

public static int codePointAt(String s1,
              int i)

codePointBefore

public static int codePointBefore(String s1,
                  int i)

codePointCount

public static int codePointCount(String s1,
                 int i,
                 int j)

compareTo

public static int compareTo(String s1,
            String s2)

compareToIgnoreCase

public static int compareToIgnoreCase(String s1,
                      String s2)

contains

public static boolean contains(String s1,
               String s2)

endsWith

public static boolean endsWith(String s1,
               String s2)

startsWith

public static boolean startsWith(String s1,
                 String s2)

isEmpty

public static boolean isEmpty(String s1)