user_guide_src/source/helpers/xml_helper.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

##########
XML Helper
##########

The XML Helper file contains functions that assist in working with XML
data.

.. contents::
  :local:

.. raw:: html

  <div class="custom-index container"></div>

Loading this Helper
===================

This helper is loaded using the following code

::

	$this->load->helper('xml');

Available Functions
===================

The following functions are available:

.. function:: xml_convert($str[, $protect_all = FALSE])

  :param string $str: the text string to convert
  :param bool $protect_all: Whether to protect all content that looks like a potential entity instead of just numbered entities, e.g. &foo;
  :returns: string

  Takes a string as input and converts the following reserved XML
  characters to entities:

  - Ampersands: &
  - Less then and greater than characters: < >
  - Single and double quotes: ' "
  - Dashes: -

  This function ignores ampersands if they are part of existing numbered
  character entities, e.g. &#123;. Example::

    $string = '<p>Here is a paragraph & an entity (&#123;).</p>';
    $string = xml_convert($string);
    echo $string;

  outputs:

  .. code-block:: html

    &lt;p&gt;Here is a paragraph &amp; an entity (&#123;).&lt;/p&gt;