Kernel APIs: NAMECOMP^XLFNAME

NAMECOMP^XLFNAME(): Component Parts from Standard Name

Reference Type: Supported, Category: Name Standardization, Integration Agreement: 3065

Description

This API takes a name in standard format and returns in an array the component parts of that name.

Format

  NAMECOMP^XLFNAME(.name)

Input Parameters

.name:

(required) This parameter is the name in standard format to be parsed. NAMECOMP^XLFNAME returns the component parts of the name in nodes descendent from NAME. (See "Output")

Output Parameters

.name:

The component parts of the name are returned in the NAME array passed in.

NAME("FAMILY) = Family (last) Name
NAME("GIVEN") = Given (first) Name
NAME("MIDDLE") = Middle Name
NAME("SUFFIX") = Suffix(es)

Example

In this example, the MYNAME variable is set to the standard name, and the NAMECOMP^XLFNAME call is made to return in the MYNAME array the component parts of that name:

>S MYNAME="KRNUSER-XUUSER,FORTY ONE S MD"
>D NAMECOMP^XLFNAME(.MYNAME)

>ZW MYNAME
MYNAME=KRNUSER-XUUSER,FORTY ONE S MD
MYNAME("FAMILY")=KRNUSER-XUUSER
MYNAME("GIVEN")=FORTY ONE
MYNAME("MIDDLE")=S
MYNAME("SUFFIX")=MD

VA (Internet) / VA (Intranet) / OI / HSD&D / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: December 14, 2005

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.