KIO.FileJob

KDE 4.2 PyKDE API Reference

- KDE's Python API

# FileJob Class Reference

`from PyKDE4.kio import *`

Inherits: KIO.SimpleJob → KIO.Job → KCompositeJob → KJob → QObject
Namespace: KIO

## Detailed Description

The file-job is an asynchronious version of normal file handling. It allows block-wise reading and writing, and allows seeking. Results are returned through signals.

Should always be created using KIO.open(KUrl&)

## Signals
| close (KIO.Job job)
| data (KIO.Job job, QByteArray data)
| mimetype (KIO.Job job, QString type)
| open (KIO.Job job)
| position (KIO.Job job, KIO.filesize_t offset)
| redirection (KIO.Job job, KUrl url)
| written (KIO.Job job, KIO.filesize_t written)
## Methods
| __init__ (self, FileJobPrivate dd)
| __init__ (self)
| close (self)
| close (self, KIO.Job job)
| data (self, KIO.Job job, QByteArray data)
| mimetype (self, KIO.Job job, QString type)
| open (self, KIO.Job job)
| position (self, KIO.Job job, KIO.filesize_t offset)
| read (self, KIO.filesize_t size)
| redirection (self, KIO.Job job, KUrl url)
| seek (self, KIO.filesize_t offset)
KIO.filesize_t | size (self)
| write (self, QByteArray data)
| written (self, KIO.Job job, KIO.filesize_t written)

## Method Documentation

__init__ | ( | self, |
|  | FileJobPrivate | dd
| ) |  |  |

__init__ | ( |  | self ) |

close | ( |  | self ) |

Close

Closes the file-slave

close | ( | self, |
|  | KIO.Job | job
| ) |  |  |

File is closed and will accept no more commands

Parameters:

  | job | the job that emitted this signal

Signal syntax:
  `QObject.connect(source, SIGNAL("close(Job*)"), target_slot)`

data | ( | self, |
|  | KIO.Job | job,
|  | QByteArray | data
| ) |  |  |

Data from the slave has arrived.

Parameters:

  | job | the job that emitted this signal
  | data | data received from the slave.

Signal syntax:
  `QObject.connect(source, SIGNAL("data(Job*, const QByteArray&)"), target_slot)`

mimetype | ( | self, |
|  | KIO.Job | job,
|  | QString | type
| ) |  |  |

Mimetype determined.

Parameters:

  | job | the job that emitted this signal
  | type | the mime type

Signal syntax:
  `QObject.connect(source, SIGNAL("mimetype(Job*, const QString&)"), target_slot)`

open | ( | self, |
|  | KIO.Job | job
| ) |  |  |

File is open, metadata has been determined and the file-slave is ready to receive commands.

Parameters:

  | job | the job that emitted this signal

Signal syntax:
  `QObject.connect(source, SIGNAL("open(Job*)"), target_slot)`

position | ( | self, |
|  | KIO.Job | job,
|  | KIO.filesize_t | offset
| ) |  |  |

The file has reached this position. Emitted after seek.

Parameters:

  | job | the job that emitted this signal
  | offset | the new position

Signal syntax:
  `QObject.connect(source, SIGNAL("position(Job*, filesize_t)"), target_slot)`

read | ( | self, |
|  | KIO.filesize_t | size
| ) |  |  |

Read block

The slave emits the data through data().

Parameters:

  | size | the requested amount of data

redirection | ( | self, |
|  | KIO.Job | job,
|  | KUrl | url
| ) |  |  |

Signals the file is a redirection. Follow this url manually to reach data

Parameters:

  | job | the job that emitted this signal
  | url | the new URL

Signal syntax:
  `QObject.connect(source, SIGNAL("redirection(Job*, const KUrl&)"), target_slot)`

seek | ( | self, |
|  | KIO.filesize_t | offset
| ) |  |  |

Seek

The slave emits position()

Parameters:

  | offset | the position from start to go to

KIO.filesize_t size | ( |  | self ) |

Size

Returns:
  the file size

write | ( | self, |
|  | QByteArray | data
| ) |  |  |

Write block

Parameters:

  | data | the data to write

written | ( | self, |
|  | KIO.Job | job,
|  | KIO.filesize_t | written
| ) |  |  |

Bytes written to the file.

Parameters:

  | job | the job that emitted this signal
  | written | bytes written.

Signal syntax:
  `QObject.connect(source, SIGNAL("written(Job*, filesize_t)"), target_slot)`