The Win32 Foundation Classes (WFC) - Version 45

Sam Blackburn

Rate me:

4.93/5 (40 votes)

16 May 2000

470.3K

12.7K

280

The Win32 Foundation Classes (WFC) are a library of C++ classes that extend Microsoft Foundation Classes (MFC) beyond mere GUI applications, and provide extensive support for system and NT specific applications

wfc.zip
- wfc
  - BACKUP.CMD
  - HTML
    - Document.cmd
    - web
      - CLASSES.HTM
      - Coding.htm
      - gather.cmd
      - HOMEPAGE.HTM
      - pax.HTM
      - Release30.htm
      - Release31.htm
      - Release32.htm
      - Release33.htm
      - release34.htm
      - Release35.htm
      - Release36.htm
      - Release37.htm
      - Release38.htm
      - Release39.htm
      - Release41.htm
      - Release42.htm
      - Release43.htm
      - Release44.htm
      - Samples.htm
      - TechNotes.htm
      - TIMEBEG.HTM
      - TITLE.HTM
      - WFC.HTM
      - WTN001.htm
      - WTN002.htm
      - WTN003.htm
      - WTN004.htm
      - WTN005.htm
      - WTN006.htm
      - WTN007.htm
  - INCLUDE
    - CBase64Coding.hpp
    - CBitArray.hpp
    - CBubble.hpp
    - CConstellation.hpp
    - CCriticalSection.hpp
    - CCrypto.hpp
    - CDataArchive.hpp
    - CDataChunk.hpp
    - CDataFile.hpp
    - CDataLocation.hpp
    - CDataMemory.hpp
    - CDataParser.hpp
    - CDataSocket.hpp
    - CDesktop.hpp
    - CDragQuery.hpp
    - CEventLogRecord.HPP
    - CEVNTLOG.HPP
    - CExtensibleMarkupLanguage.hpp
    - CFile.hpp
    - CFile64.hpp
    - CFileDirectory.hpp
    - CFileTime.hpp
    - CFileTransferProtocol.hpp
    - CGarbageCollector.hpp
    - CJulianDate.hpp
    - CMemoryFile.hpp
    - CMicrosoftTape.hpp
    - CMixer.hpp
    - CNetConn.hpp
    - CNetFile.hpp
    - CNetInfo.hpp
    - CNetMesg.hpp
    - CNetRsrc.hpp
    - CNetSess.hpp
    - CNetShar.hpp
    - CNetUser.hpp
    - CNetWkst.hpp
    - CNetwork.hpp
    - CNetworkScheduleJob.hpp
    - CNMPIPE.HPP
    - CParsePoint.hpp
    - CPasswordChangeFilter.hpp
    - CPhysicalDiskFile.hpp
    - CPing.hpp
    - CQueue.hpp
    - CRandomNumberGenerator.hpp
    - CRandomNumberGenerator2.hpp
    - CRAS.HPP
    - CRASADM.HPP
    - CRASPORT.HPP
    - CReedSolomonErrorCorrectionCode.hpp
    - CREGISTY.HPP
    - CSecureChannel.hpp
    - CServer.hpp
    - CService.hpp
    - CServiceApplication.hpp
    - CSharedMemoryObject.hpp
    - CSMTF.hpp
    - CSquigl.hpp
    - CSuperRandomNumberGenerator.hpp
    - CSvcMgr.hpp
    - CSystemTime.hpp
    - ctape.hpp
    - CTimeEx.hpp
    - CUNC.HPP
    - CURL.HPP
    - CUUCoding.hpp
    - CVolume.hpp
    - CWait.hpp
    - CWeather.hpp
    - CXMLArchive.hpp
    - DCB.HPP
    - DrawGrid.hpp
    - DrawObj.hpp
    - DumyFile.hpp
    - Guards.hpp
    - LSOCKETS.HPP
    - LZFILE.HPP
    - Mfc2Stl.h
    - Modem.hpp
    - mtf.h
    - origianl_CFile.hpp
    - OVRLPD.HPP
    - Pager.hpp
    - PortInformation.hpp
    - RIFF.hpp
    - samtf.h
    - Serial.hpp
    - ServiceConfiguration.hpp
    - SkyWord.hpp
    - SOCKETS.HPP
    - SockFile.hpp
    - SprintSpectrum.hpp
    - stlxml.h
    - Structs.hpp
    - TSOCKETS.HPP
    - WFC.H
    - wfc_coverage.h
    - wfc_crypto.h
    - wfc_linker_setup.h
    - wfc_thread_information_block.h
    - wfc_undocumented.h
    - wfcfloat.h
    - WFCTrace.hpp
    - WindowsSockets.hpp
  - InternalCompilerErrors.txt
  - LIB
    - make.cmd
    - types.xml
    - WFC.dsp
    - WFC.dsw
    - WFC.mak
    - wfcvc42.mak
  - makewebsite.cmd
  - old_paxit.cmd
  - PAXIT.CMD
  - Renames.txt
  - SRC
    - ATCP.cpp
    - CBase64Coding.cpp
    - CBitArray.cpp
    - CBubble.cpp
    - CConstellation.cpp
    - CCriticalSection.cpp
    - CCriticalSectionGuard.cpp
    - CCryptographicAlgorithm.cpp
    - CCryptographicHash.cpp
    - CCryptographicKey.cpp
    - CCryptographicProvider.cpp
    - CCryptography.cpp
    - CDataArchive.cpp
    - CDataChunk.cpp
    - CDataFile.cpp
    - CDataMemory.cpp
    - CDataParser.cpp
    - CDataSocket.cpp
    - CDesktop.cpp
    - CDragQuery.cpp
    - CEventLogRecord.CPP
    - CEVNTLOG.CPP
    - CExtensibleMarkupLanguageAttribute.cpp
    - CExtensibleMarkupLanguageDocument.cpp
    - CExtensibleMarkupLanguageElement.cpp
    - CExtensibleMarkupLanguageEntities.cpp
    - CFile.cpp
    - CFile64.cpp
    - CFileDirectory.cpp
    - CFileTime.cpp
    - CFileTransferProtocol.cpp
    - CGarbageCollector.cpp
    - CJulianDate.cpp
    - CMemoryFile.cpp
    - CMicrosoftTape.cpp
    - CMixer.cpp
    - CMixerCapabilities.cpp
    - CMixerControl.cpp
    - CMixerControlDetails.cpp
    - CMixerControlDetailsData.cpp
    - CMixerControlInstance.cpp
    - CMixerDestination.cpp
    - CMixerLine.cpp
    - CMixerSource.cpp
    - CMixerSourceSelector.cpp
    - CMixerSpeakers.cpp
    - CMixerSwitchControl.cpp
    - CMixerVolumeControl.cpp
    - CMixerWaveIn.cpp
    - CNetConn.cpp
    - CNetFile.cpp
    - CNetInfo.cpp
    - CNetMesg.cpp
    - CNetRsrc.cpp
    - CNetScheduleJob.cpp
    - CNetSess.cpp
    - CNetShar.cpp
    - CNetWkst.cpp
    - CNetwork.cpp
    - CNetworkConnectionInformation.cpp
    - CNetworkFileInformation.cpp
    - CNetworkResourceInformation.cpp
    - CNetworkSessionInformation.cpp
    - CNetworkUser.cpp
    - CNetworkUserInformation.cpp
    - CParsePoint.cpp
    - CPasswordChangeFilter.cpp
    - CPhysicalDiskFile.cpp
    - CPing.cpp
    - CPingRes.cpp
    - CQueue.cpp
    - CRandomNumberGenerator.cpp
    - CRandomNumberGenerator2.cpp
    - CRAS.CPP
    - CRASADM.CPP
    - CReedSolomonErrorCorrectionCode.cpp
    - CRIFFChunk.cpp
    - CSecureChannel.cpp
    - CServer.cpp
    - CService.cpp
    - CServiceApplication.cpp
    - CSharedMemoryObject.cpp
    - CSMTF.cpp
    - CSquigl.cpp
    - CSuperRandomNumberGenerator.cpp
    - CSvcMgr.cpp
    - CSystemTime.cpp
    - CTape.cpp
    - CTapeGetMediaParameters.cpp
    - CTimeEx.cpp
    - CUNC.CPP
    - CURL.CPP
    - CUUCoding.cpp
    - CVolume.cpp
    - CWait.cpp
    - CWeather.cpp
    - CXMLArchive.cpp
    - DCB.CPP
    - doc.cmd
    - DrawGrid.cpp
    - DrawObj.cpp
    - DumyFile.cpp
    - IPCP.cpp
    - IPXCP.cpp
    - LMErr.cpp
    - LSOCKETS.CPP
    - LZFile.cpp
    - Modem.CPP
    - NAMDPIPE.CPP
    - NBFCP.cpp
    - original_CFile.cpp
    - OVRLPD.CPP
    - Pager.cpp
    - PortInformation.CPP
    - RASCP.CPP
    - RASNBPCP.CPP
    - RASPORT.CPP
    - RASPPPCR.cpp
    - RASPSTAT.CPP
    - REGISTRY.CPP
    - RemoteAccessServicePort.CPP
    - RemoteAccessServiceUser.cpp
    - Serial.CPP
    - ServiceConfiguration.cpp
    - SkyWord.cpp
    - SOCKETS.CPP
    - SockFile.cpp
    - SprintSpectrum.cpp
    - STL_CByteArray.cpp
    - STL_CDWordArray.cpp
    - STL_CPtrArray.cpp
    - STL_CString.cpp
    - STL_CStringArray.cpp
    - STL_CUIntArray.cpp
    - STL_CWordArray.cpp
    - Structs.cpp
    - TALKSOCK.CPP
    - U2A_A2U.cpp
    - wfc_am_i_administrator.cpp
    - wfc_append_string_to_CByteArray.cpp
    - wfc_append_text_to_edit_control.cpp
    - wfc_close_handle.cpp
    - wfc_convert_double_null_terminated_string.cpp
    - wfc_convert_double_null_terminated_UNICODE_string.cpp
    - wfc_convert_lpwstr_to_cstring.cpp
    - wfc_create_hard_link.cpp
    - wfc_delete_oldest_file.cpp
    - wfc_enable_all_privileges.cpp
    - wfc_enable_privilege.cpp
    - wfc_get_day_of_week.cpp
    - wfc_get_directory_usage_percentage.cpp
    - wfc_get_error_string.cpp
    - wfc_get_executable_directory.cpp
    - wfc_get_filename_from_handle.cpp
    - wfc_get_list_of_programs_that_run_when_a_user_logs_on.cpp
    - wfc_get_operating_system_version_string.cpp
    - wfc_get_web_page.cpp
    - wfc_move_file_at_reboot.cpp
    - wfc_parse_iso_8601_string.cpp
    - wfc_set_thread_name.cpp
    - wfc_start_screen_saver.cpp
    - wfc_undocumented_get_system_process_list.cpp
    - wfc_UNICODE_floating_point_routines.cpp
    - WfcTrace.cpp
    - xml_character_test_routines.cpp
  - WFC World.txt
  - wfcfaq.htm
sample.zip
- sample
  - Sample
    - ADO2XML
      - ADO2XML.dsp
      - ADO2XML.dsw
      - ado2xml.h
      - ado2xml.xml
      - CDatabaseParameters.cpp
      - CDatabaseParameters.hpp
      - convert_DataTypeEnum_to_string.cpp
      - convert_desired_tables.cpp
      - convert_table.cpp
      - get_blob.cpp
      - get_table_names.cpp
      - main.cpp
      - normalize_string.cpp
      - open_connection_to_database.cpp
      - output_field.cpp
      - output_schema.cpp
      - output_types.cpp
      - print_COM_error.cpp
      - print_provider_error.cpp
      - replace.cpp
    - ChangeServiceConfiguration
      - ChangeServiceConfiguration.cpp
      - ChangeServiceConfiguration.dsp
      - ChangeServiceConfiguration.dsw
      - ChangeServiceConfiguration.mak
    - ClockSync
      - ClockSync.cpp
      - ClockSync.dsp
      - ClockSync.dsw
      - ClockSync.mak
    - Counter
      - Counter.cpp
      - counter.h
      - counter.mak
      - CPCD.cpp
      - CPCD.hpp
      - CPerfDef.cpp
      - CPerfDef.hpp
      - CPerformanceCounterData.hpp
      - CPerformanceCounterDefinition.cpp
      - CPerformanceCounterDefinition.hpp
      - CPerformanceData.cpp
      - CPerformanceData.hpp
      - CPerformanceInstance.cpp
      - CPerformanceInstance.hpp
      - CPerformanceObject.cpp
      - CPerformanceObject.hpp
      - test.cpp
    - Crypto
      - Crypto.cpp
      - Crypto.dsp
      - Crypto.dsw
      - Crypto.mak
    - CScript
      - CScript.dsp
      - CScript.dsw
      - main.cpp
    - Data
      - CSimpleClass.hpp
      - Receiver
        
        Receiver.cpp
        
        Receiver.dsp
        
        Receiver.dsw
      - Sender
        
        Sender.cpp
        
        Sender.dsp
        
        Sender.dsw
    - DeMangle
      - DeMangle.dsp
      - DeMangle.dsw
      - main.cpp
    - DriverMover
      - DriverMover.cpp
      - DriverMover.dsp
      - DriverMover.dsw
      - DriverMover.h
      - DriverMover.rc
      - DriverMoverDialog.cpp
      - DriverMoverDialog.h
      - ReadMe.txt
      - res
        
        DriverMover.ico
        
        DriverMover.rc2
      - resource.h
      - StdAfx.cpp
      - StdAfx.h
    - dump_ntfs_streams.cpp
    - DumpEventLog
      - DumpEventLog.cpp
      - DumpEventLog.mak
    - EnableRASLogging
      - EnableRASLogging.cpp
      - EnableRASLogging.mak
    - EventPager
      - EventPager.cpp
      - EventPager.dsp
      - EventPager.dsw
      - EventPager.mak
      - MAKEMC.CMD
      - messages.h
      - messages.mc
      - messages.rc
    - GetWebPage
      - CNNWeather.cpp
      - CStockQuote.hpp
      - GetStockQuote.cpp
      - GetWebPage.cpp
      - GetWebPage.dsp
      - GetWebPage.dsw
      - GetWebPage.mak
      - wc.html
      - WeatherChannelWeather.cpp
    - HTML
      - html.cpp
      - html.dsp
      - html.dsw
      - html.mak
    - KillDoc
      - KillDoc.dsp
      - KillDoc.dsw
      - main.cpp
    - LastEvent
      - LastEvent.cpp
      - LastEvent.dsp
      - LastEvent.dsw
      - LastEvent.mak
    - Listen
      - Listen.cpp
      - Listen.dsp
      - Listen.dsw
      - Listen.mak
      - sl.cpp
    - ListProcesses
      - list_processes.cpp
      - ListProcesses.dsp
      - ListProcesses.dsw
      - ListProcesses.h
      - main.cpp
      - print_process_list.cpp
    - MAKEMC.CMD
    - Map2Def
      - Map2Def.cpp
      - Map2Def.dsp
      - Map2Def.dsw
      - Map2Def.mak
    - Microphone
      - main.cpp
      - Microphone.dsp
      - Microphone.dsw
    - MIME2HTML
      - Debug
        
        mime.html
      - dump_mime_mappings.cpp
      - dump_mime_type.cpp
      - get_command_line.cpp
      - main.cpp
      - MIME2HTML.dsp
      - MIME2HTML.dsw
      - MIME2HTML.h
      - normalize_string.cpp
      - replace.cpp
    - PasswordFilter
      - DLL
        
        InitializeChangeNotify.cpp
        
        PasswordChangeNotify.cpp
        
        PasswordDLL.cpp
        
        PasswordDLL.dsp
        
        PasswordDLL.dsw
        
        PasswordDLL.h
      - PasswordFilter.cpp
      - PasswordFilter.dsp
      - PasswordFilter.dsw
    - Ping
      - Ping.cpp
      - Ping.dsp
      - Ping.dsw
      - Ping.mak
    - Pinger
      - MAKEMC.CMD
      - messages.h
      - MESSAGES.MC
      - messages.rc
      - Pinger.cpp
      - Pinger.dsp
      - Pinger.dsw
      - Pinger.mak
      - PINGER.RC
      - Pinger.ver
      - resource.h
    - RasAdmin
      - RasAdmin.cpp
      - RasAdmin.dsp
      - RasAdmin.dsw
      - RasAdmin.mak
    - Serial
      - Serial.cpp
      - Serial.dsp
      - Serial.dsw
      - Serial.h
      - Serial.mak
    - SerialTest
      - Normal
        
        Receiver
        
        compute_checksum.cpp
        
        main.cpp
        
        Receiver.dsp
        
        Receiver.dsw
        
        receiver.h
        
        Sender
        
        main.cpp
        
        prepare_buffer.cpp
        
        Sender.dsp
        
        Sender.dsw
        
        sender.h
    - Service
      - Service.cpp
      - Service.dsp
      - Service.dsw
      - Service.mak
    - SkyPage
      - SKYPAGE.CPP
      - SkyPage.dsp
      - SkyPage.dsw
      - SkyPage.mak
    - SprintSpectrum
      - SprintSpectrum.cpp
      - SprintSpectrum.dsp
      - SprintSpectrum.dsw
      - SprintSpectrum.mak
    - Squiggle
      - Squiggle.cpp
      - Squiggle.mak
    - TortureXML
      - create_huge_character_reference.cpp
      - create_huge_element.cpp
      - create_huge_element_and_attribute.cpp
      - create_huge_element_name.cpp
      - create_huge_encoding.cpp
      - create_huge_version.cpp
      - main.cpp
      - TortureXML.dsp
      - TortureXML.dsw
      - TortureXML.h
    - USNOTime
      - main.cpp
      - USNOTime.dsp
      - USNOTime.dsw
    - WatchDog
      - MAKEMC.CMD
      - messages.h
      - messages.mc
      - messages.rc
      - WatchDog.cpp
      - WatchDog.dsp
      - WatchDog.dsw
      - WatchDog.mak
      - WatchDog.rc
      - WatchDog.ver
    - Wfc2Html
      - CCPPToHTMLTranslator.cpp
      - CCPPToHTMLTranslator.hpp
      - load_translator.cpp
      - main.cpp
      - translate_file.cpp
      - Wfc2Html.dsp
      - Wfc2Html.dsw
      - wfc2html.h
    - WinPage
      - res
        
        WinPage.ico
        
        WinPage.rc2
      - resource.h
      - WinPage.cpp
      - WinPage.dsp
      - WinPage.dsw
      - WinPage.h
      - WinPage.mak
      - WinPage.rc
      - WinPageDlg.cpp
      - WinPageDlg.h
    - XML
      - Debug
        
        test2.xml
      - dump_element.cpp
      - dump_tags.cpp
      - get_bytes.cpp
      - main.cpp
      - my_xml.h
      - parse_document.cpp
      - poem.xml
      - test.xml
      - TestSuite.xml
      - XML.DSP
      - XML.dsw
    - XMLCheck
      - check_xml_file.cpp
      - Debug
        
        check.txt
        
        test.xml
        
        TestSuite.xml
        
        TestSuite2.xml
        
        txtfirst.xml
        
        txtlast.xml
      - main.cpp
      - XML
        
        a2.xml
      - XMLCheck.dsp
      - XMLCheck.dsw
      - XMLCheck.h
      - XMLCheck.mak
    - XMLExplorer
      - CMainFrame.cpp
      - CMainFrame.h
      - CXMLExplorerDocument.cpp
      - CXMLExplorerDocument.h
      - CXMLExplorerView.cpp
      - CXMLExplorerView.h
      - MyListView.cpp
      - MyListView.h
      - MyTreeView.cpp
      - MyTreeView.h
      - ReadMe.txt
      - res
        
        bitmap1.bmp
        
        CXMLExplorerDocument.ico
        
        Toolbar.bmp
        
        XMLExplorer.ico
        
        XMLExplorer.rc2
      - resource.h
      - StdAfx.cpp
      - StdAfx.h
      - test.xml
      - XMLExplorer.cpp
      - XMLExplorer.dsp
      - XMLExplorer.dsw
      - XMLExplorer.h
      - XMLExplorer.rc
    - XMLUser
      - add_current_time.cpp
      - add_level.cpp
      - add_machine_name.cpp
      - add_to_xml.cpp
      - enumerate_users.cpp
      - main.cpp
      - parse_document.cpp
      - save_document.cpp
      - users.xml
      - XMLUser.dsp
      - XMLUser.dsw
      - XMLUser.h
  - TEST
    - CQueue_stress_test.cpp
    - dumpexports.cpp
    - Grid
      - Grid.cpp
      - Grid.mak
    - MESSAGES.MC
    - Output.txt
    - Pipe
      - pipe.CPP
      - Pipe.h
      - Pipe.mak
      - Server.CPP
    - REPERR.CPP
    - TCLZFile.CPP
    - TCNet.CPP
    - TCNetCon.CPP
    - TCNetFil.CPP
    - TCNetshs.CPP
    - TCNetUSR.CPP
    - TCNSrc.cpp
    - TCRAS.CPP
    - TCRASPORT.CPP
    - TCREG.CPP
    - TCSess.CPP
    - TCSrvr.CPP
    - TCSvcMgr.CPP
    - TCTape.cpp
    - TEST.CPP
    - TEST.dsp
    - TEST.dsw
    - TEST.H
    - TEST.MAK
    - test_CBase64Coding.cpp
    - test_CBitArray.cpp
    - test_CByteArray.cpp
    - test_CDataParser.cpp
    - test_CDWordArray.cpp
    - test_CFileTransferProtocol.cpp
    - test_CJulianDate.cpp
    - test_CNetwork.CPP
    - test_CPtrArray.cpp
    - test_CQueue.cpp
    - test_CRandomNumberGenerator.cpp
    - test_CReedSolomonErrorCorrectionCode.cpp
    - test_CSerialFile.cpp
    - test_CString.cpp
    - test_CSystemTime.cpp
    - test_CUIntArray.cpp
    - test_CUUCoding.cpp
    - test_CWordArray.cpp
    - test_CXMLDocument.cpp
    - test_XML.cpp
    - TEVNTLOG.CPP
    - TURL.CPP
    - XMLConformanceTest
      - main.cpp
      - XMLConformanceTest.dsp
      - XMLConformanceTest.dsw
      - XMLConformanceTest.h
html.zip
- HTML
  - html.cpp
  - html.dsp
  - html.dsw
  - html.mak

#include <wfc.h>
#pragma hdrstop

/*
** Author: Samuel R. Blackburn
** Internet: wfc@pobox.com
**
** You can use it any way you like as long as you don't try to sell it.
**
** Any attempt to sell WFC in source code form must have the permission
** of the original author. You can produce commercial executables with
** WFC but you can't sell WFC.
**
** Copyright, 2000, Samuel R. Blackburn
**
** $Workfile: wfc_parse_iso_8601_string.cpp $
** $Revision: 7 $
** $Modtime: 1/24/00 6:11p $
** $Reuse Tracing Code: 1 $
*/

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

static BOOL __parse_ymdhms( LPCTSTR time_string,
                            int&    year,
                            int&    month,
                            int&    day,
                            int&    hours,
                            int&    minutes,
                            int&    seconds,
                            TCHAR&  offset_character,
                            int&    offset_hours,
                            int&    offset_minutes )
{
   WFCLTRACEINIT( TEXT( "__parse_ymdhms()" ) );

   // Here's a sample ISO8601 date string
   //
   // 1969-07-20T22:56:15-04:00

   // Do a little idiot checking

   if ( time_string == NULL )
   {
      WFCTRACE( TEXT( "time string is NULL!" ) );
      return( FALSE );
   }

   // Start with some believable defaults

   year             = 0;
   month            = 1;
   day              = 1;
   hours            = 0;
   minutes          = 0;
   seconds          = 0;
   offset_character = TEXT( 'Z' );
   offset_hours     = 0;
   offset_minutes   = 0;

   // We were passed a pointer, don't trust it

   try
   {
      if ( _tcslen( time_string ) < 4 ) 
      {
         // There ain't enough characters to even attempt to parse

         WFCTRACE( TEXT( "Not enough character to even attempt to parse" ) );
         return( FALSE );
      }

      // OK, let's start parsing

      if ( _istdigit( time_string[ 0 ] ) == 0 )
      {
         WFCTRACE( TEXT( "First character is not a digit" ) );
         return( FALSE );
      }

      if ( _istdigit( time_string[ 1 ] ) == 0 )
      {
         WFCTRACE( TEXT( "Second character is not a digit" ) );
         return( FALSE );
      }

      if ( _istdigit( time_string[ 2 ] ) == 0 )
      {
         WFCTRACE( TEXT( "Third character is not a digit" ) );
         return( FALSE );
      }

      if ( _istdigit( time_string[ 3 ] ) == 0 )
      {
         WFCTRACE( TEXT( "Fourth character is not a digit" ) );
         return( FALSE );
      }

      // If we get here, it means we've got 4 good digits

      TCHAR temp_string[ 5 ];

      temp_string[ 0 ] = time_string[ 0 ];
      temp_string[ 1 ] = time_string[ 1 ];
      temp_string[ 2 ] = time_string[ 2 ];
      temp_string[ 3 ] = time_string[ 3 ];
      temp_string[ 4 ] = 0x00;

      year = _ttoi( temp_string );

      DWORD index = 4;

      // index should be pointing here
      //     |
      //     v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // We're at the end of the string

         return( TRUE );
      }

      if ( time_string[ index ] != TEXT( '-' ) )
      {
         WFCTRACE( TEXT( "The separator between year and month is not -" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //      |
      //      v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // We're at the end of the string
         return( TRUE );
      }

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "First digit of month field isn't a digit at all" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //       |
      //       v
      // 1969-07-20T22:56:15-04:00

      // This test is safe because we could be sitting on a NULL

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "Second digit of month field isn't a digit at all" ) );
         return( FALSE );
      }

      temp_string[ 0 ] = time_string[ index - 1 ];
      temp_string[ 1 ] = time_string[ index ];
      temp_string[ 2 ] = 0x00;

      month = _ttoi( temp_string );

      // Do a little idiot proofing

      if ( month < 1 || month > 12 )
      {
         WFCTRACE( TEXT( "Funky month" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //        |
      //        v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         return( TRUE );
      }

      if ( time_string[ index ] != TEXT( '-' ) )
      {
         WFCTRACE( TEXT( "The separator between month and day fields is not -" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //         |
      //         v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // Odd, but not illegal
         return( TRUE );
      }

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "First digit of day field isn't a digit at all" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //          |
      //          v
      // 1969-07-20T22:56:15-04:00

      // This test is safe because we could be sitting on a NULL

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "Second digit of month field isn't a digit at all" ) );
         return( FALSE );
      }

      temp_string[ 0 ] = time_string[ index - 1 ];
      temp_string[ 1 ] = time_string[ index ];

      // We don't need to set temp_string[ 2 ] because we did that at line 158 above

      day = _ttoi( temp_string );

      // Do a very little bit of error checking

      if ( day < 1 || day > 31 )
      {
         WFCTRACE( TEXT( "Funky day" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //           |
      //           v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // Odd, but not illegal
         return( TRUE );
      }

      if ( time_string[ index ] != TEXT( 'T' ) )
      {
         WFCTRACE( TEXT( "Separator between date and time ain't T" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //            |
      //            v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // Odd, but not illegal
         return( TRUE );
      }

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "First digit of hours field isn't a digit at all" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //             |
      //             v
      // 1969-07-20T22:56:15-04:00

      // This test is safe because we could be sitting on a NULL

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "Second digit of month field isn't a digit at all" ) );
         return( FALSE );
      }

      temp_string[ 0 ] = time_string[ index - 1 ];
      temp_string[ 1 ] = time_string[ index ];

      // We don't need to set temp_string[ 2 ] because we did that at line 158 above

      hours = _ttoi( temp_string );

      index++;

      // index should be pointing here
      //              |
      //              v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // Odd, but not illegal
         return( TRUE );
      }

      if ( time_string[ index ] != TEXT( ':' ) )
      {
         WFCTRACE( TEXT( "Separator between hours and minutes ain't :" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //               |
      //               v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // Odd, but not illegal
         return( TRUE );
      }

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "First digit of time ain't no digit" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //                |
      //                v
      // 1969-07-20T22:56:15-04:00

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "First digit of time ain't no digit" ) );
         return( FALSE );
      }

      temp_string[ 0 ] = time_string[ index - 1 ];
      temp_string[ 1 ] = time_string[ index ];

      minutes = _ttoi( temp_string );

      index++;

      // index should be pointing here
      //                 |
      //                 v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         return( TRUE );
      }

      if ( time_string[ index ] != TEXT( ':' ) )
      {
         WFCTRACE( TEXT( "Separator between minutes and seconds ain't :" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //                  |
      //                  v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 )
      {
         // Odd, but not illegal
         return( TRUE );
      }

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "First digit of seconds ain't no digit" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //                   |
      //                   v
      // 1969-07-20T22:56:15-04:00

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "Second digit of seconds ain't no digit" ) );
         return( FALSE );
      }

      temp_string[ 0 ] = time_string[ index - 1 ];
      temp_string[ 1 ] = time_string[ index ];

      seconds = _ttoi( temp_string );

      index++;

      // index should be pointing here
      //                    |
      //                    v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] == 0x00 ||
           time_string[ index ] == TEXT( 'Z' ) )
      {
         return( TRUE );
      }

      // OK, now is the time when parsing gets interesting
      // The current index may be sitting on a partial second.
      // Since CTime can't deal with partial seconds, we
      // will just skip that part entirely.

      if ( time_string[ index ] == TEXT( '.' ) )
      {
         index++;

         BOOL exit_loop = FALSE;

         while( exit_loop == FALSE )
         {
            if ( time_string[ index ] == 0x00 )
            {
               return( TRUE );
            }

            if ( _istdigit( time_string[ index ] ) == 0 )
            {
               exit_loop = TRUE;
            }
            else
            {
               index++;
            }
         }
      }

      // If we get here, we should be sitting on a Z, + or -

      if ( time_string[ index ] == TEXT( 'Z' ) )
      {
         return( TRUE );
      }

      if ( time_string[ index ] != TEXT( '+' ) &&
           time_string[ index ] != TEXT( '-' ) )
      {
         WFCTRACE( TEXT( "Time zone designator ain't beginning with + or -" ) );
         return( FALSE );
      }

      offset_character = time_string[ index ];

      index++;

      // index should be pointing here
      //                     |
      //                     v
      // 1969-07-20T22:56:15-04:00

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "first digit of hours offset ain't a digit" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //                      |
      //                      v
      // 1969-07-20T22:56:15-04:00

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "second digit of hours offset ain't a digit" ) );
         return( FALSE );
      }

      temp_string[ 0 ] = time_string[ index - 1 ];
      temp_string[ 1 ] = time_string[ index ];

      offset_hours = _ttoi( temp_string );

      index++;

      // index should be pointing here
      //                       |
      //                       v
      // 1969-07-20T22:56:15-04:00

      if ( time_string[ index ] != TEXT( ':' ) )
      {
         WFCTRACE( TEXT( "Separator between offset hours and minutes ain't a :" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //                        |
      //                        v
      // 1969-07-20T22:56:15-04:00

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "First digit of minutes offset ain't a digit" ) );
         return( FALSE );
      }

      index++;

      // index should be pointing here
      //                        |
      //                        v
      // 1969-07-20T22:56:15-04:00

      if ( _istdigit( time_string[ index ] ) == 0 )
      {
         WFCTRACE( TEXT( "Second digit of minutes offset ain't a digit" ) );
         return( FALSE );
      }

      temp_string[ 0 ] = time_string[ index - 1 ];
      temp_string[ 1 ] = time_string[ index ];

      offset_minutes = _ttoi( temp_string );

      return( TRUE );
   }
   catch( ... )
   {
      return( FALSE );
   }
}

BOOL PASCAL wfc_parse_iso_8601_string( LPCTSTR time_string, CFileTime& the_time )
{
   WFCLTRACEINIT( TEXT( "wfc_parse_iso_8601_string( CFileTime )" ) );

   the_time.Empty();

   CSystemTime system_time;

   if ( wfc_parse_iso_8601_string( time_string, system_time ) == FALSE )
   {
      return( FALSE );
   }

   the_time = system_time;

   return( TRUE );
}

#if ! defined( WFC_STL )

BOOL PASCAL wfc_parse_iso_8601_string( LPCTSTR time_string, COleDateTime& the_time )
{
   WFCLTRACEINIT( TEXT( "wfc_parse_iso_8601_string( COleDateTime )" ) );

   the_time = COleDateTime( static_cast< time_t >( 0 ) );

   // Do a little idiot checking

   if ( time_string == NULL )
   {
      WFCTRACE( TEXT( "time_string is NULL!" ) );
      return( FALSE );
   }

   int year    = 0;
   int month   = 0;
   int day     = 0;
   int hours   = 0;
   int minutes = 0;
   int seconds = 0;

   TCHAR offset_character = 0;

   int offset_hours   = 0;
   int offset_minutes = 0;

   if ( __parse_ymdhms( time_string, year, month, day, hours, minutes, seconds, offset_character, offset_hours, offset_minutes ) == FALSE )
   {
      WFCTRACE( TEXT( "Can't parse string" ) );
      return( FALSE );
   }

   the_time = COleDateTime( year, month, day, hours, minutes, seconds );

   if ( offset_character != TEXT( 'Z' ) )
   {
      COleDateTimeSpan time_zone_offset( 0, offset_hours, offset_minutes, 0 );

      if ( offset_character == TEXT( '-' ) )
      {
         the_time += time_zone_offset;
      }
      else if ( offset_character == TEXT( '+' ) )
      {
         the_time -= time_zone_offset;
      }
   }

   return( TRUE );
}

#endif // WFC_STL

BOOL PASCAL wfc_parse_iso_8601_string( LPCTSTR time_string, CSystemTime& the_time )
{
   WFCLTRACEINIT( TEXT( "wfc_parse_iso_8601_string( CSystemTime )" ) );

   the_time.Empty();

   // Do a little idiot checking

   if ( time_string == NULL )
   {
      WFCTRACE( TEXT( "time_string is NULL!" ) );
      return( FALSE );
   }

   int year    = 0;
   int month   = 0;
   int day     = 0;
   int hours   = 0;
   int minutes = 0;
   int seconds = 0;

   TCHAR offset_character = 0;

   int offset_hours   = 0;
   int offset_minutes = 0;

   if ( __parse_ymdhms( time_string, year, month, day, hours, minutes, seconds, offset_character, offset_hours, offset_minutes ) == FALSE )
   {
      WFCTRACE( TEXT( "Can't parse string" ) );
      return( FALSE );
   }

   CTime ole_time = CTime( year, month, day, hours, minutes, seconds );

   if ( offset_character != TEXT( 'Z' ) )
   {
      CTimeSpan time_zone_offset( 0, offset_hours, offset_minutes, 0 );

      if ( offset_character == TEXT( '-' ) )
      {
         ole_time += time_zone_offset;
      }
      else if ( offset_character == TEXT( '+' ) )
      {
         ole_time -= time_zone_offset;
      }
   }

   the_time = ole_time;

   return( TRUE );
}

BOOL PASCAL wfc_parse_iso_8601_string( LPCTSTR time_string, CTime& the_time )
{
   WFCLTRACEINIT( TEXT( "wfc_parse_iso_8601_string( CTime )" ) );

   the_time = CTime( static_cast< time_t >( 0 ) );

   // Do a little idiot checking

   if ( time_string == NULL )
   {
      WFCTRACE( TEXT( "time_string is NULL!" ) );
      return( FALSE );
   }

   int year    = 0;
   int month   = 0;
   int day     = 0;
   int hours   = 0;
   int minutes = 0;
   int seconds = 0;

   TCHAR offset_character = 0;

   int offset_hours   = 0;
   int offset_minutes = 0;

   if ( __parse_ymdhms( time_string, year, month, day, hours, minutes, seconds, offset_character, offset_hours, offset_minutes ) == FALSE )
   {
      WFCTRACE( TEXT( "Can't parse string" ) );
      return( FALSE );
   }

   the_time = CTime( year, month, day, hours, minutes, seconds );

   if ( offset_character != TEXT( 'Z' ) )
   {
      CTimeSpan time_zone_offset( 0, offset_hours, offset_minutes, 0 );

      if ( offset_character == TEXT( '-' ) )
      {
         the_time += time_zone_offset;
      }
      else if ( offset_character == TEXT( '+' ) )
      {
         the_time -= time_zone_offset;
      }
   }

   return( TRUE );
}

// End of source

#if 0
<HTML>

<HEAD>
<TITLE>WFC - wfc_parse_iso_8601_string</TITLE>
<META name="keywords" content="WFC, MFC extension library, freeware class library, Win32">
<META name="description" content="Simple C function that parses a time string (in ISO8601 format) into a CTime object.">
</HEAD>

<BODY>

<H1>wfc_parse_iso_8601_string</H1>
$Revision: 7 $<HR>

<H2>Declaration</H2>
<PRE>BOOL <B>wfc_parse_iso_8601_string</B>( LPCTSTR time_string, CFileTime&amp;    the_time )
BOOL <B>wfc_parse_iso_8601_string</B>( LPCTSTR time_string, COleDateTime&amp; the_time )
BOOL <B>wfc_parse_iso_8601_string</B>( LPCTSTR time_string, CSystemTime&amp;  the_time )
BOOL <B>wfc_parse_iso_8601_string</B>( LPCTSTR time_string, CTime&amp;        the_time )</PRE>

<H2>Description</H2>
This function parses <CODE>time_string</CODE> and puts the results into <CODE>the_time</CODE>.

<H2>Example</H2>

<PRE><CODE>void test_time( void )
{
   <A HREF="WfcTrace.htm">WFCTRACEINIT</A>( TEXT( &quot;test_time()&quot; ) );

   CTime the_time;

   if ( <B>wfc_parse_iso_8601_string</B>( the_time ) == FALSE )
   {
      _tprintf( TEXT( &quot;Can't parse\n&quot; ) );
   }
   else
   {
      _tprintf( TEXT( &quot;Parsed OK\n&quot; ) );
   }

}</CODE></PRE>

<H2>API's Used</H2>
<B>wfc_get_operating_system_version_string</B>() uses the following API's:
<UL>
<LI>GetVersionEx
</UL>

<HR><I>Copyright, 2000, <A HREF="mailto:wfc@pobox.com">Samuel R. Blackburn</A></I><BR>
$Workfile: wfc_parse_iso_8601_string.cpp $<BR>
$Modtime: 1/24/00 6:11p $
</BODY>

</HTML>
#endif

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Written By

Sam Blackburn

United States

I'm just a simple little NT programmer. Most of the work I do is remote controlling equipment in real time. I started out using Windows 3.0. Then came 3.1 and then NT. I started using NT but unfortunately, Microsoft didn't. I started using MFC but unfortunately, Microsoft didn't (and still doesn't) put any real support for NT into MFC so I wrote a bunch of C++ classes to make my life easier. Like all class libraries, mine grew. Now I'm giving it away, I call it Win32 Foundation Classes.

Check out Sam's homepage at www.SamBlackburn.com/wfc/.

The Win32 Foundation Classes (WFC) - Version 45

License

Comments and Discussions