pydicom.values.convert_text(byte_string: bytes, encodings: Optional[List[str]] = None, vr: Optional[str] = None) Union[str, MutableSequence[str]][source]

Return a decoded text VR value.

Text VRs are ‘SH’, ‘LO’ and ‘UC’.

  • byte_string (bytes) – The encoded text VR element value.

  • encodings (list of str, optional) – A list of the character encoding schemes used to encode the value.

  • vr (str) – The value representation of the element. Needed for validation.


The decoded value(s).

Return type

str or list of str