literals.h

/*********************************************************************
 *
 * Condor ClassAd library
 * Copyright (C) 1990-2003, Condor Team, Computer Sciences Department,
 * University of Wisconsin-Madison, WI and Rajesh Raman.
 *
 * This source code is covered by the Condor Public License, which can
 * be found in the accompanying LICENSE file, or online at
 * www.condorproject.org.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * AND THE UNIVERSITY OF WISCONSIN-MADISON "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY, OF SATISFACTORY QUALITY, AND FITNESS
 * FOR A PARTICULAR PURPOSE OR USE ARE DISCLAIMED. THE COPYRIGHT
 * HOLDERS AND CONTRIBUTORS AND THE UNIVERSITY OF WISCONSIN-MADISON
 * MAKE NO MAKE NO REPRESENTATION THAT THE SOFTWARE, MODIFICATIONS,
 * ENHANCEMENTS OR DERIVATIVE WORKS THEREOF, WILL NOT INFRINGE ANY
 * PATENT, COPYRIGHT, TRADEMARK, TRADE SECRET OR OTHER PROPRIETARY
 * RIGHT.
 *
 *********************************************************************/

#ifndef __LITERALS_H__
#define __LITERALS_H__

BEGIN_NAMESPACE( classad )

typedef std::vector<ExprTree*> ArgumentList;

class Literal : public ExprTree 
{
        public:
        ~Literal ();

        Literal(const Literal &literal);

        Literal &operator=(const Literal &literal);

                static Literal* MakeAbsTime( abstime_t *now=NULL );

                /* Creates an absolute time literal, from the string timestr, 
                 *parsing it as the regular expression:
                 D* dddd [D* dd [D* dd [D* dd [D* dd [D* dd D*]]]]] [-dddd | +dddd | z | Z]
                 D => non-digit, d=> digit
                 Ex - 2003-01-25T09:00:00-0600
                */
                static Literal* MakeAbsTime( std::string timestr);

                static Literal* MakeRelTime( time_t secs=-1 );

                static Literal* MakeRelTime( time_t t1, time_t t2 );

                /* Creates a relative time literal, from the string timestr, 
                 *parsing it as [[[days+]hh:]mm:]ss
                 * Ex - 1+00:02:00
                */              
                static Literal* MakeRelTime(std::string str);

                static Literal* MakeReal(std::string realstr);

                virtual ExprTree* Copy( ) const;

        void CopyFrom(const Literal &literal);

                static Literal*MakeLiteral( const Value& v, Value::NumberFactor f=
                                        Value::NO_FACTOR );

                void GetComponents( Value& v, Value::NumberFactor &f ) const;

                void GetValue( Value& v ) const;
                
                /* Takes the number of seconds since the epoch as argument - epochsecs, 
                 *and returns the timezone offset(relative to GMT) in the currect locality
                 */
                static int findOffset(time_t epochsecs);

        virtual bool SameAs(const ExprTree *tree) const;

        friend bool operator==(Literal &literal1, Literal &literal2);

        protected:
        Literal ();

        private:
                friend class FunctionCall;
                friend class ClassAd;
                friend class ExprList;
                friend class Operation;

                virtual void _SetParentScope( const ClassAd* ){ }
                virtual bool _Flatten( EvalState&, Value&, ExprTree*&, int* ) const;
                virtual bool _Evaluate (EvalState &, Value &) const;
                virtual bool _Evaluate (EvalState &, Value &, ExprTree *&) const;

                // literal specific information
        Value                           value;
                Value::NumberFactor     factor;
};

END_NAMESPACE // classad

#endif//__LITERALS_H__