DBIx/Class/Row.pm

69 C<$attrs> is a hashref of column name, value data. It can also contain
72 Passing an object, or an arrayref of objects as a value will call
74 passed a hashref or an arrayref of hashrefs as the value, these will
80 Please note that if a value is not passed to new, no value will be sent
81 in the SQL INSERT call, and the column will therefore assume whatever
82 default value was specified in your database. While DBIC will retrieve the
83 value of autoincrement columns, it will never make an explicit database
92  with a database-defined default. If you call the relationship accessor on
93  an object that doesn't have a set value for the FK column, DBIC will throw
99 ## It needs to store the new objects somewhere, and call insert on that list later when insert is called on this object. We may need an accessor for these so the user can retrieve them, if just doing ->new().
262 To fetch an uninserted row object, call
400   $row->in_storage; # Get value
401   $row->in_storage(1); # Set value
445 Also takes an optional hashref of C<< column_name => value> >> pairs
448 don't rely on it being the same after a call to C<update>.  If you
461 as a result of the update call, if you want the object to be updated
462 with the actual values from the database, call L</discard_changes>
468 changed and will be updated, call L</get_dirty_columns>.
470 To check if any columns will be updated, call L</is_changed>.
472 To force a column to be updated, call L</make_column_dirty> before
575 =item Returns: The value of the column
582 Returns a raw column value from the row object, if it has already
585 If an L<inflated value|DBIx::Class::InflateColumn> has been set, it
591 this method will return C<undef> even if the database contains some value.
623 Returns a true value if the column value has been loaded from the
630   $self->throw_exception( "Can't call has_column data as class method" ) unless ref $self;
643 =item Returns: A hash of columnname, value pairs.
648 get just one value for a particular column, use L</get_column>.
673 =item Returns: A hash of column, value pairs
677 Only returns the column, value pairs for those columns that have been
678 changed on this object since the last L</update> or L</insert> call.
680 See L</get_columns> to fetch all column/value pairs.
720   # value, force it over the deflated one
738 =item Returns: A hash of column, object|value pairs
796 =item Arguments: $columnname, $value
798 =item Returns: $value
802 Sets a raw column value. If the new value is different from the old one,
803 the column is marked as dirty for when you next call L</update>.
805 If passed an object or reference as a value, this method will happily
842   # sadly the update code just checks for keys, not for their value
863 Sets multiple column, raw value pairs at once.
889 Sets more than one column value at once. Any inflated values are
894 instead of related row objects, a hashref of column, value data is
897 Will even accept arrayrefs of data as a value to a
902 on it being the same after a call to C<set_inflated_columns>. If you
955 relationship specifies a true value for its
1009 =item Arguments: $columnname, $value
1011 =item Returns: The value sent to storage
1015 Set a raw value for a column without marking it as changed. This
1025   my ($self, $column, $value) = @_;
1028   $self->throw_exception( "set_column called for ${column} without value" )
1030   return $self->{_column_data}{$column} = $value;
1046 database and turn it into row objects call this method.
1174 in scalar context returns a true value if there are uncommitted
1195 Returns a true value if the column has uncommitted changes.
1244 key, creates an accessor named after the value if defined; if there is