pod/perlintern.pod

   1 =head1 NAME
   2
   3 perlintern - autogenerated documentation of purely B<internal>
   4                  Perl functions
   5
   6 =head1 DESCRIPTION
   7
   8 This file is the autogenerated documentation of functions in the
   9 Perl interpreter that are documented using Perl's internal documentation
  10 format but are not marked as part of the Perl API. In other words,
  11 B<they are not for use in extensions>!
  12
  13 =over 8
  14
  15 =item djSP
  16
  17 Declare Just C<SP>. This is actually identical to C<dSP>, and declares
  18 a local copy of perl's stack pointer, available via the C<SP> macro.
  19 See C<SP>.  (Available for backward source code compatibility with the
  20 old (Perl 5.005) thread model.)
  21
  22                 djSP;
  23
  24 =for hackers
  25 Found in file pp.h
  26
  27 =item is_gv_magical
  28
  29 Returns C<TRUE> if given the name of a magical GV.
  30
  31 Currently only useful internally when determining if a GV should be
  32 created even in rvalue contexts.
  33
  34 C<flags> is not used at present but available for future extension to
  35 allow selecting particular classes of magical variable.
  36
  37         bool    is_gv_magical(char *name, STRLEN len, U32 flags)
  38
  39 =for hackers
  40 Found in file gv.c
  41
  42 =item LVRET
  43
  44 True if this op will be the return value of an lvalue subroutine
  45
  46 =for hackers
  47 Found in file pp.h
  48
  49 =item PL_DBsingle
  50
  51 When Perl is run in debugging mode, with the B<-d> switch, this SV is a
  52 boolean which indicates whether subs are being single-stepped.
  53 Single-stepping is automatically turned on after every step.  This is the C
  54 variable which corresponds to Perl's $DB::single variable.  See
  55 C<PL_DBsub>.
  56
  57         SV *    PL_DBsingle
  58
  59 =for hackers
  60 Found in file intrpvar.h
  61
  62 =item PL_DBsub
  63
  64 When Perl is run in debugging mode, with the B<-d> switch, this GV contains
  65 the SV which holds the name of the sub being debugged.  This is the C
  66 variable which corresponds to Perl's $DB::sub variable.  See
  67 C<PL_DBsingle>.
  68
  69         GV *    PL_DBsub
  70
  71 =for hackers
  72 Found in file intrpvar.h
  73
  74 =item PL_DBtrace
  75
  76 Trace variable used when Perl is run in debugging mode, with the B<-d>
  77 switch.  This is the C variable which corresponds to Perl's $DB::trace
  78 variable.  See C<PL_DBsingle>.
  79
  80         SV *    PL_DBtrace
  81
  82 =for hackers
  83 Found in file intrpvar.h
  84
  85 =item PL_dowarn
  86
  87 The C variable which corresponds to Perl's $^W warning variable.
  88
  89         bool    PL_dowarn
  90
  91 =for hackers
  92 Found in file intrpvar.h
  93
  94 =item PL_last_in_gv
  95
  96 The GV which was last used for a filehandle input operation. (C<< <FH> >>)
  97
  98         GV*     PL_last_in_gv
  99
 100 =for hackers
 101 Found in file thrdvar.h
 102
 103 =item PL_ofs_sv
 104
 105 The output field separator - C<$,> in Perl space.
 106
 107         SV*     PL_ofs_sv
 108
 109 =for hackers
 110 Found in file thrdvar.h
 111
 112 =item PL_rs
 113
 114 The input record separator - C<$/> in Perl space.
 115
 116         SV*     PL_rs
 117
 118 =for hackers
 119 Found in file thrdvar.h
 120
 121 =item start_glob
 122
 123 Function called by C<do_readline> to spawn a glob (or do the glob inside
 124 perl on VMS). This code used to be inline, but now perl uses C<File::Glob>
 125 this glob starter is only used by miniperl during the build proccess.
 126 Moving it away shrinks pp_hot.c; shrinking pp_hot.c helps speed perl up.
 127
 128         PerlIO* start_glob(SV* pattern, IO *io)
 129
 130 =for hackers
 131 Found in file doio.c
 132
 133 =back
 134
 135 =head1 AUTHORS
 136
 137 The autodocumentation system was originally added to the Perl core by
 138 Benjamin Stuhl. Documentation is by whoever was kind enough to
 139 document their functions.
 140
 141 =head1 SEE ALSO
 142
 143 perlguts(1), perlapi(1)
 144