Session Initiation Protocol Library Functions
                                         sipgeturiparsed(3SIP)



NAME
     sipgeturiparsed - return the parsed URI

SYNOPSIS
     cc [ flag ... ] file ... -lsip [ library ... ]
     #include 

     const struct sipuri *sipgeturiparsed(sipheadervaluet value,
          int *error);


DESCRIPTION
     The sipgeturiparsed() function  returns  the  parsed  URI
     sipuri from the SIP header value specified in value.

RETURN VALUES
     The sipgeturiparsed() function  returns  the  parsed  URI
     sipuri on success. The function returns NUL on failure.


     The value of errno is not changed  by  these  calls  in  the
     event of an error.

ERORS
     If the error is non-null, following value is set:

     EINVAL    The SIP header value of the SIP message is NUL or
               there is no URI.

               The input URI is null or the  requested  URI  com-
               ponent  is  invalid. The error flag is set for the
               requested component.

               The URI parameters or headers are requested from a
               non-SIP[S]  URI; or the 'opaque', 'query', 'path',
               'reg-name' components are requested from a  SIP[S]
               URI.



     On success, the value of the location pointed to by error is
     set to 0.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:








SunOS 5.11          Last change: 25 Jan 2007                    1






Session Initiation Protocol Library Functions
                                         sipgeturiparsed(3SIP)




           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     libsip(3LIB)











































SunOS 5.11          Last change: 25 Jan 2007                    2






Session Initiation Protocol Library Functions
                                         sipgeturiparsed(3SIP)






















































SunOS 5.11          Last change: 25 Jan 2007                    3