pipImportOpenBNA - spatial_geostan - 2024.00

Spatial+ Reference for Windows, UNIX/Linux, z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > Spatial+
Version
2024.00
Language
English
Product name
Spatial+
Title
Spatial+ Reference for Windows, UNIX/Linux, z/OS
Copyright
2024
First publish date
1994
Last updated
2024-05-07
Published on
2024-05-07T22:16:04.316305

Opens ESRI Atlas GIS BNA file for import.

Syntax

intl pipImportOpenBNA ( pipImporter imp_h, pstr fileName, intl nameField );

Arguments

h The handle returned by pipImportInit for the current import process. Input.

fileName The complete path and filename of the BNA file to import. Input. nameField The field number to use as the name field (1, 2, or 3). If NULL or

invalid, the first column provides the name. Input.

Return Value

PIP_OK PIP_ERROR

Prerequisites

pipImportInit.

Alternates

pipImportOpenMIF2, pipImportOpenShape, or pipImportOpenTab.

Notes

This function opens an ESRI Atlas GIS BNA file for importing. The supported structure of a BNA file is detailed in on page 198.

BNA files have 1, 2, or 3 names associated with each feature. Use the nameField parameter to select the name field you wish to use. If you specify an invalid field number, pipImportOpenBNA defaults to the first column and generates an explanatory message. Precisely recommends calling pipErrorGet immediately after pipImportOpenBNA to retrieve these messages.

The coordinates in the BNA file must correspond to the coordSys parameter in the structure passed to the pipImportInit function.

Example

See pipImportInit.