diff options
Diffstat (limited to 'vendor/thecodingmachine/safe/generated/com.php')
-rw-r--r-- | vendor/thecodingmachine/safe/generated/com.php | 113 |
1 files changed, 91 insertions, 22 deletions
diff --git a/vendor/thecodingmachine/safe/generated/com.php b/vendor/thecodingmachine/safe/generated/com.php index 53643f9d7..68e058f2d 100644 --- a/vendor/thecodingmachine/safe/generated/com.php +++ b/vendor/thecodingmachine/safe/generated/com.php @@ -5,34 +5,55 @@ namespace Safe; use Safe\Exceptions\ComException; /** + * Generates a Globally Unique Identifier (GUID). + * + * A GUID is generated in the same way as DCE UUID's, except that the + * Microsoft convention is to enclose a GUID in curly braces. + * + * @return string Returns the GUID as a string. + * @throws ComException + * + */ +function com_create_guid(): string +{ + error_clear_last(); + $result = \com_create_guid(); + if ($result === false) { + throw ComException::createFromPhpError(); + } + return $result; +} + + +/** * Instructs COM to sink events generated by - * comobject into the PHP object - * sinkobject. + * variant into the PHP object + * sink_object. * * Be careful how you use this feature; if you are doing something similar * to the example below, then it doesn't really make sense to run it in a * web server context. * - * @param object $comobject - * @param object $sinkobject sinkobject should be an instance of a class with + * @param object $variant + * @param object $sink_object sink_object should be an instance of a class with * methods named after those of the desired dispinterface; you may use * com_print_typeinfo to help generate a template class * for this purpose. - * @param mixed $sinkinterface PHP will attempt to use the default dispinterface type specified by - * the typelibrary associated with comobject, but + * @param mixed $sink_interface PHP will attempt to use the default dispinterface type specified by + * the typelibrary associated with variant, but * you may override this choice by setting - * sinkinterface to the name of the dispinterface + * sink_interface to the name of the dispinterface * that you want to use. * @throws ComException * */ -function com_event_sink(object $comobject, object $sinkobject, $sinkinterface = null): void +function com_event_sink(object $variant, object $sink_object, $sink_interface = null): void { error_clear_last(); - if ($sinkinterface !== null) { - $result = \com_event_sink($comobject, $sinkobject, $sinkinterface); + if ($sink_interface !== null) { + $result = \com_event_sink($variant, $sink_object, $sink_interface); } else { - $result = \com_event_sink($comobject, $sinkobject); + $result = \com_event_sink($variant, $sink_object); } if ($result === false) { throw ComException::createFromPhpError(); @@ -44,15 +65,15 @@ function com_event_sink(object $comobject, object $sinkobject, $sinkinterface = * Loads a type-library and registers its constants in the engine, as though * they were defined using define. * - * Note that it is much more efficient to use the configuration setting to pre-load and + * Note that it is much more efficient to use the com.typelib-file php.ini setting to pre-load and * register the constants, although not so flexible. * - * If you have turned on , then + * If com.autoregister-typelib is turned on, then * PHP will attempt to automatically register the constants associated with a * COM object when you instantiate it. This depends on the interfaces * provided by the COM object itself, and may not always be possible. * - * @param string $typelib_name typelib_name can be one of the following: + * @param string $typelib typelib can be one of the following: * * * @@ -86,16 +107,16 @@ function com_event_sink(object $comobject, object $sinkobject, $sinkinterface = * * The type library name, e.g. Microsoft OLE DB ActiveX Data * Objects 1.0 Library. - * @param bool $case_sensitive The case_sensitive behaves inversely to + * @param bool $case_insensitive The case_insensitive behaves inversely to * the parameter $case_insensitive in the define * function. * @throws ComException * */ -function com_load_typelib(string $typelib_name, bool $case_sensitive = true): void +function com_load_typelib(string $typelib, bool $case_insensitive = true): void { error_clear_last(); - $result = \com_load_typelib($typelib_name, $case_sensitive); + $result = \com_load_typelib($typelib, $case_insensitive); if ($result === false) { throw ComException::createFromPhpError(); } @@ -108,20 +129,68 @@ function com_load_typelib(string $typelib_name, bool $case_sensitive = true): vo * object, provided that it supports enough of the introspection interfaces, * and that you know the name of the interface you want to display. * - * @param object $comobject comobject should be either an instance of a COM + * @param object $variant variant should be either an instance of a COM * object, or be the name of a typelibrary (which will be resolved according * to the rules set out in com_load_typelib). - * @param string $dispinterface The name of an IDispatch descendant interface that you want to display. - * @param bool $wantsink If set to TRUE, the corresponding sink interface will be displayed + * @param string $dispatch_interface The name of an IDispatch descendant interface that you want to display. + * @param bool $display_sink If set to TRUE, the corresponding sink interface will be displayed * instead. * @throws ComException * */ -function com_print_typeinfo(object $comobject, string $dispinterface = null, bool $wantsink = false): void +function com_print_typeinfo(object $variant, string $dispatch_interface = null, bool $display_sink = false): void { error_clear_last(); - $result = \com_print_typeinfo($comobject, $dispinterface, $wantsink); + if ($display_sink !== false) { + $result = \com_print_typeinfo($variant, $dispatch_interface, $display_sink); + } elseif ($dispatch_interface !== null) { + $result = \com_print_typeinfo($variant, $dispatch_interface); + } else { + $result = \com_print_typeinfo($variant); + } if ($result === false) { throw ComException::createFromPhpError(); } } + + +/** + * Converts variant from a VT_DATE + * (or similar) value into a Unix timestamp. This allows easier + * interopability between the Unix-ish parts of PHP and COM. + * + * @param object $variant The variant. + * @return int Returns a unix timestamp. + * @throws ComException + * + */ +function variant_date_to_timestamp(object $variant): int +{ + error_clear_last(); + $result = \variant_date_to_timestamp($variant); + if ($result === null) { + throw ComException::createFromPhpError(); + } + return $result; +} + + +/** + * Returns the value of value rounded to + * decimals decimal places. + * + * @param mixed $value The variant. + * @param int $decimals Number of decimal places. + * @return mixed Returns the rounded value. + * @throws ComException + * + */ +function variant_round($value, int $decimals) +{ + error_clear_last(); + $result = \variant_round($value, $decimals); + if ($result === null) { + throw ComException::createFromPhpError(); + } + return $result; +} |