pdl::char(3) [suse man page]

Char(3) 						User Contributed Perl Documentation						   Char(3)

NAME

       PDL::Char -- PDL subclass which allows reading and writing of fixed-length character strings as byte PDLs

SYNOPSIS

	use PDL;
	use PDL::Char;

	my $pchar = PDL::Char->new( [['abc', 'def', 'ghi'],['jkl', 'mno', 'pqr']] );

	$pchar->setstr(1,0,'foo');

	print $pchar; # 'string' bound to "", perl stringify function
	# Prints:
	# [
	#  ['abc' 'foo' 'ghi']
	#  ['jkl' 'mno' 'pqr']
	# ]

	print $pchar->atstr(2,0);
	# Prints:
	# ghi

DESCRIPTION

       This subclass of PDL allows one to manipulate PDLs of 'byte' type as if they were made of fixed length strings, not just numbers.

       This type of behavior is useful when you want to work with charactar grids.  The indexing is done on a string level and not a character
       level for the 'setstr' and 'atstr' commands.

       This module is in particular useful for writing NetCDF files that include character data using the PDL::NetCDF module.

FUNCTIONS

   new
       Function to create a byte PDL from a string, list of strings, list of list of strings, etc.

	# create a new PDL::Char from a perl array of strings
	$strpdl = PDL::Char->new( ['abc', 'def', 'ghij'] );

	# Convert a PDL of type 'byte' to a PDL::Char
	$strpdl1 = PDL::Char->new (sequence (byte, 4, 5)+99);

	$pdlchar3d = PDL::Char->new([['abc','def','ghi'],['jkl', 'mno', 'pqr']]);

   string
       Function to print a character PDL (created by 'char') in a pretty format.

	$char = PDL::Char->new( [['abc', 'def', 'ghi'], ['jkl', 'mno', 'pqr']] );
	print $char; # 'string' bound to "", perl stringify function
	# Prints:
	# [
	#  ['abc' 'def' 'ghi']
	#  ['jkl' 'mno' 'pqr']
	# ]

	# 'string' is overloaded to the "" operator, so:
	# print $char;
	# should have the same effect.

   setstr
       Function to set one string value in a character PDL.  The input position is the position of the string, not a character in the string.  The
       first dimension is assumed to be the length of the string.

       The input string will be null-padded if the string is shorter than the first dimension of the PDL.  It will be truncated if it is longer.

	$char = PDL::Char->new( [['abc', 'def', 'ghi'], ['jkl', 'mno', 'pqr']] );
	$char->setstr(0,1, 'foobar');
	print $char; # 'string' bound to "", perl stringify function
	# Prints:
	# [
	#  ['abc' 'def' 'ghi']
	#  ['foo' 'mno' 'pqr']
	# ]
	$char->setstr(2,1, 'f');
	print $char; # 'string' bound to "", perl stringify function
	# Prints:
	# [
	#  ['abc' 'def' 'ghi']
	#  ['foo' 'mno' 'f']	  -> note that this 'f' is stored "f"
	# ]

   atstr
       Function to fetch one string value from a PDL::Char type PDL, given a position within the PDL.  The input position of the string, not a
       character in the string.  The length of the input string is the implied first dimension.

	$char = PDL::Char->new( [['abc', 'def', 'ghi'], ['jkl', 'mno', 'pqr']] );
	print $char->atstr(0,1);
	# Prints:
	# jkl

perl v5.12.1							    2009-10-17								   Char(3)

Dbg(3)							User Contributed Perl Documentation						    Dbg(3)

NAME

       PDL::Dbg - functions to support debugging of PDL scripts

SYNOPSIS

	      use PDL;
	      use PDL::Dbg;

	      $c = $a->slice("5:10,2:30")->px->diagonal(3,4);
	      PDL->px;

DESCRIPTION

       This packages implements a couple of functions that should come in handy when debugging your PDL scripts. They make a lot of sense while
       you're doing rapid prototyping of new PDL code, let's say inside the perldl shell.

FUNCTIONS

       px

       Print info about a piddle (or all known piddles)

	   perldl> PDL->px
	   perldl> $b += $a->clump(2)->px('clumptest')->sumover
	   perldl> $a->px('%C (%A) Type: %T')

       This function prints some information about piddles. It can be invoked as a class method (e.g. "PDL->px" ) or as an instance method (e.g.
       "$pdl->px($arg)"). If

       invoked as a class method
	 it prints info about all piddles found in the current package (excluding "my" variables). This comes in quite handy when you are not
	 quite sure which pdls you have already defined, what data they hold , etc. "px" is supposed to support inheritance and prints info about
	 all symbols for which an "isa($class)" is true. An optional string argument is interpreted as the package name for which to print sym-
	 bols:

	   perldl> PDL->px('PDL::Mypack')

	 The default package is that of the caller.

       invoked as an instance method
	 it prints info about that particular piddle if $PDL::debug is true and returns the pdl object upon completion. It accepts an optional
	 string argument that is simply prepended to the default info if it doesn't contain a "%" character. If, however, the argument contains a
	 "%" then the string is passed to the "info" method to control the format of the printed information. This can be used to achieve custom-
	 ized output from "px". See the documentation of "PDL::info" for further details.

       The output of px will be determined by the default formatting string that is passed to the "info" method (unless you pass a string contain-
       ing "%" to px when invoking as an instance method, see above). This default string is stored in $PDL::Dbg::Infostr and the default output
       format can be accordingly changed by setting this variable.  If you do this you should also change the default title string that the class
       method branch prints at the top of the listing to match your new format string. The default title is stored in the variable
       $PDL::Dbg::Title.

       For historical reasons "vars" is an alias for "px".

       vars

       Alias for "px"

BUGS

       There are probably some. Please report if you find any. Bug reports should be sent to the PDL mailing list perldl@jachw.hawaii.edu.

AUTHOR

       Copyright(C) 1997 Christian Soeller (c.soeller@auckland.ac.nz).	All rights reserved. There is no warranty. You are allowed to redistribute
       this software / documentation under certain conditions. For details, see the file COPYING in the PDL distribution. If this file is sepa-
       rated from the PDL distribution, the copyright notice should be included in the file.

perl v5.8.0							    2000-04-17								    Dbg(3)