perlapi.pod

MSYS在windows下模拟了一个类unix的终端

=for hackers
Found in file sv.h

=item SvIOK_UV

Returns a boolean indicating whether the SV contains an unsigned integer.

	void	SvIOK_UV(SV* sv)

=for hackers
Found in file sv.h

=item SvIV

Coerces the given SV to an integer and returns it.

	IV	SvIV(SV* sv)

=for hackers
Found in file sv.h

=item SvIVX

Returns the integer which is stored in the SV, assuming SvIOK is
true.

	IV	SvIVX(SV* sv)

=for hackers
Found in file sv.h

=item SvLEN

Returns the size of the string buffer in the SV, not including any part
attributable to C<SvOOK>.  See C<SvCUR>.

	STRLEN	SvLEN(SV* sv)

=for hackers
Found in file sv.h

=item SvNIOK

Returns a boolean indicating whether the SV contains a number, integer or
double.

	bool	SvNIOK(SV* sv)

=for hackers
Found in file sv.h

=item SvNIOKp

Returns a boolean indicating whether the SV contains a number, integer or
double.  Checks the B<private> setting.  Use C<SvNIOK>.

	bool	SvNIOKp(SV* sv)

=for hackers
Found in file sv.h

=item SvNIOK_off

Unsets the NV/IV status of an SV.

	void	SvNIOK_off(SV* sv)

=for hackers
Found in file sv.h

=item SvNOK

Returns a boolean indicating whether the SV contains a double.

	bool	SvNOK(SV* sv)

=for hackers
Found in file sv.h

=item SvNOKp

Returns a boolean indicating whether the SV contains a double.  Checks the
B<private> setting.  Use C<SvNOK>.

	bool	SvNOKp(SV* sv)

=for hackers
Found in file sv.h

=item SvNOK_off

Unsets the NV status of an SV.

	void	SvNOK_off(SV* sv)

=for hackers
Found in file sv.h

=item SvNOK_on

Tells an SV that it is a double.

	void	SvNOK_on(SV* sv)

=for hackers
Found in file sv.h

=item SvNOK_only

Tells an SV that it is a double and disables all other OK bits.

	void	SvNOK_only(SV* sv)

=for hackers
Found in file sv.h

=item SvNV

Coerce the given SV to a double and return it.

	NV	SvNV(SV* sv)

=for hackers
Found in file sv.h

=item SvNVX

Returns the double which is stored in the SV, assuming SvNOK is
true.

	NV	SvNVX(SV* sv)

=for hackers
Found in file sv.h

=item SvOK

Returns a boolean indicating whether the value is an SV.

	bool	SvOK(SV* sv)

=for hackers
Found in file sv.h

=item SvOOK

Returns a boolean indicating whether the SvIVX is a valid offset value for
the SvPVX.  This hack is used internally to speed up removal of characters
from the beginning of a SvPV.  When SvOOK is true, then the start of the
allocated string buffer is really (SvPVX - SvIVX).

	bool	SvOOK(SV* sv)

=for hackers
Found in file sv.h

=item SvPOK

Returns a boolean indicating whether the SV contains a character
string.

	bool	SvPOK(SV* sv)

=for hackers
Found in file sv.h

=item SvPOKp

Returns a boolean indicating whether the SV contains a character string.
Checks the B<private> setting.  Use C<SvPOK>.

	bool	SvPOKp(SV* sv)

=for hackers
Found in file sv.h

=item SvPOK_off

Unsets the PV status of an SV.

	void	SvPOK_off(SV* sv)

=for hackers
Found in file sv.h

=item SvPOK_on

Tells an SV that it is a string.

	void	SvPOK_on(SV* sv)

=for hackers
Found in file sv.h

=item SvPOK_only

Tells an SV that it is a string and disables all other OK bits.

	void	SvPOK_only(SV* sv)

=for hackers
Found in file sv.h

=item SvPOK_only_UTF8

Tells an SV that it is a UTF8 string (do not use frivolously)
and disables all other OK bits.
  
	void	SvPOK_only_UTF8(SV* sv)

=for hackers
Found in file sv.h

=item SvPV

Returns a pointer to the string in the SV, or a stringified form of the SV
if the SV does not contain a string.  Handles 'get' magic.

	char*	SvPV(SV* sv, STRLEN len)

=for hackers
Found in file sv.h

=item SvPVX

Returns a pointer to the string in the SV.  The SV must contain a
string.

	char*	SvPVX(SV* sv)

=for hackers
Found in file sv.h

=item SvPV_force

Like <SvPV> but will force the SV into becoming a string (SvPOK).  You want
force if you are going to update the SvPVX directly.

	char*	SvPV_force(SV* sv, STRLEN len)

=for hackers
Found in file sv.h

=item SvPV_nolen

Returns a pointer to the string in the SV, or a stringified form of the SV
if the SV does not contain a string.  Handles 'get' magic.

	char*	SvPV_nolen(SV* sv)

=for hackers
Found in file sv.h

=item SvREFCNT

Returns the value of the object's reference count.

	U32	SvREFCNT(SV* sv)

=for hackers
Found in file sv.h

=item SvREFCNT_dec

Decrements the reference count of the given SV.

	void	SvREFCNT_dec(SV* sv)

=for hackers
Found in file sv.h

=item SvREFCNT_inc

Increments the reference count of the given SV.

	SV*	SvREFCNT_inc(SV* sv)

=for hackers
Found in file sv.h

=item SvROK

Tests if the SV is an RV.

	bool	SvROK(SV* sv)

=for hackers
Found in file sv.h

=item SvROK_off

Unsets the RV status of an SV.

	void	SvROK_off(SV* sv)

=for hackers
Found in file sv.h

=item SvROK_on

Tells an SV that it is an RV.

	void	SvROK_on(SV* sv)

=for hackers
Found in file sv.h

=item SvRV

Dereferences an RV to return the SV.

	SV*	SvRV(SV* sv)

=for hackers
Found in file sv.h

=item SvSETMAGIC

Invokes C<mg_set> on an SV if it has 'set' magic.  This macro evaluates its
argument more than once.

	void	SvSETMAGIC(SV* sv)

=for hackers
Found in file sv.h

=item SvSetSV

Calls C<sv_setsv> if dsv is not the same as ssv.  May evaluate arguments
more than once.

	void	SvSetSV(SV* dsb, SV* ssv)

=for hackers
Found in file sv.h

=item SvSetSV_nosteal

Calls a non-destructive version of C<sv_setsv> if dsv is not the same as
ssv. May evaluate arguments more than once.

	void	SvSetSV_nosteal(SV* dsv, SV* ssv)

=for hackers
Found in file sv.h

=item SvSTASH

Returns the stash of the SV.

	HV*	SvSTASH(SV* sv)

=for hackers
Found in file sv.h

=item SvTAINT

Taints an SV if tainting is enabled

	void	SvTAINT(SV* sv)

=for hackers
Found in file sv.h

=item SvTAINTED

Checks to see if an SV is tainted. Returns TRUE if it is, FALSE if
not.

	bool	SvTAINTED(SV* sv)

=for hackers
Found in file sv.h

=item SvTAINTED_off

Untaints an SV. Be I<very> careful with this routine, as it short-circuits
some of Perl's fundamental security features. XS module authors should not
use this function unless they fully understand all the implications of
unconditionally untainting the value. Untainting should be done in the
standard perl fashion, via a carefully crafted regexp, rather than directly
untainting variables.

	void	SvTAINTED_off(SV* sv)

=for hackers
Found in file sv.h

=item SvTAINTED_on

Marks an SV as tainted.

	void	SvTAINTED_on(SV* sv)

=for hackers
Found in file sv.h

=item SvTRUE

Returns a boolean indicating whether Perl would evaluate the SV as true or
false, defined or undefined.  Does not handle 'get' magic.

	bool	SvTRUE(SV* sv)

=for hackers
Found in file sv.h

=item svtype

An enum of flags for Perl types.  These are found in the file B<sv.h> 
in the C<svtype> enum.  Test these flags with the C<SvTYPE> macro.

=for hackers
Found in file sv.h

=item SvTYPE

Returns the type of the SV.  See C<svtype>.

	svtype	SvTYPE(SV* sv)

=for hackers
Found in file sv.h

=item SVt_IV

Integer type flag for scalars.  See C<svtype>.

=for hackers
Found in file sv.h

=item SVt_NV

Double type flag for scalars.  See C<svtype>.

=for hackers
Found in file sv.h

=item SVt_PV

Pointer type flag for scalars.  See C<svtype>.

=for hackers
Found in file sv.h

=item SVt_PVAV

Type flag for arrays.  See C<svtype>.

=for hackers
Found in file sv.h

=item SVt_PVCV

Type flag for code refs.  See C<svtype>.

=for hackers
Found in file sv.h

=item SVt_PVHV

Type flag for hashes.  See C<svtype>.

=for hackers
Found in file sv.h

=item SVt_PVMG

Type flag for blessed scalars.  See C<svtype>.

=for hackers
Found in file sv.h

=item SvUPGRADE

Used to upgrade an SV to a more complex form.  Uses C<sv_upgrade> to
perform the upgrade if necessary.  See C<svtype>.

	void	SvUPGRADE(SV* sv, svtype type)

=for hackers
Found in file sv.h

=item SvUTF8

Returns a boolean indicating whether the SV contains UTF-8 encoded data.

	void	SvUTF8(SV* sv)

=for hackers
Found in file sv.h

=item SvUTF8_off

Unsets the UTF8 status of an SV.

	void	SvUTF8_off(SV *sv)

=for hackers
Found in file sv.h

=item SvUTF8_on

Tells an SV that it is a string and encoded in UTF8.  Do not use frivolously.

	void	SvUTF8_on(SV *sv)

=for hackers
Found in file sv.h

=item SvUV

Coerces the given SV to an unsigned integer and returns it.

	UV	SvUV(SV* sv)

=for hackers
Found in file sv.h

=item SvUVX

Returns the unsigned integer which is stored in the SV, assuming SvIOK is
true.

	UV	SvUVX(SV* sv)

=for hackers
Found in file sv.h

=item sv_2mortal

Marks an SV as mortal.  The SV will be destroyed when the current context
ends.

	SV*	sv_2mortal(SV* sv)

=for hackers
Found in file sv.c

=item sv_bless

Blesses an SV into a specified package.  The SV must be an RV.  The package
must be designated by its stash (see C<gv_stashpv()>).  The reference count
of the SV is unaffected.

	SV*	sv_bless(SV* sv, HV* stash)

=for hackers
Found in file sv.c

=item sv_catpv

Concatenates the string onto the end of the string which is in the SV.
Handles 'get' magic, but not 'set' magic.  See C<sv_catpv_mg>.

	void	sv_catpv(SV* sv, const char* ptr)

=for hackers
Found in file sv.c

=item sv_catpvf

Processes its arguments like C<sprintf> and appends the formatted output
to an SV.  Handles 'get' magic, but not 'set' magic.  C<SvSETMAGIC()> must
typically be called after calling this function to handle 'set' magic.

	void	sv_catpvf(SV* sv, const char* pat, ...)

=for hackers
Found in file sv.c

=item sv_catpvf_mg

Like C<sv_catpvf>, but also handles 'set' magic.

	void	sv_catpvf_mg(SV *sv, const char* pat, ...)

=for hackers
Found in file sv.c

=item sv_catpvn

Concatenates the string onto the end of the string which is in the SV.  The
C<len> indicates number of bytes to copy.  Handles 'get' magic, but not
'set' magic.  See C<sv_catpvn_mg>.

	void	sv_catpvn(SV* sv, const char* ptr, STRLEN len)

=for hackers
Found in file sv.c

=item sv_catpvn_mg

Like C<sv_catpvn>, but also handles 'set' magic.

	void	sv_catpvn_mg(SV *sv, const char *ptr, STRLEN len)

=for hackers
Found in file sv.c

=item sv_catpv_mg

Like C<sv_catpv>, but also handles 'set' magic.

	void	sv_catpv_mg(SV *sv, const char *ptr)

=for hackers
Found in file sv.c

=item sv_catsv

Concatenates the string from SV C<ssv> onto the end of the string in
SV C<dsv>.  Modifies C<dsv> but not C<ssv>.  Handles 'get' magic, but
not 'set' magic.  See C<sv_catsv_mg>.

	void	sv_catsv(SV* dsv, SV* ssv)

=for hackers
Found in file sv.c

=item sv_catsv_mg

Like C<sv_catsv>, but also handles 'set' magic.

	void	sv_catsv_mg(SV *dstr, SV *sstr)

=for hackers
Found in file sv.c

=item sv_chop

Efficient removal of characters from the beginning of the string buffer. 
SvPOK(sv) must be true and the C<ptr> must be a pointer to somewhere inside
the string buffer.  The C<ptr> becomes the first character of the adjusted
string.

	void	sv_chop(SV* sv, char* ptr)

=for hackers
Found in file sv.c

=item sv_clear