Function
EvinceDocumentDocumentfactory_get_document_for_stream
since: 3.6
Declaration [src]
EvDocument*
ev_document_factory_get_document_for_stream (
GInputStream* stream,
const char* mime_type,
EvDocumentLoadFlags flags,
GCancellable* cancellable,
GError** error
)
Description [src]
Synchronously creates a EvDocument
for the document from stream
; or, if no
backend handling the document’s type is found, or an error occurred
on opening the document, returns NULL
and fills in error
.
If the document is encrypted, it is returned but also error
is set to
EV_DOCUMENT_ERROR_ENCRYPTED
.
If mime_type
is non-NULL
, this overrides any type inferred from the stream.
If the mime type cannot be inferred from the stream, and mime_type
is NULL
,
an error is returned.
Available since: 3.6
Parameters
stream
-
Type:
GInputStream
A
GInputStream
.The data is owned by the caller of the function. mime_type
-
Type:
const char*
A mime type hint.
The argument can be NULL
.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. flags
-
Type:
EvDocumentLoadFlags
Flags from
EvDocumentLoadFlags
. cancellable
-
Type:
GCancellable
A
GCancellable
, orNULL
.The argument can be NULL
.The data is owned by the caller of the function. error
-
Type:
GError **
The return location for a recoverable error.
The argument can be NULL
.If the return location is not NULL
, then you must initialize it to aNULL
GError*
.The argument will be left initialized to NULL
by the function if there are no errors.In case of error, the argument will be set to a newly allocated GError
; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: EvDocument
A new EvDocument
, or NULL
.
The caller of the function takes ownership of the data, and is responsible for freeing it. |