Package convex.core.data

Class AString

java.lang.Object
convex.core.data.AObject
convex.core.data.ACell
convex.core.data.ACountable<CVMChar>
convex.core.data.AString
All Implemented Interfaces:
IValidated, IWriteable, Comparable<AString>
Direct Known Subclasses:
StringShort, StringSlice, StringTree
public abstract class AString extends ACountable<CVMChar> implements Comparable<AString>
Class representing a CVM String

  • Field Details

    • length

      protected long length

  • Constructor Details

    • AString

      protected AString​(long length)

  • Method Details

    • getType

      public AType getType()
      Description copied from class: ACell
      Gets the most specific known runtime Type for this Cell.
      Overrides:
      getType in class ACell
      Returns:
      The Type of this Call

    • print

      public boolean print​(BlobBuilder sb, long limit)
      Description copied from class: AObject
      Prints this Object to a readable String Representation
      Specified by:
      print in class AObject
      Parameters:
      sb - StringBuilder to append to
      limit - Limit of printing in string bytes
      Returns:
      True if fully printed, false otherwise

    • count

      public long count()
      Description copied from class: ACountable
      Returns the number of elements in this data structure
      Specified by:
      count in class ACountable<CVMChar>
      Returns:
      Number of elements in this collection.

    • empty

      public StringShort empty()

    • charAt

      public abstract int charAt​(long i)
      Gets the Unicode character at position i, or -1 if not valid
      Parameters:
      i - Index into String (byte position)
      Returns:
      Unicode code point, or -1 if not a valid code point at this position

    • intAt

      public int intAt​(long index)
      Gets 32 bytes integer at given position. Extends with 255 (invalid UTF-8) if needed
      Parameters:
      index - Index into String (byte position)
      Returns:
      Raw integer value

    • byteAt

      public abstract byte byteAt​(long i)
      Gets a byte at the specified index. Returns -1 (0xff) if outside String.
      Parameters:
      i - Index into String (byte position)
      Returns:
      Raw byte value

    • get

      public CVMChar get​(long i)
      Description copied from class: ACountable
      Gets the element at the specified index in this collection
      Specified by:
      get in class ACountable<CVMChar>
      Parameters:
      i - Index of element to get
      Returns:
      Element at the specified index

    • getElementRef

      public Ref<CVMChar> getElementRef​(long i)
      Description copied from class: ACountable
      Gets a Ref to the element at the specified index in this collection
      Specified by:
      getElementRef in class ACountable<CVMChar>
      Parameters:
      i - Index of element to get
      Returns:
      Element at the specified index

    • compareTo

      public abstract int compareTo​(AString o)
      Specified by:
      compareTo in interface Comparable<AString>

    • toString

      public final String toString()
      Description copied from class: ACell
      Returns the Java String representation of this Cell. The String representation is intended to be a easy-to-read textual representation of the Cell's data content.
      Overrides:
      toString in class ACell

    • toCVMString

      public AString toCVMString​(long limit)
      Description copied from class: ACell
      Returns the CVM String representation of this Cell. Normally, this is as printed, but may be different for some types. MUST return null in O(1) time if the length of the CVM String would exceed limit. The String representation is intended to be a easy-to-read textual representation of the Cell's data content.
      Overrides:
      toCVMString in class ACell
      Parameters:
      limit - Limit of CVM String length in UTF-8 bytes
      Returns:
      CVM String, or null if limit exceeded by too much

    • append

      public AString append​(AString b)
      Append a CVM String to this CVM String. Potentially O(n). Concatenates raw UTF-8 bytes.
      Parameters:
      b - String to append
      Returns:
      Concatenated String

    • writeToBuffer

      protected abstract void writeToBuffer​(ByteBuffer bb)

    • subSequence

      public abstract AString subSequence​(long start, long end)

    • encode

      public int encode​(byte[] bs, int pos)
      Description copied from class: ACell
      Writes this Cell's encoding to a byte array, including a tag byte which will be written first. Cell must be canonical, or else an error may occur.
      Specified by:
      encode in interface IWriteable
      Specified by:
      encode in class ACell
      Parameters:
      bs - A byte array to which to write the encoding
      pos - The offset into the byte array
      Returns:
      New position after writing

    • encodeRaw

      public abstract int encodeRaw​(byte[] bs, int pos)
      Encode the data of this String. Assumes tag already written
      Specified by:
      encodeRaw in class ACell
      Parameters:
      bs - A byte array to which to write the encoding
      pos - The offset into the byte array
      Returns:
      New position after writing

    • encodeRawData

      public abstract int encodeRawData​(byte[] bs, int pos)
      Encode the raw UTF-8 data of this String. Assumes tag/length already written
      Parameters:
      bs - Byte array to encode to
      pos - Position in target array to write to
      Returns:
      End position in array after encoding

    • getTag

      public final byte getTag()
      Description copied from class: ACell
      Gets the tag byte for this cell. The tag byte is always written as the first byte of the Cell's Encoding
      Specified by:
      getTag in class ACell
      Returns:
      Tag byte for this Cell

    • hashCode

      public final int hashCode()
      Gets a Java hashCode for this CVM String. Use the hashcode of underlying Blob
      Overrides:
      hashCode in class ACell
      Returns:
      integer hash code.

    • toBlob

      public abstract ABlob toBlob()
      Converts this String to a Blob byte representation. Must round trip all values.
      Returns:
      Blob representation of UTF-8 String

    • append

      public AString append​(String string)
      Convenience method to add a Java String to a CVM String. Not particularly efficient.
      Parameters:
      string - String to append
      Returns:
      CVM String