This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: Refactor placements, headings of some functions
[perl5.git] / util.h
CommitLineData
a0d0e21e 1/* util.h
a687059c 2 *
663f364b
NC
3 * Copyright (C) 1991, 1992, 1993, 1999, 2001, 2002, 2003, 2004, 2005,
4 * 2007, by Larry Wall and others
a687059c 5 *
d48672a2
LW
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
8d063cd8 8 *
8d063cd8 9 */
57843af0
GS
10
11#ifdef VMS
12# define PERL_FILE_IS_ABSOLUTE(f) \
13 (*(f) == '/' \
14 || (strchr(f,':') \
15 || ((*(f) == '[' || *(f) == '<') \
0eb30aeb 16 && (isWORDCHAR((f)[1]) || strchr("$-_]>",(f)[1])))))
57843af0
GS
17
18#else /* !VMS */
546cd220 19# if defined(WIN32) || defined(__CYGWIN__)
57843af0 20# define PERL_FILE_IS_ABSOLUTE(f) \
f2ed23b0
GS
21 (*(f) == '/' || *(f) == '\\' /* UNC/rooted path */ \
22 || ((f)[0] && (f)[1] == ':')) /* drive name */
57843af0 23# else /* !WIN32 */
2986a63f
JH
24# ifdef NETWARE
25# define PERL_FILE_IS_ABSOLUTE(f) \
26 (((f)[0] && (f)[1] == ':') /* drive name */ \
27 || ((f)[0] == '\\' && (f)[1] == '\\') /* UNC path */ \
28 || ((f)[3] == ':')) /* volume name, currently only sys */
29# else /* !NETWARE */
739a0b84 30# if defined(DOSISH) || defined(__SYMBIAN32__)
57843af0
GS
31# define PERL_FILE_IS_ABSOLUTE(f) \
32 (*(f) == '/' \
33 || ((f)[0] && (f)[1] == ':')) /* drive name */
739a0b84 34# else /* NEITHER DOSISH NOR SYMBIANISH */
e37778c2 35# define PERL_FILE_IS_ABSOLUTE(f) (*(f) == '/')
57843af0 36# endif /* DOSISH */
2986a63f 37# endif /* NETWARE */
57843af0
GS
38# endif /* WIN32 */
39#endif /* VMS */
e9a8c099
MHM
40
41/*
dcccc8ff
KW
42=head1 Miscellaneous Functions
43
e6226b18
KW
44=for apidoc ibcmp
45
46This is a synonym for (! foldEQ())
47
48=for apidoc ibcmp_locale
49
50This is a synonym for (! foldEQ_locale())
51
52=cut
53*/
54#define ibcmp(s1, s2, len) cBOOL(! foldEQ(s1, s2, len))
55#define ibcmp_locale(s1, s2, len) cBOOL(! foldEQ_locale(s1, s2, len))
56
cb4d37a7
NC
57/* outside the core, perl.h undefs HAS_QUAD if IV isn't 64-bit
58 We can't swap this to HAS_QUAD, because the logic here affects the type of
59 perl_drand48_t below, and that is visible outside of the core. */
9ea40801 60#if defined(U64TYPE) && !defined(USING_MSVC6)
63835f79
SH
61/* use a faster implementation when quads are available,
62 * but not with VC6 on Windows */
63# define PERL_DRAND48_QUAD
3be8f094
TC
64#endif
65
66#ifdef PERL_DRAND48_QUAD
67
68/* U64 is only defined under PERL_CORE, but this needs to be visible
69 * elsewhere so the definition of PerlInterpreter is complete.
70 */
71typedef U64TYPE perl_drand48_t;
72
73#else
74
75struct PERL_DRAND48_T {
76 U16 seed[3];
77};
78
79typedef struct PERL_DRAND48_T perl_drand48_t;
80
81#endif
82
83#define PL_RANDOM_STATE_TYPE perl_drand48_t
84
85#define Perl_drand48_init(seed) (Perl_drand48_init_r(&PL_random_state, (seed)))
86#define Perl_drand48() (Perl_drand48_r(&PL_random_state))
e6226b18
KW
87
88/*
e9a8c099
MHM
89 * Local variables:
90 * c-indentation-style: bsd
91 * c-basic-offset: 4
14d04a33 92 * indent-tabs-mode: nil
e9a8c099
MHM
93 * End:
94 *
14d04a33 95 * ex: set ts=8 sts=4 sw=4 et:
e9a8c099 96 */