class Resolv::LOC::Coord - Documentation for Ruby 4.1
Description: class Resolv::LOC::Coord: A Resolv::LOC::Coord
Keywords: ruby,class,Resolv::LOC::Coord

🔍

No recent searches

# class Resolv::LOC::Coord

A `Resolv::LOC::Coord`

### Constants

Bias

  `Bias` for the equator/prime meridian, in thousandths of a second of arc.

Regex

  Regular expression `LOC` `Coord` must match.

### Attributes

coordinates [R]

The raw coordinates

orientation [R]

The orientation of the hemisphere as ‘lat’ or ‘lon’

### Public Class Methods

create (arg)
Source

    # File lib/resolv.rb, line 3348
    def self.create(arg)
      case arg
      when Coord
        return arg
      when String
        unless m = Regex.match(arg)
          raise ArgumentError.new("not a properly formed Coord string: " + arg)
        end

        arc = (m[1].to_i * 3_600_000) + (m[2].to_i * 60_000) + (m[3].to_f * 1_000).to_i
        dir = m[4]
        lat = dir[/[NS]/]
        unless arc <= (lat ? 324_000_000 : 648_000_000) # (lat ? 90 : 180) * 3_600_000
          raise ArgumentError.new("out of range as Coord: #{arg}")
        end

        hemi = dir[/[NE]/] ? 1 : -1
        return new([arc * hemi + Bias].pack("N"), lat ? "lat" : "lon")
      else
        raise ArgumentError.new("cannot interpret as Coord: #{arg.inspect}")
      end
    end

Creates a new `LOC::Coord` from `arg` which may be:

`LOC::Coord`

  returns `arg`.

`String`

  `arg` must match the `LOC::Coord::Regex` constant

new (coordinates,orientation)
Source

    # File lib/resolv.rb, line 3372
    def initialize(coordinates,orientation)
      unless coordinates.kind_of?(String) and coordinates.bytesize == 4
        raise ArgumentError.new("Coord must be a 32bit unsigned integer in hex format: #{coordinates.inspect}")
      end
      unless orientation == "lon" || orientation == "lat"
        raise ArgumentError.new('Coord expects orientation to be a String argument of "lat" or "lon"')
      end
      @coordinates = coordinates
      @orientation = orientation
    end

Internal use; use self.create.