pycantonese.parse_jyutping

pycantonese.parse_jyutping(jp_str) → list[Jyutping][source]

Parse Jyutping romanization into onset, nucleus, coda, 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("gwong2 dung1 waa2")  # 廣東話, 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')]