PHP Conference Japan 2024

com_print_typeinfo

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

com_print_typeinfoMostra uma definição de classe PHP para uma interface despachável

Descrição

com_print_typeinfo(variant|string $variant, ?string $dispatch_interface = null, bool $display_sink = false): bool

O objetivo desta função é ajudar a gerar um esqueleto de classe para uso como um coletor de eventos. Pode também ser usada para gerar um despejo de informações de qualquer objeto COM, desde que ele suporte interfaces de introspecção suficientes e que seja conhecido o nome da interface que deve ser exibida.

Parâmetros

variant

variant deve ser uma instância de um objeto COM ou o nome de uma biblioteca de tipos (que será resolvida de acordo com as regras definidas em com_load_typelib()).

dispatch_interface

O nome de uma interface derivada de IDispatch a ser exibida.

display_sink

Se definido como true, a interface de coleta correspondente será exibida no lugar.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
2
csaba at alum dot mit dot edu
19 years ago
com_print_typeinfo is really useful if you're trying to figure out what properties and methods you have access to. For example, I might do:

<?php
$oExplorer
= new COM("Shell.Application");
com_print_typeinfo($oExplorer);
?>

The first line shows me the class of the object (what VBScript calls 'typename'), in my case IShellDispatch4. It's frequently the case that if you plunk that in as the second argument to com_print_typeinfo, you get way more methods/properties coming back. Thus:

<?php
$oExplorer
= new COM("Shell.Application");
com_print_typeinfo($oExplorer, "IShellDispatch4");
?>

Furthermore, you might get additional functions listed if you try lower number suffixes (or not). At any rate, it would be useful for PHP to have a typename function like VBScript does. For example, if you iterate through the Windows of $oExplorer you get both IE and Explorer windows and typename is the easy way to differentiate between them. Here's what I'm using:

<?php
function typeName($objCOM) {
if (empty(
$objCOM)) return "no COM object";
if (
gettype($objCOM)!="object") return "not a COM object";
ob_start();
com_print_typeinfo($objCOM);
$typeInfo = ob_get_contents();
ob_end_clean();
$pattern = "/^\\s*class (.*) \\{/";
if (!(
$matchCnt = preg_match($pattern, $typeInfo, $aMatch))) return "Not found";
return
$aMatch[1];
}
?>

Csaba Gabor from Vienna
up
-1
Richard Lynch
18 years ago
In my particular version of PHP, the second and third arguments are not, in fact, optional.

Passing in '' for both, however, yielded a bucketful of information.

YMMV
To Top