Package convex.core.data

Class Strings

java.lang.Object

convex.core.data.Strings

public class Strings
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final StringShort	BACKDATED_BLOCK
static final StringShort	BAD_FORMAT
static final StringShort	BAD_SIGNATURE
static final StringShort	COLON
static final StringShort	EMPTY
static final Ref<StringShort>	EMPTY_REF
static final byte	EXCESS_BYTE	Byte value used for looking outside a String 0xff (-1) is invalid UTF-8
static final StringShort	FALSE
static final StringShort	HEX_PREFIX
static final StringShort	ILLEGAL_BLOCK_SIZE
static final StringShort	INSUFFICIENT_STAKE
static final int	MAX_ENCODING_LENGTH
static final StringShort	MISORDERED_BLOCK
static final StringShort	MISSING_PEER
static final StringShort	NIL
static final StringShort	NO_SUCH_ACCOUNT
static final StringShort	NO_TX_FOR_ACTOR
static final StringShort	OLD_SEQUENCE
static final StringShort	SERVER_LOADED
static final StringShort	TRUE
static final StringShort	WRONG_KEY

Constructor Summary

Constructors

Constructor	Description
Strings()

Method Summary

Modifier and Type	Method	Description
static AString	appendAll(AString[] strs)
static AString	create(ABlob b)
static AString	create(CVMChar c)
static AString	create(String s)	Create a canonical CVM String from a regular Java String
static StringShort	empty()
static AString	fromHex(String hexString)	Constructs a UTF-8 CVM String from raw hex digits.
static CharsetDecoder	getDecoder()
static AString	join(ASequence<AString> ss, AString separator)	Creates a string by joining a sequence of substrings with the given separator
static AString	join(ASequence<AString> ss, CVMChar separator)	Creates a String by joining a sequence of substrings with the given separator
static AString	read(Blob blob, int offset)	Reads a String from a Blob encoding.

Methods inherited from class java.lang.Object

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

Field Details

EMPTY

public static final StringShort EMPTY

EMPTY_REF

public static final Ref<StringShort> EMPTY_REF

NIL

public static final StringShort NIL

TRUE

public static final StringShort TRUE

FALSE

public static final StringShort FALSE

BAD_SIGNATURE

public static final StringShort BAD_SIGNATURE

BAD_FORMAT

public static final StringShort BAD_FORMAT

SERVER_LOADED

public static final StringShort SERVER_LOADED

COLON

public static final StringShort COLON

HEX_PREFIX

public static final StringShort HEX_PREFIX

MAX_ENCODING_LENGTH

public static final int MAX_ENCODING_LENGTH

EXCESS_BYTE

public static final byte EXCESS_BYTE

Byte value used for looking outside a String 0xff (-1) is invalid UTF-8

See Also:

• Constant Field Values

MISSING_PEER

public static final StringShort MISSING_PEER

INSUFFICIENT_STAKE

public static final StringShort INSUFFICIENT_STAKE

ILLEGAL_BLOCK_SIZE

public static final StringShort ILLEGAL_BLOCK_SIZE

BACKDATED_BLOCK

public static final StringShort BACKDATED_BLOCK

MISORDERED_BLOCK

public static final StringShort MISORDERED_BLOCK

NO_SUCH_ACCOUNT

public static final StringShort NO_SUCH_ACCOUNT

NO_TX_FOR_ACTOR

public static final StringShort NO_TX_FOR_ACTOR

WRONG_KEY

public static final StringShort WRONG_KEY

OLD_SEQUENCE

public static final StringShort OLD_SEQUENCE

Constructor Details

Strings

public Strings()

Method Details

read

public static AString read(Blob blob,
 int offset)
                    throws BadFormatException

Reads a String from a Blob encoding.

Parameters:

blob - Blob to read from

offset - Offset within blob

Returns:

String instance

Throws:

BadFormatException - If any problem with encoding

create

public static AString create(String s)

Create a canonical CVM String from a regular Java String

Parameters:

s - Java String to convert.

Returns:

CVM String instance.

create

public static AString create(CVMChar c)

join

public static AString join(ASequence<AString> ss,
 AString separator)

Creates a string by joining a sequence of substrings with the given separator

Parameters:

ss - Sequence of Strings to join

separator - any String to use as a separator.

Returns:

Concatenated String, including the separator. Will return the empty string if the seqence is empty.

join

public static AString join(ASequence<AString> ss,
 CVMChar separator)

Creates a String by joining a sequence of substrings with the given separator

Parameters:

ss - Sequence of Strings to join

separator - any CVM Character to use as a separator.

Returns:

Concatenated String, including the separator. Will return the empty string if the sequence is empty.

create

public static AString create(ABlob b)

fromHex

public static AString fromHex(String hexString)

Constructs a UTF-8 CVM String from raw hex digits. This does not perform checking of valid UTF: It is possible to construct bad strings this way. This is allowable on the CVM, and useful for testing.

Parameters:

hexString - String containing hex digits

Returns:

New CVM String (possibly not valid UTF)

empty

public static StringShort empty()

getDecoder

public static CharsetDecoder getDecoder()

appendAll

public static AString appendAll(AString[] strs)