# pydicom.uid.UID

class pydicom.uid.UID(val: str, validation_mode: int = None)

  Human friendly UIDs as a Python `str` subclass.

  Examples

      >>> from pydicom.uid import UID
      >>> uid = UID('1.2.840.10008.1.2.4.50')
      >>> uid
      '1.2.840.10008.1.2.4.50'
      >>> uid.is_implicit_VR
      False
      >>> uid.is_little_endian
      True
      >>> uid.is_transfer_syntax
      True
      >>> uid.name
      'JPEG Baseline (Process 1)'

  __init__()

  Methods

  `__init__`() |
  `capitalize`() | Return a capitalized version of the string.
  `casefold`() | Return a version of the string suitable for caseless comparisons.
  `center`(width[, fillchar]) | Return a centered string of length width.
  `count` | Return the number of non-overlapping occurrences of substring sub in string S[start:end].
  `encode`([encoding, errors]) | Encode the string using the codec registered for encoding.
  `endswith` | Return True if the string ends with the specified suffix, False otherwise.
  `expandtabs`([tabsize]) | Return a copy where all tab characters are expanded using spaces.
  `find` | Return the lowest index in S where substring sub is found, such that sub is contained within S[start:end].
  `format`(*args, **kwargs) | Return a formatted version of the string, using substitutions from args and kwargs.
  `format_map`(mapping, /) | Return a formatted version of the string, using substitutions from mapping.
  `index` | Return the lowest index in S where substring sub is found, such that sub is contained within S[start:end].
  `isalnum`() | Return True if the string is an alpha-numeric string, False otherwise.
  `isalpha`() | Return True if the string is an alphabetic string, False otherwise.
  `isascii`() | Return True if all characters in the string are ASCII, False otherwise.
  `isdecimal`() | Return True if the string is a decimal string, False otherwise.
  `isdigit`() | Return True if the string is a digit string, False otherwise.
  `isidentifier`() | Return True if the string is a valid Python identifier, False otherwise.
  `islower`() | Return True if the string is a lowercase string, False otherwise.
  `isnumeric`() | Return True if the string is a numeric string, False otherwise.
  `isprintable`() | Return True if all characters in the string are printable, False otherwise.
  `isspace`() | Return True if the string is a whitespace string, False otherwise.
  `istitle`() | Return True if the string is a title-cased string, False otherwise.
  `isupper`() | Return True if the string is an uppercase string, False otherwise.
  `join`(iterable, /) | Concatenate any number of strings.
  `ljust`(width[, fillchar]) | Return a left-justified string of length width.
  `lower`() | Return a copy of the string converted to lowercase.
  `lstrip`([chars]) | Return a copy of the string with leading whitespace removed.
  `maketrans` | Return a translation table usable for str.translate().
  `partition`(sep, /) | Partition the string into three parts using the given separator.
  `removeprefix`(prefix, /) | Return a str with the given prefix string removed if present.
  `removesuffix`(suffix, /) | Return a str with the given suffix string removed if present.
  `replace`(old, new, /[, count]) | Return a copy with all occurrences of substring old replaced by new.
  `rfind` | Return the highest index in S where substring sub is found, such that sub is contained within S[start:end].
  `rindex` | Return the highest index in S where substring sub is found, such that sub is contained within S[start:end].
  `rjust`(width[, fillchar]) | Return a right-justified string of length width.
  `rpartition`(sep, /) | Partition the string into three parts using the given separator.
  `rsplit`([sep, maxsplit]) | Return a list of the substrings in the string, using sep as the separator string.
  `rstrip`([chars]) | Return a copy of the string with trailing whitespace removed.
  `split`([sep, maxsplit]) | Return a list of the substrings in the string, using sep as the separator string.
  `splitlines`([keepends]) | Return a list of the lines in the string, breaking at line boundaries.
  `startswith` | Return True if the string starts with the specified prefix, False otherwise.
  `strip`([chars]) | Return a copy of the string with leading and trailing whitespace removed.
  `swapcase`() | Convert uppercase characters to lowercase and lowercase characters to uppercase.
  `title`() | Return a version of the string where each word is titlecased.
  `translate`(table, /) | Replace each character in the string using the given translation table.
  `upper`() | Return a copy of the string converted to uppercase.
  `zfill`(width, /) | Pad a numeric string with zeros on the left, to fill a field of the given width.

  Attributes

  `info` | Return the UID info from the UID dictionary.
  `is_compressed` | Return `True` if a compressed transfer syntax UID.
  `is_deflated` | Return `True` if a deflated transfer syntax UID.
  `is_encapsulated` | Return `True` if an encasulated transfer syntax UID.
  `is_implicit_VR` | Return `True` if an implicit VR transfer syntax UID.
  `is_little_endian` | Return `True` if a little endian transfer syntax UID.
  `is_private` | Return `True` if the UID isn't an officially registered DICOM UID.
  `is_retired` | Return `True` if the UID is retired, `False` otherwise or if private.
  `is_transfer_syntax` | Return `True` if a transfer syntax UID.
  `is_valid` | Return `True` if self is a valid UID, `False` otherwise.
  `keyword` | Return the UID keyword from the UID dictionary.
  `name` | Return the UID name from the UID dictionary.
  `type` | Return the UID type from the UID dictionary.

  property info: str

    Return the UID info from the UID dictionary.

  property is_compressed: bool

    Return `True` if a compressed transfer syntax UID.

  property is_deflated: bool

    Return `True` if a deflated transfer syntax UID.

  property is_encapsulated: bool

    Return `True` if an encasulated transfer syntax UID.

  property is_implicit_VR: bool

    Return `True` if an implicit VR transfer syntax UID.

  property is_little_endian: bool

    Return `True` if a little endian transfer syntax UID.

  property is_private: bool

    Return `True` if the UID isn’t an officially registered DICOM UID.

  property is_retired: bool

    Return `True` if the UID is retired, `False` otherwise or if private.

  property is_transfer_syntax: bool

    Return `True` if a transfer syntax UID.

  property is_valid: bool

    Return `True` if self is a valid UID, `False` otherwise.

  property keyword: str

    Return the UID keyword from the UID dictionary.

  property name: str

    Return the UID name from the UID dictionary.

  property type: str

    Return the UID type from the UID dictionary.