# pycantonese.parse_jyutping

pycantonese.parse_jyutping(jp_str) → List[pycantonese.jyutping.parse_jyutping.Jyutping]

  Parse Jyutping romanization into onset, nucleus, code, and tone.

  Parameters
    jp_str str

      Jyutping romanization for one or multiple characters.

  Returns
    List[Jyutping]
  Raises
    ValueError

      If the Jyutping romanization is illegal (e.g., with unrecognized elements).

  Examples

      >>> parse_jyutping("gwong2dung1waa2")  # 廣東話, Cantonese
      [Jyutping(onset='gw', nucleus='o', coda='ng', tone='2'),
       Jyutping(onset='d', nucleus='u', coda='ng', tone='1'),
       Jyutping(onset='w', nucleus='aa', coda='', tone='2')]