fromSOAP                package:SSOAP                R Documentation

_C_o_n_v_e_r_s_t _a_n _X_M_L _n_o_d_e _t_o _a_n _S _O_b_j_e_c_t

_D_e_s_c_r_i_p_t_i_o_n:

     Convert an XML node representing a SOAP value to an S object. The
     different functions handle different types of SOAP objets. This
     also works on an XML string or filename. The 'fromSOAPArray'
     supports the 'offset' and 'position' attributes for partially
     transmitted and sparse  arrays. Currently, there are limits on the

_U_s_a_g_e:

     fromSOAP(node, root = NULL, converters = SOAPPrimitiveConverters,
              append = TRUE, type = NULL, findReturn = TRUE, multiRefs = list())
     fromSOAPStruct(node, root = NULL,
                     converters = SOAPPrimitiveConverters, type = NULL, multiRefs = list())
     fromSOAPArray(node, type = NULL, root = NULL,
                    converters = SOAPPrimitiveConverters, 
                    multiRefs = list())

_A_r_g_u_m_e_n_t_s:

    node: the XML node (and sub-nodes) giving the SOAP content. The
          'fromSOAP' function works recursively, operating on
          sub-nodes, etc. This argument is the individual node. 

    root: the top-most node of the XML ``document'' which is used for
          resolving 'href' references within elements to other nodes.
          This doesn't change across the recursive calls.

converters: a named-list of functions. The names are used to find the
          appropriate converter for a non-array or non-struct SOAP
          object. The name comes from the value of the ``xsi:type''
          attribute or from the string ``xsd:<element name>'' where
          'element-name' is the name of the XML node. This will become
          more advanced in the future. 

  append: a logical value indicating whether to merge the converters
          with the default SOAPPrimitiveConverters, or use them as is.
          This is available for covenience so that the caller doesn't
          have to perform the two-step merging herself.

    type: an optional type identifier that if not specified is computed
          from the 'xsi:type' attribute of the XML node ('node') if
          available.

findReturn: a logical value indicating whether to recursively descend
          the XML node to find the '<return>' element and process that
          rather than  working directly from 'node'. 

multiRefs: ?

_D_e_t_a_i_l_s:

_V_a_l_u_e:

_A_u_t_h_o_r(_s):

     Duncan Temple Lang <duncan@wald.ucdavis.edu>

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.w3.org/TR/SOAP/> <URL:
     http://www.omegahat.org/SSOAP>, <URL:
     http://www.omegahat.org/bugs>.

_S_e_e _A_l_s_o:

     '.SOAP'

_E_x_a_m_p_l_e_s:

