Sophie

Sophie

distrib > * > 2009.0 > i586 > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 2213

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QSqlRecord" doc="/**
&lt;p&gt;The &lt;a href=&quot;QSqlRecord.html#QSqlRecord(com.trolltech.qt.sql.QSqlRecord)&quot;&gt;&lt;tt&gt;QSqlRecord&lt;/tt&gt;&lt;/a&gt; class encapsulates a database record.&lt;/p&gt;
&lt;p&gt;The &lt;a href=&quot;QSqlRecord.html#QSqlRecord(com.trolltech.qt.sql.QSqlRecord)&quot;&gt;&lt;tt&gt;QSqlRecord&lt;/tt&gt;&lt;/a&gt; class encapsulates the functionality and characteristics of a database record (usually a row in a table or view within the database). &lt;a href=&quot;QSqlRecord.html#QSqlRecord(com.trolltech.qt.sql.QSqlRecord)&quot;&gt;&lt;tt&gt;QSqlRecord&lt;/tt&gt;&lt;/a&gt; supports adding and removing fields as well as setting and retrieving field values.&lt;/p&gt;
&lt;p&gt;The values of a record's fields' can be set by name or position with &lt;a href=&quot;QSqlRecord.html#setValue(java.lang.String, java.lang.Object)&quot;&gt;&lt;tt&gt;setValue&lt;/tt&gt;&lt;/a&gt;; if you want to set a field to null use &lt;a href=&quot;QSqlRecord.html#setNull(java.lang.String)&quot;&gt;&lt;tt&gt;setNull&lt;/tt&gt;&lt;/a&gt;. To find the position of a field by name use &lt;a href=&quot;QSqlRecord.html#indexOf(java.lang.String)&quot;&gt;&lt;tt&gt;indexOf&lt;/tt&gt;&lt;/a&gt;, and to find the name of a field at a particular position use &lt;a href=&quot;QSqlRecord.html#fieldName(int)&quot;&gt;&lt;tt&gt;fieldName&lt;/tt&gt;&lt;/a&gt;. Use &lt;a href=&quot;QSqlRecord.html#field(java.lang.String)&quot;&gt;&lt;tt&gt;field&lt;/tt&gt;&lt;/a&gt; to retrieve a &lt;a href=&quot;QSqlField.html&quot;&gt;&lt;tt&gt;QSqlField&lt;/tt&gt;&lt;/a&gt; object for a given field. Use &lt;a href=&quot;QSqlRecord.html#contains(java.lang.String)&quot;&gt;&lt;tt&gt;contains&lt;/tt&gt;&lt;/a&gt; to see if the record contains a particular field name.&lt;/p&gt;
&lt;p&gt;When queries are generated to be executed on the database only those fields for which &lt;a href=&quot;QSqlRecord.html#isGenerated(int)&quot;&gt;&lt;tt&gt;isGenerated&lt;/tt&gt;&lt;/a&gt; is true are included in the generated SQL.&lt;/p&gt;
&lt;p&gt;A record can have fields added with &lt;a href=&quot;QSqlRecord.html#append(com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;append&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QSqlRecord.html#insert(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;insert&lt;/tt&gt;&lt;/a&gt;, replaced with &lt;a href=&quot;QSqlRecord.html#replace(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;replace&lt;/tt&gt;&lt;/a&gt;, and removed with &lt;a href=&quot;QSqlRecord.html#remove(int)&quot;&gt;&lt;tt&gt;remove&lt;/tt&gt;&lt;/a&gt;. All the fields can be removed with &lt;a href=&quot;QSqlRecord.html#clear()&quot;&gt;&lt;tt&gt;clear&lt;/tt&gt;&lt;/a&gt;. The number of fields is given by &lt;a href=&quot;QSqlRecord.html#count()&quot;&gt;&lt;tt&gt;count&lt;/tt&gt;&lt;/a&gt;; all their values can be cleared (to null) using &lt;a href=&quot;QSqlRecord.html#clearValues()&quot;&gt;&lt;tt&gt;clearValues&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QSqlField.html&quot;&gt;&lt;tt&gt;QSqlField&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;QSqlQuery::record&lt;/tt&gt; */">
    <method name="public QSqlRecord()" doc="/**
&lt;p&gt;Constructs an empty record.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#isEmpty()&quot;&gt;&lt;tt&gt;isEmpty&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#append(com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;append&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#insert(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;insert&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public QSqlRecord(com.trolltech.qt.sql.QSqlRecord other)" doc="/**
&lt;p&gt;Constructs a copy of &lt;tt&gt;other&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;QSqlRecord.html#QSqlRecord(com.trolltech.qt.sql.QSqlRecord)&quot;&gt;&lt;tt&gt;QSqlRecord&lt;/tt&gt;&lt;/a&gt; is implicitly shared&lt;/tt&gt;. This means you can make copies of a record in constant time&lt;/tt&gt;.&lt;/p&gt;
 */"/>
    <method name="public void append(com.trolltech.qt.sql.QSqlField field)" doc="/**
&lt;p&gt;Append a copy of field &lt;tt&gt;field&lt;/tt&gt; to the end of the record.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#insert(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;insert&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#replace(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;replace&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#remove(int)&quot;&gt;&lt;tt&gt;remove&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void clear()" doc="/**
&lt;p&gt;Removes all the record's fields.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#clearValues()&quot;&gt;&lt;tt&gt;clearValues&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#isEmpty()&quot;&gt;&lt;tt&gt;isEmpty&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void clearValues()" doc="/**
&lt;p&gt;Clears the value of all fields in the record and sets each field to null.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#setValue(java.lang.String, java.lang.Object)&quot;&gt;&lt;tt&gt;setValue&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean contains(java.lang.String name)" doc="/**
&lt;p&gt;Returns true if there is a field in the record called &lt;tt&gt;name&lt;/tt&gt;; otherwise returns false.&lt;/p&gt;
 */"/>
    <method name="public final int count()" doc="/**
&lt;p&gt;Returns the number of fields in the record.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#isEmpty()&quot;&gt;&lt;tt&gt;isEmpty&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.sql.QSqlField field(int i)" doc="/**
&lt;p&gt;Returns the field at position &lt;tt&gt;i&lt;/tt&gt;. If the position is out of range, an empty field is returned.&lt;/p&gt;
 */"/>
    <method name="public final com.trolltech.qt.sql.QSqlField field(java.lang.String name)" doc="/**
&lt;p&gt;Returns the field called &lt;tt&gt;name&lt;/tt&gt;.&lt;/p&gt;
 */"/>
    <method name="public final java.lang.String fieldName(int i)" doc="/**
&lt;p&gt;Returns the name of the field at position &lt;tt&gt;i&lt;/tt&gt;. If the field does not exist, an empty string is returned.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#indexOf(java.lang.String)&quot;&gt;&lt;tt&gt;indexOf&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int indexOf(java.lang.String name)" doc="/**
&lt;p&gt;Returns the position of the field called &lt;tt&gt;name&lt;/tt&gt; within the record, or -1 if it cannot be found. Field names are not case-sensitive. If more than one field matches, the first one is returned.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#fieldName(int)&quot;&gt;&lt;tt&gt;fieldName&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void insert(int pos, com.trolltech.qt.sql.QSqlField field)" doc="/**
&lt;p&gt;Inserts the field &lt;tt&gt;field&lt;/tt&gt; at position &lt;tt&gt;pos&lt;/tt&gt; in the record.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#append(com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;append&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#replace(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;replace&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#remove(int)&quot;&gt;&lt;tt&gt;remove&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean isEmpty()" doc="/**
&lt;p&gt;Returns true if there are no fields in the record; otherwise returns false.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#append(com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;append&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#insert(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;insert&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#clear()&quot;&gt;&lt;tt&gt;clear&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean isGenerated(java.lang.String name)" doc="/**
&lt;p&gt;Returns true if the record has a field called &lt;tt&gt;name&lt;/tt&gt; and this field is to be generated (the default); otherwise returns false.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#setGenerated(java.lang.String, boolean)&quot;&gt;&lt;tt&gt;setGenerated&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean isGenerated(int i)" doc="/**
&lt;p&gt;Returns true if the record has a field at position &lt;tt&gt;i&lt;/tt&gt; and this field is to be generated (the default); otherwise returns false.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#setGenerated(java.lang.String, boolean)&quot;&gt;&lt;tt&gt;setGenerated&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean isNull(java.lang.String name)" doc="/**
&lt;p&gt;Returns true if the field called &lt;tt&gt;name&lt;/tt&gt; is null or if there is no field called &lt;tt&gt;name&lt;/tt&gt;; otherwise returns false.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#setNull(java.lang.String)&quot;&gt;&lt;tt&gt;setNull&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean isNull(int i)" doc="/**
&lt;p&gt;Returns true if the field &lt;tt&gt;i&lt;/tt&gt; is null or if there is no field at position &lt;tt&gt;i&lt;/tt&gt;; otherwise returns false.&lt;/p&gt;
 */"/>
    <method name="public final void remove(int pos)" doc="/**
&lt;p&gt;Removes the field at position &lt;tt&gt;pos&lt;/tt&gt;. If &lt;tt&gt;pos&lt;/tt&gt; is out of range, nothing happens.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#append(com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;append&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#insert(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;insert&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#replace(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;replace&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void replace(int pos, com.trolltech.qt.sql.QSqlField field)" doc="/**
&lt;p&gt;Replaces the field at position &lt;tt&gt;pos&lt;/tt&gt; with the given &lt;tt&gt;field&lt;/tt&gt;. If &lt;tt&gt;pos&lt;/tt&gt; is out of range, nothing happens.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#append(com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;append&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#insert(int, com.trolltech.qt.sql.QSqlField)&quot;&gt;&lt;tt&gt;insert&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#remove(int)&quot;&gt;&lt;tt&gt;remove&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setGenerated(int i, boolean generated)" doc="/**
&lt;p&gt;Sets the generated flag for the field &lt;tt&gt;i&lt;/tt&gt; to &lt;tt&gt;generated&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#isGenerated(int)&quot;&gt;&lt;tt&gt;isGenerated&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setGenerated(java.lang.String name, boolean generated)" doc="/**
&lt;p&gt;Sets the generated flag for the field called &lt;tt&gt;name&lt;/tt&gt; to &lt;tt&gt;generated&lt;/tt&gt;. If the field does not exist, nothing happens. Only fields that have &lt;tt&gt;generated&lt;/tt&gt; set to true are included in the SQL that is generated by &lt;a href=&quot;QSqlQueryModel.html&quot;&gt;&lt;tt&gt;QSqlQueryModel&lt;/tt&gt;&lt;/a&gt; for example.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#isGenerated(int)&quot;&gt;&lt;tt&gt;isGenerated&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setNull(int i)" doc="/**
&lt;p&gt;Sets the value of field &lt;tt&gt;i&lt;/tt&gt; to null. If the field does not exist, nothing happens.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#setValue(java.lang.String, java.lang.Object)&quot;&gt;&lt;tt&gt;setValue&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setNull(java.lang.String name)" doc="/**
&lt;p&gt;Sets the value of the field called &lt;tt&gt;name&lt;/tt&gt; to null. If the field does not exist, nothing happens.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#isNull(int)&quot;&gt;&lt;tt&gt;isNull&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setValue(int i, java.lang.Object val)" doc="/**
&lt;p&gt;Sets the value of the field at position &lt;tt&gt;i&lt;/tt&gt; to &lt;tt&gt;val&lt;/tt&gt;. If the field does not exist, nothing happens.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#setNull(java.lang.String)&quot;&gt;&lt;tt&gt;setNull&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setValue(java.lang.String name, java.lang.Object val)" doc="/**
&lt;p&gt;Sets the value of the field called &lt;tt&gt;name&lt;/tt&gt; to &lt;tt&gt;val&lt;/tt&gt;. If the field does not exist, nothing happens.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#value(java.lang.String)&quot;&gt;&lt;tt&gt;value&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final java.lang.Object value(int i)" doc="/**
&lt;p&gt;Returns the value of the field located at position &lt;tt&gt;i&lt;/tt&gt; in the record. If &lt;tt&gt;i&lt;/tt&gt; is out of bounds, an invalid &lt;a href=&quot;%2E%2E/porting4.html#qvariant&quot;&gt;&lt;tt&gt;QVariant&lt;/tt&gt;&lt;/a&gt; is returned.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#fieldName(int)&quot;&gt;&lt;tt&gt;fieldName&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#isNull(int)&quot;&gt;&lt;tt&gt;isNull&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final java.lang.Object value(java.lang.String name)" doc="/**
&lt;p&gt;Returns the value of the field called &lt;tt&gt;name&lt;/tt&gt; in the record. If field &lt;tt&gt;name&lt;/tt&gt; does not exist an invalid variant is returned.&lt;/p&gt;

@see &lt;a href=&quot;QSqlRecord.html#setValue(java.lang.String, java.lang.Object)&quot;&gt;&lt;tt&gt;setValue&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QSqlRecord.html#indexOf(java.lang.String)&quot;&gt;&lt;tt&gt;indexOf&lt;/tt&gt;&lt;/a&gt; */"/>
</class>