X-Git-Url: https://jasonwoof.com/gitweb/?p=wfpl.git;a=blobdiff_plain;f=misc.php;h=4aaa49503f5499a318c5cffc671c8682a639f4cb;hp=18a1a41727a99a4968efff7008900a80207fce26;hb=HEAD;hpb=ddd681b6dcd0ef511238e96a0c3b94d9e8600ef2

diff --git a/misc.php b/misc.php
index 18a1a41..4aaa495 100644
--- a/misc.php
+++ b/misc.php
@@ -1,41 +1,108 @@
 <?php
 
-#  Copyright (C) 2006 Jason Woofenden
-#
-#  This file is part of wfpl.
-#
-#  wfpl 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 2.1 of the License, or (at your option)
-#  any later version.
-#
-#  wfpl 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 wfpl; if not, write to the Free Software Foundation, Inc., 51
-#  Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-
-# This exists because file_get_contents() is not documented well. (It says that
-# the second parameter is optional, but does not specify what happens when you
-# do not pass anything.) And because it's nice to work in PHP4.2
-function read_whole_file($name) {
-	$fd = fopen($name, 'r');
-	if($fd === false) {
-		die("Failed to read file: '$name'");
+# This program is in the public domain within the United States. Additionally,
+# we waive copyright and related rights in the work worldwide through the CC0
+# 1.0 Universal public domain dedication, which can be found at
+# http://creativecommons.org/publicdomain/zero/1.0/
+
+
+# pass an integer, returns the suffix
+function ordinal_suffix($i) {
+	# teens are all __th
+	if(strlen($i) > 1 && substr($i, -2, 1) === '1') {
+		return 'th';
+	}
+	switch(substr($i, -1)) {
+		case '':
+			return '';
+		case '1':
+			return 'st';
+		case '2':
+			return 'nd';
+		case '3':
+			return 'rd';
+		default;
+			return 'th';
+	}
+}
+
+# ordinalize(1) => "1st"
+# ordinalize(2) => "2nd"
+# ordinalize(3) => "3rd"
+# ordinalize(111) => "111th"
+# ordinalize("62") => "62nd"
+function ordinalize($i) {
+	return $i . ordinal_suffix($i);
+}
+
+# remove the $key from $_REQUEST and return it's value (or null if it's not there)
+function _REQUEST_cut($key) {
+	if(!isset($_REQUEST[$key])) {
+		return null;
+	}
+	$ret = $_REQUEST[$key];
+	unset($_REQUEST[$key]);
+	return $ret;
+}
+
+# returns an array containing just the elements of $pipes that are readable (without blocking)
+# timeout 0 means don't wait, timeout NULL means wait indefinitely
+function readable_sockets($pipes, $timeout = 0){
+	$read = array_values($pipes);
+	$ret = stream_select($read, $write = NULL, $exceptions = NULL, $timeout);
+	if($ret === false) {
+		return false;
+	}
+	if($ret) {
+		return $read;
+	} else {
+		return array();
+	}
+}
+
+
+# Parameters:
+#     command
+#     stdin
+# Returns: (as array)
+#     exit code
+#     stdout
+function exec_pipe($command, $stdin) {
+	$descriptorspec = array(
+   	   0 => array('pipe', 'r'),  // stdin is a pipe that the child will read from
+   	   1 => array('pipe', 'w'),  // stdout is a pipe that the child will write to
+   	   2 => array('file', '/dev/null', 'w')   // stderr is a pipe that the child will write to
+	);
+
+	$process = proc_open($command, $descriptorspec, $pipes);
+
+	if (is_resource($process)) {
+		fwrite($pipes[0], $stdin);
+		fclose($pipes[0]);
+
+		while (!feof($pipes[1])) {
+			$chunk = fread($pipes[1], 1024);
+			$stdout .= $chunk;
+			sleep(0.5);
+		}
+
+		fclose($pipes[1]);
+
+		// It is important that you close any pipes before calling
+		// proc_close in order to avoid a deadlock
+		$return_value = proc_close($process);
+
+		return array($return_value, $stdout);
 	}
-	$file_data = fread($fd, filesize($name));
-	fclose($fd);
-	return $file_data;
 }
 
+
 function unix_newlines($str) {
 	$str = str_replace("\r\n", "\n", $str);
 	return str_replace("\r", "\n", $str);
 }
 
+
 # return current year (all 4 digits)
 function this_year() {
 	return strftime('%Y');
@@ -43,10 +110,56 @@ function this_year() {
 
 # return the number of the current month (1..12)
 function this_month() {
-	return ereg_replace('^0', '', strftime('%m'));
+	return preg_replace('|^0|', '', strftime('%m'));
+}
+
+# return today's date in yyyy-mm-dd format
+function today_ymd() {
+	return strftime('%Y-%m-%d');
+}
+
+function now_yyyymmdd() {
+	return strftime('%Y-%m-%d');
+}
+
+function now_yyyymmddhhmmss() {
+	return strftime('%Y-%m-%d %H:%M:%S');
 }
 
 
+function get_text_between($text, $start_text, $end_text) {
+	$start = strpos($text, $start_text);
+	if($start === false) {
+		return false;
+	}
+	$text = substr($text, $start + strlen($start_text));
+	$end = strpos($text, $end_text);
+	if($end === false) {
+		return false;
+	}
+	return substr($text, 0, $end);
+}
+
+# Make it easy to insert an array into the template data structure so that each
+# element of the array gets its own row.
+#
+# passed this: columnize(array('a', 'b', 'c'), 'k');
+# it returns: array(array('k' => 'a'),
+#                   array('k' => 'b'),
+#                   array('k' => 'c'));
+# passed this: columnize(array(), 'k');
+# it returns: false
+function columnize($arr, $key = 'data') {
+	if(!$arr) {
+		return false;
+	}
+	$ret = array();
+	foreach($arr as $val) {
+		$ret[] = array($key => $val);
+	}
+	return $ret;
+}
+
 # php4 is broken, in that you cannot set a default value for a parameter that
 # is passed by reference. So, this is set up to use the following screwy
 # syntax:
@@ -71,4 +184,6 @@ function ref(&$foo) {
 	return new stupid_reference($foo);
 }
 
-?>
+function &last(&$array) {
+	if(count($array)) return $array[count($array) - 1];
+}