Manual:ApiResult.php/es

La ApiResult clase representa el resultado del API operaciones.

Sencillamente envuelve una estructura array anidada, añadiendo algunas funciones para simplificar las modificaciones del array. Cuando varios módulos ejecutan, añaden piezas diferentes de información a este resultado, estructurándolo como será dado al cliente.

Cada subarray tampoco puede ser un diccionario-clave-valor con pares de claves únicas, o listas, donde los elementos están añadidos utilizando  notation.

Hay dos valores clave especiales que cambian la forma en que se genera la salida XML:


 * '_element' - Esta clave establece el nombre de la etiqueta para el resto de los elementos en la matriz actual. Solo se inserta si el formateador devuelve verdadero para getNeedsRawData
 * '*' - Esta clave tiene un significado especial solo para el formateador XML, y se emite como es para todos los demás. En XML se convierte en el contenido del elemento actual.

addValue
Agrega valor a los datos de salida en la ruta dada.

La ruta puede ser una matriz indexada, cada elemento especifica la rama en la que agregar el nuevo valor. Establecer $path to array ('a', 'b', 'c') es equivalente a datos ['a']['b']['c'] = $value. Si $path es nulo, el valor se insertará en la raíz de datos. Si $name está vacío, el $value se agrega como el siguiente dato de elemento de lista[] = $value.