pydicom.values.convert_text

pydicom.values.convert_text(byte_string: bytes, encodings: list[str] | None = None, vr: str | None = None) str | MutableSequence[str][source]

Return a decoded text VR value.

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

Parameters:
  • 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.

Returns:

The decoded value(s).

Return type:

str or list of str