php_stl::call_long_string_map

#include "php_stl.h"

map<long, string>
php_stl::call_long_string_map(char *fn, char *argspec = "", ...);

Description: Call the PHP function fn with the arguments described by argspec and included as subsequent arguments. If argspec is not specified the function will be called without any arguments. The type of the value returned from PHP must be an array and each key-value pair in that array will be inserted into an STL map as such. Each time PHP type conversion is necessary to convert a key in the array to a long or a value in the array to a string it may generate a type mismatch warning if those warnings are enabled.

Errors: It is an error for the number of arguments described in argspec to differ from the number of arguments provided thereafter. It is an error for the types of additional arguments to differ from their description in argspec(see Table 1 on page  for details). If the value returned by PHP is not an array call_long_string_map will output a type mismatch error (regardless of whether type warnings are on or not) and return an empty map. Any internal errors during execution will result in the status flag (see php::status) being set to a nonzero value.