AddressAbbreviate()

<< Click to Display Table of Contents >>

Navigation:  Available Functions >

AddressAbbreviate()

Syntax

AddressAbbreviate( <cAddressToAbbreviate>, <lIgnoreCase>, <lAddPeriods> )

 

Purpose

To abbreviate street suffixes and directionals in addresses.

 

Parameters

<cAddressToAbbreviate> is the name of a character field in DonorQuest containing the address you wish to abbreviate. It may also be the name of an address field within an external file which you are importing into DonorQuest.

 

<lIgnoreCase> is a true/false value. If true, case will be ignored when analyzing the address to abbreviate. If this parameter is true, then the resulting abbreviated address will also be in all upper case.

 

<lAddPeriods> is a true/false value. If true, periods will be applied to the abbreviations. So an address such as, "1234 First Avenue Northeast" will become, "1234 1st. Ave. N.E."

 

Returns

The given address, with all fully spelled out street suffixes and directionals translated to their USPS approved abbreviations.

 

Usage

AddressAbbreviate() is normally used when importing data to insure imported addresses adhere to the standard for addresses you wish to use in your donor database. It may also be used to mass update existing records in your database using the Replace feature of Selection Results. Used in conjunction with the AddressExpand() function, you may format address data to adhere to one of three standards: No Abbreviations, Abbreviations, and Abbreviations with periods. The No Abbreviations standardization would expand all addresses to have the full spellings of street suffixes and directionals, resulting in addresses such as, "1234 First Avenue Northeast." Abbreviations would result in addresses such as, "1234 1st Ave NE", and Abbreviations with periods would result in addresses such as, "1234 1st. Ave. N.E."

 

Example

The following examples illustrate AddressAbbreviate():

 

CALL

RESULT

.Address.

1234 First Avenue Northeast

AddressAbbreviate( .Address., .F. )

1234 1st Ave NE

AddressAbbreviate( .Address., .T. )

1234 1ST AVE NE

AddressAbbreviate( .Address., .F., .T. )

1234 1st. Ave. NE.

AddressAbbreviate( .Address., .T., .T. )

1234 1ST. AVE. NE.