An ICD code consists of, at a minimum, a three digit ICD-10 code (i.e. one upper-case letter followed by two digits). This may optionally be followed by a two digit subcode, selected punctuation symbols (cross "*", dagger "U2020" or exclamation mark "!"). Both the period separating the three-digit code from the subcode, and the hyphen indicating an "incomplete" subcode, are optional. Finally, in the ambulatory system, an additional letter G, V, Z or A may be appended to signify the status ("security") of the diagnosis.

icd_parse(str, type = "bounded", bind_rows = TRUE)

Arguments

str

Character vector from which to extract all ICD codes

type

A character string determining how strictly matching should be performed. This must be one of "strict" (str contains a ICD code with no extraneous characters), bounded (str contains an ICD code with a word boundary on both sides) or weak (ICD codes are extracted even if they are contained within a word, e.g. "E10Diabetes" would return "E10"). Default: bounded.

bind_rows

logical. Whether to convert the matrix output of stirngi::stri_match_all to a data.frame, with additional icd_sub to uniquely represent the code and allow lookup of the code

Value

data.frame (if bind_rows = TRUE) or matrix

Details

By default, the function returns a data.frame containing the matched codes and the standardised three digit code (icd3), subcode (icd_subcode), normcode (icd_norm) and code without period (icd_sub).

If bind_rows = FALSE, the list output of stringi::stri_match_all_regex is returned. This is particularly useful to retrieve the matches from each element of the str vector separately.

See also

Examples

icd_parse("E11.7")
#> icd_spec icd3 icd_subcode icd_security icd_sub #> 1 E11.7 E11 7 E117
icd_parse("Depression: F32")
#> icd_spec icd3 icd_subcode icd_security icd_sub #> 1 Depression: F32 F32 F32
icd_parse(c( "Backpain (M54.9) is one of the most common diagnoses in primary care", "Codes for chronic pain include R52.1 and F45.4" ))
#> icd_spec icd3 #> 1 Backpain (M54.9) is one of the most common diagnoses in primary care M54 #> 2 Codes for chronic pain include R52.1 and F45.4 R52 #> 3 Codes for chronic pain include R52.1 and F45.4 F45 #> icd_subcode icd_security icd_sub #> 1 9 M549 #> 2 1 R521 #> 3 4 F454