ext/Encode/Encode.pm

141     my ($name, $string, $check) = @_;
142     return undef unless defined $string;
149     my $octets = $enc->encode($string,$check);
150     $_[1] = $string if $check;
164     my $string = $enc->decode($octets,$check);
166     return $string;
171     my ($string,$from,$to,$check) = @_;
172     return undef unless defined $string;
184     my $uni = $f->decode($string,$check);
185     return undef if ($check && length($string));
186     $string =  $t->encode($uni,$check);
188     return defined($_[0] = $string) ? length($string) : undef ;
280 		my ($obj,$string,$chk) = @_;
281 		my $octets = Encode::encode_utf8($string);
384 =item $octets  = encode(ENCODING, $string [, CHECK])
386 Encodes a string from Perl's internal form into I<ENCODING> and returns
391 For example, to convert a string from Perl's internal format to
394   $octets = encode("iso-8859-1", $string);
396 B<CAVEAT>: When you run C<$octets = encode("utf8", $string)>, then $octets
397 B<may not be equal to> $string.  Though they both contain the same data, the utf8 flag
400 string. See L</"The UTF-8 flag"> below.
406 =item $string = decode(ENCODING, $octets [, CHECK])
409 internal form and returns the resulting string.  As in encode(),
414 For example, to convert ISO-8859-1 data to a string in Perl's internal format:
416   $string = decode("iso-8859-1", $octets);
418 B<CAVEAT>: When you run C<$string = decode("utf8", $octets)>, then $string
420 the utf8 flag for $string is on unless $octets entirely consists of
441 converted cannot be a string constant; it must be a scalar variable.
443 from_to() returns the length of the converted string in octets on success, undef
451 Both #1 and #2 make $data consist of a completely valid UTF-8 string
458 =item $octets = encode_utf8($string);
460 Equivalent to C<$octets = encode("utf8", $string);> The characters
461 that comprise $string are encoded in Perl's internal format and the
466 =item $string = decode_utf8($octets [, CHECK]);
468 equivalent to C<$string = decode("utf8", $octets [, CHECK])>.
728 string, integer, or floating point number.   But you can still peek
754 indicating success or failure), or C<undef> if STRING is not a string.
761 not a string.