#acupoftea - mail.ontime-ae.com

System	:	Linux server1.ontime-gulf.com 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Wed Jun 5 09:12:13 EDT 2024 x86_64
Software	:	Apache
Server	:	162.0.230.206
Domains	:	40 Domain
Permission	:	[ drwxr-xr-x ]
	:	/ usr / share / perl5 /

216.73.216.49

Home

File bytes.pm

package bytes;

our $VERSION = '1.05';

$bytes::hint_bits = 0x00000008;

sub import {
    $^H |= $bytes::hint_bits;
}

sub unimport {
    $^H &= ~$bytes::hint_bits;
}

sub AUTOLOAD {
    require "bytes_heavy.pl";
    goto &$AUTOLOAD if defined &$AUTOLOAD;
    require Carp;
    Carp::croak("Undefined subroutine $AUTOLOAD called");
}

sub length (_);
sub chr (_);
sub ord (_);
sub substr ($$;$$);
sub index ($$;$);
sub rindex ($$;$);

1;
__END__

=head1 NAME

bytes - Perl pragma to expose the individual bytes of characters

=head1 NOTICE

Because the bytes pragma breaks encapsulation (i.e. it exposes the innards of
how the perl executable currently happens to store a string), the byte values
that result are in an unspecified encoding.

B<Use of this module for anything other than debugging purposes is
strongly discouraged.>  If you feel that the functions here within
might be useful for your application, this possibly indicates a
mismatch between your mental model of Perl Unicode and the current
reality. In that case, you may wish to read some of the perl Unicode
documentation: L<perluniintro>, L<perlunitut>, L<perlunifaq> and
L<perlunicode>.

=head1 SYNOPSIS

use bytes;
    ... chr(...);       # or bytes::chr
    ... index(...);     # or bytes::index
    ... length(...);    # or bytes::length
    ... ord(...);       # or bytes::ord
    ... rindex(...);    # or bytes::rindex
    ... substr(...);    # or bytes::substr
    no bytes;

=head1 DESCRIPTION

Perl's characters are stored internally as sequences of one or more bytes.
This pragma allows for the examination of the individual bytes that together
comprise a character.

Originally the pragma was designed for the loftier goal of helping incorporate
Unicode into Perl, but the approach that used it was found to be defective,
and the one remaining legitimate use is for debugging when you need to
non-destructively examine characters' individual bytes.  Just insert this
pragma temporarily, and remove it after the debugging is finished.

The original usage can be accomplished by explicit (rather than this pragma's
implict) encoding using the L<Encode> module:

use Encode qw/encode/;

my $utf8_byte_string   = encode "UTF8",   $string;
    my $latin1_byte_string = encode "Latin1", $string;

Or, if performance is needed and you are only interested in the UTF-8
representation:

use utf8;

utf8::encode(my $utf8_byte_string = $string);

C<no bytes> can be used to reverse the effect of C<use bytes> within the
current lexical scope.

As an example, when Perl sees C<$x = chr(400)>, it encodes the character
in UTF-8 and stores it in C<$x>. Then it is marked as character data, so,
for instance, C<length $x> returns C<1>. However, in the scope of the
C<bytes> pragma, C<$x> is treated as a series of bytes - the bytes that make
up the UTF8 encoding - and C<length $x> returns C<2>:

$x = chr(400);
 print "Length is ", length $x, "\n";     # "Length is 1"
 printf "Contents are %vd\n", $x;         # "Contents are 400"
 {
     use bytes; # or "require bytes; bytes::length()"
     print "Length is ", length $x, "\n"; # "Length is 2"
     printf "Contents are %vd\n", $x;     # "Contents are 198.144 (on
                                          # ASCII platforms)"
 }

C<chr()>, C<ord()>, C<substr()>, C<index()> and C<rindex()> behave similarly.

For more on the implications, see L<perluniintro> and L<perlunicode>.

C<bytes::length()> is admittedly handy if you need to know the
B<byte length> of a Perl scalar.  But a more modern way is:

use Encode 'encode';
   length(encode('UTF-8', $scalar))

=head1 LIMITATIONS

C<bytes::substr()> does not work as an I<lvalue()>.

=head1 SEE ALSO

L<perluniintro>, L<perlunicode>, L<utf8>, L<Encode>

=cut

Name	Type	Size	Permission	Last Modified	Actions
.	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
..	DIR	-	drwxr-xr-x	2025-10-16 10:59:21
Attribute	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
B	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
CPAN	DIR	-	drwxr-xr-x	2024-03-13 04:56:46
Class	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Compress	DIR	-	drwxr-xr-x	2024-03-13 04:36:57
Config	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
DBM_Filter	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Devel	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
ExtUtils	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
File	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Getopt	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
I18N	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
IO	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
IPC	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Locale	DIR	-	drwxr-xr-x	2025-07-28 08:08:32
Math	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Memoize	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Module	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Net	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Pod	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Search	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Term	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Text	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Thread	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Tie	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
Time	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
URI	DIR	-	drwxr-xr-x	2024-03-13 04:36:40
Unicode	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
User	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
encoding	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
overload	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
pod	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
unicore	DIR	-	drwxr-xr-x	2025-07-29 10:57:24
vendor_perl	DIR	-	drwxr-xr-x	2025-07-28 08:07:18
warnings	DIR	-	drwxr-xr-x	2025-07-29 10:57:25
AnyDBM_File.pm	text/plain	2.56 KB	-rw-r--r--	2025-07-28 08:07:09
AutoLoader.pm	text/plain	15.43 KB	-rw-r--r--	2025-07-28 08:07:09
AutoSplit.pm	text/plain	19.18 KB	-rw-r--r--	2025-07-28 08:07:09
Benchmark.pm	text/plain	30.3 KB	-rw-r--r--	2025-07-28 08:07:09
CORE.pod	text/plain	3.11 KB	-rw-r--r--	2025-07-28 08:07:09
DB.pm	text/plain	18.48 KB	-rw-r--r--	2025-07-28 08:07:09
DBM_Filter.pm	text/plain	14.05 KB	-rw-r--r--	2025-07-28 08:07:09
DirHandle.pm	text/plain	1.52 KB	-rw-r--r--	2025-07-28 08:07:09
Dumpvalue.pm	text/plain	17.14 KB	-rw-r--r--	2025-07-28 08:07:09
English.pm	text/plain	4.65 KB	-rw-r--r--	2025-07-28 08:07:09
FileCache.pm	text/plain	5.44 KB	-rw-r--r--	2025-07-28 08:07:09
FileHandle.pm	text/plain	6.63 KB	-rw-r--r--	2025-07-28 08:07:09
FindBin.pm	text/plain	4.45 KB	-rw-r--r--	2025-07-28 08:07:09
Internals.pod	text/plain	2.52 KB	-rw-r--r--	2025-07-28 08:07:09
Memoize.pm	text/plain	35.34 KB	-rw-r--r--	2025-07-28 08:08:32
NEXT.pm	text/plain	18.4 KB	-rw-r--r--	2025-07-28 08:07:09
PerlIO.pm	text/plain	10.21 KB	-rw-r--r--	2025-07-28 08:07:09
Safe.pm	text/plain	24.49 KB	-rw-r--r--	2025-07-28 08:07:09
SelectSaver.pm	text/plain	1.05 KB	-rw-r--r--	2025-07-28 08:07:09
SelfLoader.pm	text/plain	17.28 KB	-rw-r--r--	2025-07-28 08:08:32
Symbol.pm	text/plain	4.69 KB	-rw-r--r--	2025-07-28 08:07:09
Test.pm	text/plain	29.35 KB	-rw-r--r--	2025-07-28 08:08:32
Thread.pm	text/plain	8.09 KB	-rw-r--r--	2025-07-28 08:07:09
UNIVERSAL.pm	text/plain	6.44 KB	-rw-r--r--	2025-07-28 08:07:09
URI.pm	text/plain	33.97 KB	-rw-r--r--	2018-01-09 06:42:55
XSLoader.pm	text/plain	11 KB	-rw-r--r--	2025-07-28 08:07:09
_charnames.pm	text/plain	32.39 KB	-rw-r--r--	2025-07-28 08:07:09
autouse.pm	text/plain	4.14 KB	-rw-r--r--	2025-07-28 08:07:09
base.pm	text/plain	10.72 KB	-rw-r--r--	2025-07-28 08:07:09
blib.pm	text/plain	2.04 KB	-rw-r--r--	2025-07-28 08:07:09
bytes.pm	text/plain	3.67 KB	-rw-r--r--	2025-07-28 08:07:09
bytes_heavy.pl	text/plain	758 B	-rw-r--r--	2025-07-28 08:07:09
charnames.pm	text/plain	20.38 KB	-rw-r--r--	2025-07-28 08:07:09
deprecate.pm	text/plain	3.01 KB	-rw-r--r--	2025-07-28 08:07:09
diagnostics.pm	text/plain	18.59 KB	-rw-r--r--	2025-07-28 08:07:09
dumpvar.pl	text/plain	15.19 KB	-rw-r--r--	2025-07-28 08:07:09
feature.pm	text/plain	16.68 KB	-rw-r--r--	2025-07-28 08:07:09
fields.pm	text/plain	9.27 KB	-rw-r--r--	2025-07-28 08:07:09
filetest.pm	text/plain	3.91 KB	-rw-r--r--	2025-07-28 08:07:09
if.pm	text/plain	3.26 KB	-rw-r--r--	2025-07-28 08:07:09
integer.pm	text/plain	3.18 KB	-rw-r--r--	2025-07-28 08:07:09
less.pm	text/plain	3.13 KB	-rw-r--r--	2025-07-28 08:07:09
locale.pm	text/plain	4.74 KB	-rw-r--r--	2025-07-28 08:07:09
meta_notation.pm	text/plain	2.07 KB	-rw-r--r--	2025-07-28 08:07:09
open.pm	text/plain	7.83 KB	-rw-r--r--	2025-07-28 08:08:32
overload.pm	text/plain	52.06 KB	-rw-r--r--	2025-07-28 08:07:09
overloading.pm	text/plain	1.77 KB	-rw-r--r--	2025-07-28 08:07:09
perl5db.pl	text/plain	309 KB	-rw-r--r--	2025-07-28 08:07:09
sigtrap.pm	text/plain	7.43 KB	-rw-r--r--	2025-07-28 08:07:09
sort.pm	text/plain	5.94 KB	-rw-r--r--	2025-07-28 08:07:09
strict.pm	text/plain	4.63 KB	-rw-r--r--	2025-07-28 08:07:09
subs.pm	text/plain	848 B	-rw-r--r--	2025-07-28 08:07:09
utf8.pm	text/plain	8.9 KB	-rw-r--r--	2025-07-28 08:07:09
utf8_heavy.pl	text/plain	30.87 KB	-rw-r--r--	2025-07-28 08:07:09
vars.pm	text/plain	2.36 KB	-rw-r--r--	2025-07-28 08:07:09
vmsish.pm	text/plain	4.21 KB	-rw-r--r--	2025-07-28 08:07:09
warnings.pm	text/plain	43.71 KB	-rw-r--r--	2025-07-28 08:07:09

~ ACUPOFTEA - mail.ontime-ae.com