hdm.cpp

提取各种NEMA0183格式数据的类编程。

/*
** Author: Samuel R. Blackburn
** Internet: [e-mail]
**
** Copyright, 1996-2005, Samuel R. Blackburn
**
** "You can get credit for something or get it done, but not both."
** Dr. Richard Garwin
**
** BSD License follows.
**
** Redistribution and use in source and binary forms, with or without
** modification, are permitted provided that the following conditions
** are met:
**
** Redistributions of source code must retain the above copyright notice,
** this list of conditions and the following disclaimer. Redistributions
** in binary form must reproduce the above copyright notice, this list
** of conditions and the following disclaimer in the documentation and/or
** other materials provided with the distribution. Neither the name of
** the WFC nor the names of its contributors may be used to endorse or
** promote products derived from this software without specific prior
** written permission.
**
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
**
** $Workfile: hdm.cpp $
** $Revision: 4 $
** $Modtime: 10/10/98 2:55p $
*/

/*
** This Sentence Not Recommended For New Designs
** Use of HDG is recommended.
*/

#include "nmea0183.h"
#pragma hdrstop

#if defined( _DEBUG ) && defined( _INC_CRTDBG )
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#define new DEBUG_NEW
#endif // _DEBUG

HDM::HDM()
{
   Mnemonic = TEXT( "HDM" );
   Empty();
}

HDM::~HDM()
{
   Mnemonic.Empty();
   Empty();
}

void HDM::Empty( void )
{
   HeadingDegrees = 0.0;
}

BOOL HDM::Parse( const SENTENCE& sentence )
{
   /*
   ** HDM - Heading - Deviation & Variation
   **
   **        1   2 3
   **        |   | |
   ** $--HDM,x.x,M*hh<CR><LF>
   **
   ** Field Number: 
   **  1) Heading in degrees
   **  2) M, Magnetic Deviation
   **  3) Checksum
   */

   /*
   ** First we check the checksum...
   */

   const NMEA0183_BOOLEAN checksum_is_bad = sentence.IsChecksumBad();

   if ( checksum_is_bad == True )
   {
      InvalidChecksum();
      return( FALSE );
   } 

   HeadingDegrees = sentence.Double( 1 );

   return( TRUE );
}

CString HDM::ToText( void ) const
{
   CString return_string;

   return_string.Format( TEXT( "The Magnetic heading is %6.2lf degrees." ), HeadingDegrees );

   return( return_string );
}

BOOL HDM::Write( SENTENCE& sentence )
{
   /*
   ** Let the parent do its thing
   */
   
   RESPONSE::Write( sentence );

   sentence += HeadingDegrees;
   sentence += TEXT( "M" );

   sentence.Finish();

   return( TRUE );
}

const HDM& HDM::operator = ( const HDM& source )
{
   HeadingDegrees = source.HeadingDegrees;

   return( *this );
}