| … | |
… | |
| 1586 | } |
1586 | } |
| 1587 | |
1587 | |
| 1588 | =item $handle->destroy |
1588 | =item $handle->destroy |
| 1589 | |
1589 | |
| 1590 | Shuts down the handle object as much as possible - this call ensures that |
1590 | Shuts down the handle object as much as possible - this call ensures that |
| 1591 | no further callbacks will be invoked and resources will be freed as much |
1591 | no further callbacks will be invoked and as many resources as possible |
| 1592 | as possible. You must not call any methods on the object afterwards. |
1592 | will be freed. You must not call any methods on the object afterwards. |
| 1593 | |
1593 | |
| 1594 | Normally, you can just "forget" any references to an AnyEvent::Handle |
1594 | Normally, you can just "forget" any references to an AnyEvent::Handle |
| 1595 | object and it will simply shut down. This works in fatal error and EOF |
1595 | object and it will simply shut down. This works in fatal error and EOF |
| 1596 | callbacks, as well as code outside. It does I<NOT> work in a read or write |
1596 | callbacks, as well as code outside. It does I<NOT> work in a read or write |
| 1597 | callback, so when you want to destroy the AnyEvent::Handle object from |
1597 | callback, so when you want to destroy the AnyEvent::Handle object from |
