Subversion Repositories svn1-original

/*************************************************************************

*       Copyright (C) 1995 Embbedded Solutions

*                       All rights reserved

*

* file:     src\times.c

*

* purpose:  This module contains routines associated with the

*           time calculations

*

*           As the storage and display of a time is machine dependent so

*           these routines may need to be altered

*

* functions

*       time_a                  - Convert time to ascii

*       time_fa                 - Convert time to ascii

*       conv_time               - Convert hh,mm,ss to time

*       get_time                - Read/Edit time from user

*

* programmer: David Purdie

*

* revision  date        by      reason

*           17-Oct-88   DDP     Added new routine time_fa()

*   00.0    27/01/95    DDP     Tidies up the program and formatted the file

*   01.0    18/09/2005  DDP     Allow editing of time fields

*                               Simplied the conversion of text to time

*

**************************************************************************/

#include    <ctype.h>

#include    <time.h>

#include    "consts.h"

#include    "structs.h"

#include    "proto.h"

/*========================================================================

 *

 *  Convert time to ascii

 *

 *  Purpose:

 *      This routine will convert the time ( as held in tim ) into an ascii

 *      string. The address of the string is returned to the user. The

 *      string is internally static and is of a fixed format

 *

 *      The string format is

 *

 *      HH:MM:SS(null)  - if the time is valid.

 *      ** ** **(null)  - if the time is unknown

 * 

 *

 *  Parameters:

 *      tim         Time to convert

 *

 *  Returns:

 *      Address of an internal buffer that holds the ascii time

 *

 *========================================================================*/

char       *time_a( time_t tim )

{

    static char buf[] = "00:00:00";              /* Hold return string here */

    static char invalid[] = "** ** **";          /* Invalid string */

    time_t      hours, mins, secs;

    if( tim >= 0 && tim < 359999L )

    {

        hours = tim / 3600L;                     /* Calc the hours */

        tim -= hours * 3600L;                    /* secs left */

        mins = tim / 60L;

        tim -= mins * 60L;

        secs = tim;

        sprintf( buf, "%2.2ld:%2.2ld:%2.2ld", hours, mins, secs );

        return ( buf );

    }

    else

        return ( invalid );

}

/*========================================================================

 *

 *  Convert time to ascii

 *

 *  Purpose:

 *      This routine will convert the time ( as held in tim ) into an ascii

 *      string. The address of the string is returned to the user. The

 *      string is internally static and is of a fixed format

 *

 *      The string format is

 *

 *      HH:MM:SS(null)  - if the time is valid.

 *      -- -- --(null)  - if the time is unknown and "flag" is true

 *      ** ** **(null)  - if the time is unknown and flag is false

 *

 *

 *  Parameters:

 *      tim         Time to convert

 *      flag        Control display if time is not valid

 *                      TRUE  "-- -- --"

 *                      FALSE "** ** **"

 *

 *  Returns:

 *      Address of an internal buffer that holds the ascii time

 *

 *========================================================================*/

char       *time_fa( time_t tim, char flag )

{

    static char buf1[] = "00:00:00";             /* Hold return string here */

    static char finvalid[] = "** ** **";         /* Invalid string */

    static char tinvalid[] = "-- -- --";

    time_t      hours, mins, secs;

    if( tim >= 0 && tim < 359999L )

    {

        hours = tim / 3600L;                     /* Calc the hours */

        tim -= hours * 3600L;                    /* secs left */

        mins = tim / 60L;

        tim -= mins * 60L;

        secs = tim;

        sprintf( buf1, "%2.2ld:%2.2ld:%2.2ld", hours, mins, secs );

        return ( buf1 );

    }

    else if( flag )

    {

        return ( tinvalid );

    }

    else

    {

        return ( finvalid );

    }

}

/*========================================================================

 *

 *  Convert hh,mm,ss to time

 *

 *  Purpose:

 *      This function is convert hours, mins and seconds into the internal

 *      format of time

 *

 *  Parameters:

 *      hh          hours 0..

 *      mm          minutes 0..59

 *      ss          Seconds 0..59

 *

 *  Returns:

 *      Time

 *

 *========================================================================*/

time_t conv_time( int hh, int mm, int ss )

{

    time_t      time;                            /* The final result */

    time = ( ( ( time_t ) hh * 60L ) + ( time_t ) mm ) * 60L + ( time_t ) ss;

    return ( time );

}

/*========================================================================

 *

 *  Read/Edit time from user

 *

 *  Purpose:

 *      This function is called accept a time field from user and allow

 *      the operator to edit the time as it is entered.

 *

 *  Parameters:

 *      tim         - Time to edit

 *

 *  Returns:

 *      Time entered

 *      Will return an illegal time if the entry is not complete

 *

 *========================================================================*/

time_t get_time(time_t utim)

{

    char        c;                              /* One of those */

    int         i = 0;                          /* Counts user input */

    int         maxi = 0;                       /* Max user input */

    static char buf[] = "00:00:00";             /* Build up a string here */

    static char max_digit[] = "29:59:59";       /* Maximum digit's allowed in entry */

    int         hh = 0, mm = 0, ss = 0;

    /*

    **  Insert the base time into the edit buffer

    **  Invalid times are treated as 00:00:00

    */

    if ( utim == -1L )

    {

        utim = 0;

    }

    {

        char * ctime;

        ctime = time_a(utim);

        if ( ctime[0] != '*' )

            memcpy( buf, ctime, sizeof(buf)-1);

        else

            memcpy( buf, "00:00:00", sizeof(buf)-1);

    }

    /*

    **  Edit the string

    */

    while( TRUE )

    {

        c = getinp();

        if( c == ABORT_CHAR )

        {

            i = 0;

            break;

        }

        if( c == '\n' || c == '\t' )

            break;

        if( ( c == rubout ) && i > 0 )           /* rubout character */

        {

            i--;

            if( max_digit[i] == ':' )

            {

                printf( "\010:\010" );

                buf[i--] = ':';

            }

            buf[i] = '0';

            printf( "\010" "0" "\010" );

        }

        else if ( (c == (char)LEFTARROW)  && i > 0 )

        {

            i--;

            if( max_digit[i] == ':' )

            {

                printf( "\010" );

                buf[i--] = ':';

            }

            printf( "\010" );

        }

        else if ( (c == (char)DELETE_KEY)  && i < 8 )

        {

            buf[i]='0';

            printf( "0" "\010");

        }

        else if ( (c == (char)RIGHTARROW)  && i < 8 )

        {

            printf( "%c", buf[i++] );

            if( max_digit[i] == ':' )

            {

                printf( ":" );

                buf[i++] = ':';

            }

        }

        else if( ( i < 9 ) && isascii( c ) && isdigit( c )

                 && max_digit[i] >= c )

        {

            printf( "%c", c );

            buf[i++] = c;

            if( max_digit[i] == ':' )

            {

                printf( ":" );

                buf[i++] = ':';

            }

        }

        else

        {

            beep();

        }

        if ( i > maxi )

            maxi = i;

    }

    if( maxi > 0 )

    {

        /*

         * Parse the buffer extracting the required fields

         */

        if( sscanf( buf, "%d:%d:%d", &hh, &mm, &ss ) == 3 )

        {

            return ( conv_time( hh, mm, ss ) );

        }

    }

    return ( ( time_t ) -1L );

}

/********************************* EOF ***********************************/