Struct LocationDB 

pub struct LocationDB { /* private fields */ }

An opened IP2Location geolocation BIN database.

Holds the parsed header metadata and a memory-mapped [Source]. Use DB::from_file to open, or LocationDB::from_file to open directly.

Implementations

impl LocationDB

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self, Error>

Loads a Ip2Location Database .bin file from path using mmap (memap) feature.

Example usage

 use ip2location::DB;

 let mut db = DB::from_file("data/IP2LOCATION-LITE-DB1.BIN").unwrap();

pub fn print_db_info(&self)

Prints the DB Information to console

Example usage

use ip2location::DB;

let mut db = DB::from_file("data/IP2LOCATION-LITE-DB1.BIN").unwrap();
db.print_db_info();

pub fn ip_lookup(&self, ip: IpAddr) -> Result<LocationRecord<'_>, Error>

Lookup for the given IPv4 or IPv6 and returns the Geo information

Example usage

 use ip2location::{DB, Record};

 let mut db = DB::from_file("data/IP2LOCATION-LITE-DB1.IPV6.BIN").unwrap();
 let geo_info = db.ip_lookup("2a01:cb08:8d14::".parse().unwrap()).unwrap();
 println!("{:#?}", geo_info);
 let record = if let Record::LocationDb(rec) = geo_info {
   Some(rec)
 } else { None };
 let geo_info = record.unwrap();
 assert!(!geo_info.country.is_none());
 assert_eq!(geo_info.country.unwrap().short_name, "FR")

Trait Implementations

impl Debug for LocationDB

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.