GetBNAInfo()

Summary

Collects summary information on the contents of a BNA file.

Syntax

bna_info = GetBNAInfo(string bna_file_name)

Argument Contents
bna_file_name The path and file name of the BNA file

Returns

An array of information as follows:

Element Type Contents
1 Array An array of four real numbers indicating the bounding coordinates of the file: {x_min, y_min, x_max, y_max}
2 Array An array of entity type-count pairs indicating the quantity of each type of entity in the file
3 String "True" if the BNA file appears to be tab-delimited, "False" otherwise; this information is not guaranteed to be correct
4 Integer A best guess of the number of name fields for each entity
5 String The first layer name appearing in the BNA file, or null if no layer name is used

Notes

  • The entity type-count list includes one entry for each of the following types: POINT, LINE, CIRCLE, REGION.

  • The tab-delimited flag is required by ImportBNA().

  • The number of name fields is always between one and four, and is an input to ImportBNA().

Example

// This call...
bna_info = GetBNAInfo("c:\\atlasgis.bna")
// Returns this type of information...
// bna_info = {
// {-85.52, 37.45, -83.37, 39.632}, (bounding rect)
// {{"POINT", 231}, {"REGION", 100}, ...} (counts by entity type)
// "False", (tab-delimited)
// 3, (name fields/entity)
// "State Boundaries"} (layer name)

Error Codes

Error Type Meaning
Error The file is not a valid BNA file
NotFound There is no BNA file with the given path and file name

See Also

Function Summary
ImportBNA() Imports features from a BNA file into a geographic file