GsDataSet - geostan_1 - 2024.01

GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > GeoStan
Version
2024.01
Language
English
Product name
GeoStan
Title
GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS
Copyright
2024
First publish date
1994
Last updated
2024-07-29
Published on
2024-07-29T23:01:18.924000

Passes data for all address elements to GeoStan.

Syntax

GsFunStat GsDataSet(GsId gs, GsEnum fSwitch, gs_const_str pBuffer);

Arguments

GsIdgs    ID returned by GsInitWithProps() for the current instance of GeoStan. Input.

GsEnumfSwitch   Symbolic constant for the data item to load. See Enums for storing and retrieving data for valid enums. Input.

gs_const_strpBuffer   String pointer containing the data to load. Input.

Return Values

GS_SUCCESS

GS_ERROR

Prerequisites

GsInitWithProps()

Notes

This function loads data elements into internal GeoStan buffers. When loading address information as a complete address or last line, GeoStan parses the data into fields. For example, if you enter a last line of "Boulder, CO 80301-1234", GeoStan parses the data and sets the city, state, ZIP, and ZIP + 4 fields. You can retrieve parsed input data using GsDataGet() with the GS_INPUT argument.

If you are passing both an address line and a last line or ZIP Code, enter the last line or ZIP Code first to ensure the greatest accuracy in address standardization.

If you are passing both the address information and the last line information as one input line, enter the address information first.

Using the appropriate GsEnums, you can pass singleline addresses, two-line addresses, or multiline addresses of up to six lines. For more information, see Extracting Data from GSD Files.

Do not call alter the GS_FIND_MATCH_MODE property value in your Find Properties after you have called GsDataSet(), because the previously established match mode affects how the input address is parsed. If you need to change the match mode in mid-process, you must reenter the data for the current address with GsDataSet().