3 # Copyright (C) 2006 Jason Woofenden
5 # This program is free software: you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation, either version 3 of the License, or
8 # (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program. If not, see <http://www.gnu.org/licenses/>.
18 # pass an integer, returns the suffix
19 function ordinal_suffix($i) {
21 if(strlen($i) > 1 && substr($i, -2, 1) === '1') {
24 switch(substr($i, -1)) {
38 # ordinalize(1) => "1st"
39 # ordinalize(2) => "2nd"
40 # ordinalize(3) => "3rd"
41 # ordinalize(111) => "111th"
42 # ordinalize("62") => "62nd"
43 function ordinalize($i) {
44 return $i . ordinal_suffix($i);
47 # remove the $key from $_REQUEST and return it's value (or null if it's not there)
48 function _REQUEST_cut($key) {
49 if(!isset($_REQUEST[$key])) {
52 $ret = $_REQUEST[$key];
53 unset($_REQUEST[$key]);
57 # returns an array containing just the elements of $pipes that are readable (without blocking)
58 # timeout 0 means don't wait, timeout NULL means wait indefinitely
59 function readable_sockets($pipes, $timeout = 0){
60 $read = array_values($pipes);
61 $ret = stream_select($read, $write = NULL, $exceptions = NULL, $timeout);
79 function exec_pipe($command, $stdin) {
80 $descriptorspec = array(
81 0 => array('pipe', 'r'), // stdin is a pipe that the child will read from
82 1 => array('pipe', 'w'), // stdout is a pipe that the child will write to
83 2 => array('file', '/dev/null', 'w') // stderr is a pipe that the child will write to
86 $process = proc_open($command, $descriptorspec, $pipes);
88 if (is_resource($process)) {
89 fwrite($pipes[0], $stdin);
92 while (!feof($pipes[1])) {
93 $chunk = fread($pipes[1], 1024);
100 // It is important that you close any pipes before calling
101 // proc_close in order to avoid a deadlock
102 $return_value = proc_close($process);
104 return array($return_value, $stdout);
109 function unix_newlines($str) {
110 $str = str_replace("\r\n", "\n", $str);
111 return str_replace("\r", "\n", $str);
115 # return current year (all 4 digits)
116 function this_year() {
117 return strftime('%Y');
120 # return the number of the current month (1..12)
121 function this_month() {
122 return ereg_replace('^0', '', strftime('%m'));
125 # return today's date in yyyy-mm-dd format
126 function today_ymd() {
127 return strftime('%Y-%m-%d');
130 function now_yyyymmdd() {
131 return strftime('%Y-%m-%d');
134 function now_yyyymmddhhmmss() {
135 return strftime('%Y-%m-%d %H:%M:%S');
139 function get_text_between($text, $start_text, $end_text) {
140 $start = strpos($text, $start_text);
141 if($start === false) {
144 $text = substr($text, $start + strlen($start_text));
145 $end = strpos($text, $end_text);
149 return substr($text, 0, $end);
152 # Make it easy to insert an array into the template data structure so that each
153 # element of the array gets its own row.
155 # passed this: columnize(array('a', 'b', 'c'), 'k');
156 # it returns: array(array('k' => 'a'),
158 # array('k' => 'c'));
159 # passed this: columnate(array(), 'k');
161 function columnize($arr, $key = 'data') {
166 foreach($arr as $val) {
167 $ret[] = array($key => $val);
172 # php4 is broken, in that you cannot set a default value for a parameter that
173 # is passed by reference. So, this is set up to use the following screwy
176 # function foo($bar = 0) {
186 class stupid_reference {
188 function stupid_reference(&$ref) {
192 function ref(&$foo) {
193 return new stupid_reference($foo);
196 function &last(&$array) {
197 if(count($array)) return $array[count($array) - 1];