PDL :: PP-Inlinep - Online en la nube

PROGRAMA:

NOMBRE

Inline :: Pdlpp - Escribe subrutinas PDL en línea con PDL :: PP

DESCRIPCIÓN

"Inline :: Pdlpp" es un módulo que le permite escribir subrutinas PDL en el estilo PDL :: PP.
El gran beneficio en comparación con "PDL :: PP" es que puede escribir estas definiciones en línea
en cualquier script antiguo de Perl (sin la molestia normal de crear Makefiles, compilar, etc.).
Desde la versión 0.30, el módulo Inline admite múltiples lenguajes de programación y cada
language tiene su propio módulo de soporte. Este documento describe cómo utilizar Inline con
PDL :: PP (o mejor dicho, lo hará una vez que estos documentos estén completos ";)".

Para obtener más información sobre Inline en general, consulte Inline.

Algunos scripts de ejemplo que demuestran el uso de "Inline :: Pdlpp" se pueden encontrar en el
Ejemplo / InlinePdlpp directorio.

"Inline :: Pdlpp" es sobre todo una estafa descarada de "Inline :: C". La mayoría de los felicitaciones son para Brian I.

Uso

En realidad, nunca usa "Inline :: Pdlpp" directamente. Es solo un módulo de soporte para usar
"Inline.pm" con "PDL :: PP". Entonces el uso es siempre:

use Inline Pdlpp => ...;

or

enlazar Inline Pdlpp => ...;

Ejemplos

Pendiente de disponibilidad de documentos completos, algunos ejemplos rápidos ilustran el uso típico.

A simples (aqui)
# script de ejemplo inlpp.pl
utilizar PDL; # debe ser llamado antes (!) 'use Inline Pdlpp' llamadas

use Inline Pdlpp; # el código real está en el bloque __Pdlpp__ a continuación

$ a = secuencia 10;
imprimir $ a-> inc, "\ n";
imprimir $ a-> inc-> dummy (1,10) -> tcumul, "\ n";

__DATOS__

__Pdlpp__

pp_def ('inc',
Pars => 'i (); [o] o ()',
Código => '$ o () = $ i () + 1;',
);

pp_def ('tcumul',
Pars => 'en (n); [o] mul ()',
Código => '$ mul () = 1;
bucle (n)% {
$ mul () * = $ in ();
%} ',
);
# fin de secuencia de comandos de ejemplo

Si llama a este script, debería generar una salida similar a esta:

aviso> perl inlpp.pl
Ejecución en línea de PDL :: PP versión 2.2 ...
[1 2 3 4 5 6 7 8 9 10]
[3628800 3628800 3628800 3628800 3628800 3628800 3628800 3628800 3628800 3628800]

El uso de "Inline :: Pdlpp" en general es similar a "Inline :: C". En ausencia de pleno
docs para "Inline :: Pdlpp", es posible que desee comparar Inline :: C.

Código que usos externo bibliotecas etc.
El siguiente script es algo más complicado ya que usa código de un externo
biblioteca (aquí de Numerical Recipes). Toda la información relevante con respecto a incluir
Los archivos, bibliotecas y código de arranque se especifican en una llamada de configuración a "Inline". Para más
hackers de Perl experimentados, puede ser útil saber que el formato es similar al
utilizado con ExtUtils :: MakeMaker. Las palabras clave son en gran medida equivalentes a las que se utilizan con
"En línea :: C". Consulte a continuación para obtener más detalles sobre el uso de "INC", "LIBS",
"AUTO_INCLUDE" y "BOOT".

utilizar PDL; # esto debe ser llamado antes (!) 'use Inline Pdlpp' llama

use Inline Pdlpp => Config =>
INC => "-I $ ENV {HOME} / incluir",
LIBS => "-L $ ENV {INICIO}/ lib -lnr -lm ",
# código a incluir en el XS generado
AUTO_INCLUDE => << 'EOINC',
#incluir
#include "nr.h" / * para poidev * /
#include "nrutil.h" / * para err_handler * /

vacío estático nr_barf (char * err_txt)
{
fprintf (stderr, "Ahora llamando croak ... \ n");
croak ("Error de tiempo de ejecución NR:% s", err_txt);
}
EOINC
# instale nuestro controlador de errores al cargar el código Inline :: Pdlpp
BOOT => 'set_nr_err_handler (nr_barf);';

use Inline Pdlpp; # el código real está en el bloque __Pdlpp__ a continuación

$ a = ceros(10) + 30 ;;
imprimir $ a->poidev(5), "\ n";

__DATOS__

__Pdlpp__

pp_def ('poidev',
Pars => 'xm (); [o] pd () ',
GenericTypes => [L, F, D],
OtherPars => 'largo idum',
Código => '$ pd () = poidev ((float) $ xm (), & $ COMP (idum));',
);

Pdlpp Configuration Opciones

Para obtener información sobre cómo especificar las opciones de configuración en línea, consulte En línea. Esta sección
describe cada una de las opciones de configuración disponibles para Pdlpp. La mayoría de las opciones
corresponden a las opciones de MakeMaker o XS del mismo nombre. Consulte ExtUtils :: MakeMaker y
perlxs.

AUTO_INCLUIR
Especifica declaraciones adicionales para que se incluyan automáticamente. Se agregarán al
valores predeterminados. Se agregará automáticamente un carácter de nueva línea. Hace esencialmente lo mismo que una llamada
a "pp_addhdr". Para fragmentos cortos de código, "AUTO_INCLUDE" probablemente sea sintácticamente mejor.

use Inline Pdlpp => Config => AUTO_INCLUDE => '#include "yourheader.h"';

BENDECIR
Igual que el comando "pp_bless". Especifica el paquete (es decir, la clase) a la que su nuevo pp_defed
Se agregarán métodos. Por defecto es "PDL" si se omite.

use Inline Pdlpp => Config => BLESS => 'PDL :: Complex';

BARCO
Especifica el código C que se ejecutará en la sección XS BOOT. Corresponde al parámetro XS.
Hace lo mismo que el comando "pp_add_boot". A menudo se usa para ejecutar código solo una vez en la carga
hora del módulo, por ejemplo, una llamada de inicialización de biblioteca.

CC
Especifique qué compilador utilizar.

BANDERAS
Especifique indicadores adicionales del compilador.

INC
Especifica una ruta de inclusión para usar. Corresponde al parámetro MakeMaker.

use Inline Pdlpp => Config => INC => '-I / inc / path';

LD
Especifique qué vinculador utilizar.

LDDLFABANDERAS
Especifique qué indicadores del vinculador utilizar.

NOTA: Estas banderas anularán completamente las banderas existentes, en lugar de simplemente agregar a
ellos. Entonces, si necesita usarlos también, debe volver a especificarlos aquí.

LIBS
Especifica bibliotecas externas que deben estar vinculadas a su código. Corresponde a la
Parámetro MakeMaker.

use Inline Pdlpp => Config => LIBS => '-lyourlib';

or

use Inline Pdlpp => Config => LIBS => '-L / your / path -lyourlib';

HAZ
Especifique el nombre de la utilidad 'make' que se utilizará.

MIEXTLIB
Especifica un objeto compilado por el usuario que debe estar vinculado. Corresponde al MakeMaker
parámetro.

use Inline Pdlpp => Config => MYEXTLIB => '/your/path/yourmodule.so';

OPTIMIZAR
Esto controla la configuración de OPTIMIZAR de MakeMaker. Al establecer este valor en '-g', puede activar
sobre el soporte de depuración para sus extensiones en línea. Esto le permitirá poder configurar
puntos de interrupción en su código C usando un depurador como gdb.

MAPAS TIPOGRAFICOS
Especifica archivos de mapa de tipos adicionales para usar. Corresponde al parámetro MakeMaker.

use Inline Pdlpp => Config => TYPEMAPS => '/ su / ruta / typemap';

RUIDOSO
Muestre el resultado de las compilaciones que se están produciendo entre bastidores. Utiliza "tee" que debe ser
disponible en su computadora. El valor predeterminado es desactivado.

Use PDL :: PP-Inlinep en línea usando los servicios de onworks.net