/usr/include/kholidays/astroseasons.h is in kdepimlibs5-dev 4:4.14.2-2+deb8u2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 | /*
This file is part of the kholidays library.
Copyright (c) 2004,2006-2007 Allen Winter <winter@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef KHOLIDAYS_ASTROSEASONS_H
#define KHOLIDAYS_ASTROSEASONS_H
/**
Represents and manages the Astronomical Seasons (solstices and equinoxes).
For the purposes of this class, we sometimes use the shorthand of "Season"
where we really mean "Astronomical Season".
An Astronomical Season can be one of the following:
- June solstice
- December solstice
- March equinox
- September equinox
A very good description of the astronomical seasons can be read at the
Wikipedia,
http://en.wikipedia.org/wiki/Seasons
Note that this class represents the "Astronomical Seasons" and not
the traditional "Seasons" which vary widely by culture.
*/
#include "kholidays_export.h"
class QDate;
class QString;
namespace KHolidays {
class KHOLIDAYS_EXPORT AstroSeasons //krazy:exclude=dpointer
{
public:
enum Season {
JuneSolstice,
DecemberSolstice,
MarchEquinox,
SeptemberEquinox,
None
};
/**
Return the season for the specified Gregorian date.
The enum 'None' is returned if one of the supported seasons
does not occur on the date.
@param date compute the season for the specified Gregorian date.
*/
static Season seasonAtDate( const QDate &date );
/**
Return the season as a text string for the specified date.
A null string is returned if one of the supported seasons does
not occur on the date.
@param date compute the season for the specified Gregorian date.
*/
static QString seasonNameAtDate( const QDate &date );
/**
Return the string representation of season.
@param season astronomical season.
*/
static QString seasonName( Season season );
};
}
#endif
|