DevOrSysAdminScripts/unicode_exceptions.libr.php at main · LLyaudet/DevOrSysAdminScripts · GitHub

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
<?php

/**
This file is part of DevOrSysAdminScripts.

DevOrSysAdminScripts is free software:
you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License
as published by the Free Software Foundation,
either version 3 of the License,
or (at your option) any later version.

DevOrSysAdminScripts is distributed
in the hope that it will be useful,
but WITHOUT ANY WARRANTY;
without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details.

You should have received a copy of
the GNU Lesser General Public License
along with DevOrSysAdminScripts.
If not, see <https://www.gnu.org/licenses/>.

©Copyright 2023-2026 Laurent Frédéric Bernard François Lyaudet
This file was renamed from "unicode.php" to "unicode.libr.php".

@category Library
@package DevOrSysAdminScripts
@author Laurent Lyaudet <laurent.lyaudet@gmail.com>
@copyright 2023-2026 Laurent Frédéric Bernard François Lyaudet
@license https://www.gnu.org/licenses/lgpl-3.0.html LGPLv3+
*/

declare(strict_types=1);
declare(encoding='UTF-8');

namespace DOSAS_unicode;

/**
A class to enhance standard PHP Exception with an array of data.

@category Library
@package DevOrSysAdminScripts
@author Laurent Lyaudet <laurent.lyaudet@gmail.com>
@license https://www.gnu.org/licenses/lgpl-3.0.html LGPLv3+
*/
class WithDataArrayException extends \Exception {
  /**
  A data array to store details related to an exception.

  @var array $arr_data
  */
  protected $arr_data;


  /**
  Constructor for WithDataArrayException.

  @param string $message
  @param array $arr_data

  @return void
  */
  public function __construct(string $message, array $arr_data = []) {
    $this->arr_data = $arr_data;
    parent::__construct($message);
  }//end __construct() WithDataArrayException


  /**
  Getter to obtain the data array with details of the exception.

  @return array
  */
  public function get_data() : array {
    return $this->arr_data;
  }//end get_data()
}//end class WithDataArrayException


/**
A class to specialize WithDataArrayException for use with invalid
encoding detection (ASCII and UTF-8 validation) in unicode.libr.php.

@category Library
@package DevOrSysAdminScripts
@author Laurent Lyaudet <laurent.lyaudet@gmail.com>
@license https://www.gnu.org/licenses/lgpl-3.0.html LGPLv3+
*/
class InvalidEncodingException extends WithDataArrayException {
}//end class InvalidEncodingException

?>