Constructor Detail

• TextTagCodec

  public TextTagCodec()

Method Detail

• encode

  public String encode(String tagName,
                       Object value)

  Convert in-memory representation of tag to SAM text representation.

  Parameters:

  tagName - Two-character tag name.

  value - Tag value as approriate Object subclass.

  Returns:

  SAM text String representation, i.e. name:type:value

• encodeUntypedTag

  public String encodeUntypedTag(String tagName,
                                 Object value)

  Encode a standard header tag, which should not have a type field.

  Parameters:

  tagName - 2-character String.

  value - Not necessarily a String. Some of these are integers but the type is implied by the tagName. Converted to String with toString().

  Returns:

  Colon-separated text representation suitable for a SAM header, i.e. name:value.

• decode

  public Map.Entry<String,Object> decode(String tag)

  Convert typed tag in SAM text format (name:type:value) into tag name and Object value representation.

  Parameters:

  tag - SAM text format name:type:value tag.

  Returns:

  Tag name as 2-character String, and tag value in appropriate class based on tag type. If value is an unsigned array, then the value is a TagValueAndUnsignedArrayFlag object.