ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Convert-Scalar/Scalar.pm
(Generate patch)

Comparing Convert-Scalar/Scalar.pm (file contents):
Revision 1.4 by root, Mon Sep 23 03:42:02 2002 UTC vs.
Revision 1.8 by root, Sat Apr 24 06:38:08 2004 UTC

… …
15The following export tags exist: 15The following export tags exist:
16 16
17 :utf8 all functions with utf8 in their name 17 :utf8 all functions with utf8 in their name
18 :taint all functions with taint in their name 18 :taint all functions with taint in their name
19 :refcnt all functions with refcnt in their name 19 :refcnt all functions with refcnt in their name
20 :ok all *ok-functions.
20 21
21=over 4 22=over 4
22 23
23=cut 24=cut
24 25
25package Convert::Scalar; 26package Convert::Scalar;
26 27
27BEGIN { 28BEGIN {
28 $VERSION = 0.09; 29 $VERSION = '1.0';
29 @ISA = qw(Exporter); 30 @ISA = qw(Exporter);
30 @EXPORT_OK = qw(weaken unmagic grow); 31 @EXPORT_OK = qw(weaken unmagic grow);
31 %EXPORT_TAGS = ( 32 %EXPORT_TAGS = (
32 taint => [qw(taint untaint tainted)], 33 taint => [qw(taint untaint tainted)],
33 utf8 => [qw(utf8 utf8_on utf8_off utf8_valid utf8_upgrade utf8_downgrade utf8_encode utf8_decode utf8_length)], 34 utf8 => [qw(utf8 utf8_on utf8_off utf8_valid utf8_upgrade utf8_downgrade utf8_encode utf8_decode utf8_length)],
34 refcnt => [qw(refcnt refcnt_inc refcnt_dec refcnt_rv refcnt_inc_rv refcnt_dec_rv)], 35 refcnt => [qw(refcnt refcnt_inc refcnt_dec refcnt_rv refcnt_inc_rv refcnt_dec_rv)],
36 ok => [qw(ok uok rok pok nok niok)],
35 ); 37 );
36 38
37 require Exporter; 39 require Exporter;
38 Exporter::export_ok_tags(keys %EXPORT_TAGS); 40 Exporter::export_ok_tags(keys %EXPORT_TAGS);
39 41
… …
92 94
93Returns the number of characters in the string, counting wide UTF8 95Returns the number of characters in the string, counting wide UTF8
94characters as a single character, independent of wether the scalar is 96characters as a single character, independent of wether the scalar is
95marked as containing bytes or mulitbyte characters. 97marked as containing bytes or mulitbyte characters.
96 98
97=item unmagic scalar 99=item unmagic scalar, type
98 100
99Removes magic from the scalar. 101Remove the specified magic from the scalar (DANGEROUS!).
100 102
101=item weaken scalar 103=item weaken scalar
102 104
103Weaken a reference. (See also L<WeakRef>). 105Weaken a reference. (See also L<WeakRef>).
104 106
… …
108 110
109=item tainted scalar 111=item tainted scalar
110 112
111returns true when the scalar is tainted, false otherwise. 113returns true when the scalar is tainted, false otherwise.
112 114
113=item untaint scalar, type 115=item untaint scalar
114 116
115Remove the specified magic from the scalar 117Remove the tainted flag from the specified scalar.
116(DANGEROUS!), L<perlguts>. L<Untaint>, for a similar but different
117interface.
118 118
119=item grow scalar, newlen 119=item grow scalar, newlen
120 120
121Sets the memory area used for the scalar to the given length, if the 121Sets the memory area used for the scalar to the given length, if the
122current length is less than the new value. This does not affect the 122current length is less than the new value. This does not affect the
… …
139instead if you understand what this function is fore. Better yet: don't 139instead if you understand what this function is fore. Better yet: don't
140use this module in this case. 140use this module in this case.
141 141
142=item refcnt_rv scalar[, newrefcnt] 142=item refcnt_rv scalar[, newrefcnt]
143 143
144Works like C<refcnt>, but dereferences the given reference first. Remember 144Works like C<refcnt>, but dereferences the given reference first. This is
145that taking a reference of some object increases it's reference count, so 145useful to find the reference count of arrays or hashes, which cnanot be
146the reference count used by the C<*_rv>-funtions tend to be one higher. 146passed directly. Remember that taking a reference of some object increases
147it's reference count, so the reference count used by the C<*_rv>-functions
148tend to be one higher.
147 149
148=item refcnt_inc_rv scalar 150=item refcnt_inc_rv scalar
149 151
150Works like C<refcnt_inc>, but dereferences the given reference first. 152Works like C<refcnt_inc>, but dereferences the given reference first.
151 153
152=item refcnt_dec_rv scalar 154=item refcnt_dec_rv scalar
153 155
154Works like C<refcnt_dec>, but dereferences the given reference first. 156Works like C<refcnt_dec>, but dereferences the given reference first.
157
158=item ok scalar
159
160=item uok scalar
161
162=item rok scalar
163
164=item pok scalar
165
166=item nok scalar
167
168=item niok scalar
169
170Calls SvOK, SvUOK, SvROK, SvPOK, SvNOK or SvNIOK on the given scalar,
171respectively.
155 172
156=cut 173=cut
157 174
1581; 1751;
159 176

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines