take_user_tags
Description:
Takes all the user_tags
, which replaces any current user tags on the this.
The passed-in user_tags
is consumed by the this, which becomes an owner of it. The caller
should not change user_tags
afterwards.
If the this changed, the 'dirty' flag and the 'folder-flagged' flag are set automatically, unless the this is aborting notifications. There is also emitted folder's "changed" signal for this this, if necessary.
Note that it's not safe to use the user_tags
after the call to this function, because it can be freed due to no change.
Parameters:
this | |
user_tags |
user tags to set |
Returns:
Whether the this changed. |