Fixed #21316 -- Documented that modifying safe strings makes them unsafe.

Thanks dev@simon.net.nz for the suggestion and vijay_shanker for the patch.
This commit is contained in:
Tim Graham 2013-10-30 08:11:31 -04:00
parent b47a052eb5
commit 1edef50880
1 changed files with 11 additions and 0 deletions

View File

@ -764,6 +764,17 @@ appropriate entities.
Can be called multiple times on a single string.
String marked safe will become unsafe again if modified. For example::
>>> mystr = '<b>Hello World</b> '
>>> mystr = mark_safe(mystr)
>>> type(mystr)
<class 'django.utils.safestring.SafeBytes'>
>>> mystr = mystr.strip() # removing whitespace
>>> type(mystr)
<type 'str'>
.. function:: mark_for_escaping(s)
Explicitly mark a string as requiring HTML escaping upon output. Has no