gnu.iou
Class chbuf

java.lang.Object
  |
  +--gnu.iou.chbuf

public class chbuf

extends java.lang.Object

String oriented character buffer used by `utf8' and others.

Author:

John Pritchard (john@syntelos.org)

Field Summary

static java.lang.String

line_separator

Constructor Summary

chbuf()

chbuf(char ch_head, java.lang.String[] text, char ch)
Append the argument character after each array element, but not the last.

chbuf(int initsz)

chbuf(java.lang.Object obj)

chbuf(java.lang.String[] text)
Append a SPACE character after each array element, but not the last.

chbuf(java.lang.String[] text, char ch)
Append the argument character after each array element, but not the last.

Method Summary

chbuf	append(boolean truf) Uses "true" and "false".
chbuf	append(boolean[] ary) Uses "true" and "false".
chbuf	append(byte b) Calls on String.valueOf.
chbuf	append(byte[] ary) Calls on String.valueOf.
chbuf	append(char ch)
chbuf	append(char[] ary) Appends the characters, followed by the`token_infix' character when defined.
chbuf	append(char[] cary, int ofs, int len)
chbuf	append(double d) Calls on String.valueOf.
chbuf	append(double[] ary) Calls on String.valueOf.
chbuf	append(float f) Calls on String.valueOf.
chbuf	append(float[] ary) Calls on String.valueOf.
chbuf	append(int i) Calls on String.valueOf.
chbuf	append(int[] ary) Calls on String.valueOf.
chbuf	append(long l) Calls on String.valueOf.
chbuf	append(long[] ary) Calls on String.valueOf.
chbuf	append(java.lang.Object o) Calls on Object.toString.
chbuf	append(java.lang.Object[] oary) In support of autogenerated source use of chbuf in 'toString'.
chbuf	append(short s) Calls on String.valueOf.
chbuf	append(short[] ary) Calls on String.valueOf.
chbuf	append(java.lang.String s)
chbuf	append(java.lang.String[] ary) Appends each element, followed by the`token_infix' character when defined.
void	appendMany(char ch, int many) Repeat `ch' into this buffer `many' times.
int	capacity()
static char[]	cat(char[] a, char[] b) Concatenate two character arrays
static char[]	cat(char[] a, char[] b, char[] c) Concatenate three character arrays
static char[]	cat(char[] a, char[] b, int bofs, int blen) Concatenate two character arrays
static java.lang.String	cat(java.lang.String a, char[] bcary) Concatenate two character arrays
static java.lang.String	cat(java.lang.String a, char[] bcary, int bofs, int blen) Concatenate two character arrays
static java.lang.String	cat(java.lang.String a, java.lang.String b) Concatenate two strings.
static java.lang.String	cat(java.lang.String a, java.lang.String b, char[] ccary) Concatenate three strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, char[] ccary, int ccary_ofs, int ccary_len) Concatenate three strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, java.lang.String c) Concatenate three strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, java.lang.String c, java.lang.String d) Concatenate four strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, java.lang.String c, java.lang.String d, java.lang.String e) Concatenate five strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, java.lang.String c, java.lang.String d, java.lang.String e, java.lang.String f) Concatenate six strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, java.lang.String c, java.lang.String d, java.lang.String e, java.lang.String f, java.lang.String g) Concatenate seven strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, java.lang.String c, java.lang.String d, java.lang.String e, java.lang.String f, java.lang.String g, java.lang.String h) Concatenate eight strings
static java.lang.String	cat(java.lang.String a, java.lang.String b, java.lang.String c, java.lang.String d, java.lang.String e, java.lang.String f, java.lang.String g, java.lang.String h, java.lang.String i) Concatenate nine strings
char	charAt(int idx)
static char[]	copy(char[] valc)
static int	decode_int(java.lang.String s) Accept hex, octal and decimal number strings using traditional string formatting: "0x", "0X" and "#" prefixes for hexidecimal, "0" for octal and otherwise presume decimal.
static long	decode_long(java.lang.String s) Accept hex, octal and decimal number strings using traditional string formatting: "0x", "0X" and "#" prefixes for hexidecimal, "0" for octal and otherwise presume decimal.
chbuf	delete(int start, int end)
chbuf	deleteCharAt(int idx)
void	ensureCapacity(int min)
static java.lang.String	fcat(java.lang.String a, java.lang.String b) Concatenate two file or url path strings, guaranteeing exactly one url path separator ("/") between each string.
static int	indexOf(char[] str, char ch)
static int	indexOf(char[] str, char[] term)
static int	indexOf(char[] str, char[] term, int fromidx)
chbuf	insert(int idx, char ch)
chbuf	insert(int idx, java.lang.String s)
static int	lastIndexOf(char[] str, char ch)
int	length() Content length.
char[]	popBuf() Return buffer and reset.
char[]	popBuf(int many) Similar to popChar, reset back "many" characters for using `chbuf' like a stream buffer.
char	popChar() Read one character from the buffer and reset to previous character for overwriting the popped character.
chbuf	prepend(char ch) Inserts character at head of buffer, maintains content.
void	println()
void	println(char ch)
void	println(java.lang.String s)
void	reset() Discard content, reuse buffer.
void	setCharAt(int idx, char ch)
void	setLength(int len) Typically used to truncate the string.
static char[]	substring(char[] cary, int idx)
static char[]	substring(char[] cary, int from_idx, int to_idx)
static java.lang.String	toBinaryString(int ln) Return 32 characters in ASCII `1' or `0' representing input number.
static java.lang.String	toBinaryString(long ln) Return 64 characters in ASCII `1' or `0' representing input number.
byte[]	toByteArray()
char[]	toCary() Returns null for an empty buffer.
static char[]	toCharArray(java.lang.Object[] oary)
void	token_infix(char ch) Set a character to separate strings appended or printed into this buffer.
java.lang.String	toString() Returns null for an empty buffer.
static java.lang.String	toString(java.lang.Object obj)
static java.lang.String	toString(java.lang.Object[] oary)

Methods inherited from class java.lang.Object

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

Field Detail

line_separator

public static final java.lang.String line_separator

Constructor Detail

chbuf

public chbuf()

chbuf

public chbuf(int initsz)

chbuf

public chbuf(java.lang.Object obj)

chbuf

public chbuf(java.lang.String[] text)

Append a SPACE character after each array element, but not the last.

chbuf

public chbuf(java.lang.String[] text,
             char ch)

Append the argument character after each array element, but not the last.

Parameters:

text - Source

ch - Source string delimeter

chbuf

public chbuf(char ch_head,
             java.lang.String[] text,
             char ch)

Append the argument character after each array element, but not the last.

Parameters:

text - Source

ch_head - Source string head

ch - Source string delimeter

Method Detail

token_infix

public void token_infix(char ch)

Set a character to separate strings appended or printed into this buffer. Characters appended or prepended to this buffer will not be prefixed with the token infix character.

Set this to zero, or a negative value, to disable the token infix process.

Disabled by default.

prepend

public chbuf prepend(char ch)

Inserts character at head of buffer, maintains content.

append

public chbuf append(char ch)

charAt

public char charAt(int idx)

setCharAt

public void setCharAt(int idx,
                      char ch)

delete

public chbuf delete(int start,
                    int end)

deleteCharAt

public chbuf deleteCharAt(int idx)

insert

public chbuf insert(int idx,
                    char ch)

insert

public chbuf insert(int idx,
                    java.lang.String s)

ensureCapacity

public void ensureCapacity(int min)

capacity

public int capacity()

setLength

public void setLength(int len)

Typically used to truncate the string. Can be used to expand the string with null characters.

appendMany

public void appendMany(char ch,
                       int many)

Repeat `ch' into this buffer `many' times.

println

public void println(java.lang.String s)

println

public void println()

println

public void println(char ch)

append

public chbuf append(java.lang.String s)

append

public chbuf append(char[] cary,
                    int ofs,
                    int len)

append

public chbuf append(java.lang.Object o)

Calls on Object.toString.

append

public chbuf append(java.lang.Object[] oary)

In support of autogenerated source use of chbuf in 'toString'.

append

public chbuf append(java.lang.String[] ary)

Appends each element, followed by the`token_infix' character when defined.

append

public chbuf append(char[] ary)

Appends the characters, followed by the`token_infix' character when defined.

append

public chbuf append(boolean truf)

Uses "true" and "false".

append

public chbuf append(byte b)

Calls on String.valueOf.

append

public chbuf append(short s)

Calls on String.valueOf.

append

public chbuf append(int i)

Calls on String.valueOf.

append

public chbuf append(long l)

Calls on String.valueOf.

append

public chbuf append(float f)

Calls on String.valueOf.

append

public chbuf append(double d)

Calls on String.valueOf.

append

public chbuf append(boolean[] ary)

Uses "true" and "false".

append

public chbuf append(byte[] ary)

Calls on String.valueOf.

append

public chbuf append(short[] ary)

Calls on String.valueOf.

append

public chbuf append(int[] ary)

Calls on String.valueOf.

append

public chbuf append(long[] ary)

Calls on String.valueOf.

append

public chbuf append(float[] ary)

Calls on String.valueOf.

append

public chbuf append(double[] ary)

Calls on String.valueOf.

toCary

public char[] toCary()

Returns null for an empty buffer. Doesn't reset the buffer, but allows continuation.

See Also:

reset()

toByteArray

public byte[] toByteArray()

toString

public java.lang.String toString()

Returns null for an empty buffer.

Overrides:

toString in class java.lang.Object

length

public int length()

Content length.

reset

public void reset()

Discard content, reuse buffer.

popChar

public char popChar()

Read one character from the buffer and reset to previous character for overwriting the popped character.

popBuf

public char[] popBuf(int many)

Similar to popChar, reset back "many" characters for using `chbuf' like a stream buffer.

Parameters:

many - Return "many", or fewer characters.

popBuf

public char[] popBuf()

Return buffer and reset.

toCharArray

public static final char[] toCharArray(java.lang.Object[] oary)

toString

public static final java.lang.String toString(java.lang.Object[] oary)

toString

public static final java.lang.String toString(java.lang.Object obj)

cat

public static final char[] cat(char[] a,
                               char[] b)

Concatenate two character arrays

cat

public static final char[] cat(char[] a,
                               char[] b,
                               int bofs,
                               int blen)

Concatenate two character arrays

cat

public static final char[] cat(char[] a,
                               char[] b,
                               char[] c)

Concatenate three character arrays

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b)

Concatenate two strings. (This is faster than using the string concatenation operator in Java programming which results in a StringBuffer object allocation and its synchronized use at runtime.)

cat

public static final java.lang.String cat(java.lang.String a,
                                         char[] bcary)

Concatenate two character arrays

cat

public static final java.lang.String cat(java.lang.String a,
                                         char[] bcary,
                                         int bofs,
                                         int blen)

Concatenate two character arrays

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         java.lang.String c)

Concatenate three strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         char[] ccary)

Concatenate three strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         char[] ccary,
                                         int ccary_ofs,
                                         int ccary_len)

Concatenate three strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         java.lang.String c,
                                         java.lang.String d)

Concatenate four strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         java.lang.String c,
                                         java.lang.String d,
                                         java.lang.String e)

Concatenate five strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         java.lang.String c,
                                         java.lang.String d,
                                         java.lang.String e,
                                         java.lang.String f)

Concatenate six strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         java.lang.String c,
                                         java.lang.String d,
                                         java.lang.String e,
                                         java.lang.String f,
                                         java.lang.String g)

Concatenate seven strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         java.lang.String c,
                                         java.lang.String d,
                                         java.lang.String e,
                                         java.lang.String f,
                                         java.lang.String g,
                                         java.lang.String h)

Concatenate eight strings

cat

public static final java.lang.String cat(java.lang.String a,
                                         java.lang.String b,
                                         java.lang.String c,
                                         java.lang.String d,
                                         java.lang.String e,
                                         java.lang.String f,
                                         java.lang.String g,
                                         java.lang.String h,
                                         java.lang.String i)

Concatenate nine strings

fcat

public static final java.lang.String fcat(java.lang.String a,
                                          java.lang.String b)

Concatenate two file or url path strings, guaranteeing exactly one url path separator ("/") between each string.

substring

public static final char[] substring(char[] cary,
                                     int idx)

substring

public static final char[] substring(char[] cary,
                                     int from_idx,
                                     int to_idx)

indexOf

public static final int indexOf(char[] str,
                                char ch)

indexOf

public static final int indexOf(char[] str,
                                char[] term)

indexOf

public static final int indexOf(char[] str,
                                char[] term,
                                int fromidx)

lastIndexOf

public static final int lastIndexOf(char[] str,
                                    char ch)

copy

public static final char[] copy(char[] valc)

decode_long

public static final long decode_long(java.lang.String s)
                              throws java.lang.NumberFormatException

Accept hex, octal and decimal number strings using traditional string formatting: "0x", "0X" and "#" prefixes for hexidecimal, "0" for octal and otherwise presume decimal.

decode_int

public static final int decode_int(java.lang.String s)
                            throws java.lang.NumberFormatException

Accept hex, octal and decimal number strings using traditional string formatting: "0x", "0X" and "#" prefixes for hexidecimal, "0" for octal and otherwise presume decimal.

toBinaryString

public static final java.lang.String toBinaryString(long ln)

Return 64 characters in ASCII `1' or `0' representing input number.

toBinaryString

public static final java.lang.String toBinaryString(int ln)

Return 32 characters in ASCII `1' or `0' representing input number.