From: Andrey Hristov <andrey@php.net>
Date: Wed, 25 Sep 2002 18:06:05 +0000 (+0000)
Subject: str_shuffle() function added. Like shuffle() for arrays - however the
X-Git-Tag: MODERN_SYMMETRIC_SESSION_BEHAVIOUR_20021003~184
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fc46a46b06355234dadc98268bf9eea6b903c54e;p=php

str_shuffle() function added. Like shuffle() for arrays - however the
algorithm for creating the permutation is quite simple. More like
the implementation of shuffle() for 4.2.1 .
---

diff --git a/ext/standard/basic_functions.c b/ext/standard/basic_functions.c
index cfa03d6afb..43548224e1 100644
--- a/ext/standard/basic_functions.c
+++ b/ext/standard/basic_functions.c
@@ -329,6 +329,7 @@ function_entry basic_functions[] = {
 	PHP_FE(strstr,															NULL)
 	PHP_FE(stristr,															NULL)
 	PHP_FE(strrchr,															NULL)
+	PHP_FE(str_shuffle,															NULL)
 
 #ifdef HAVE_STRCOLL
 	PHP_FE(strcoll,															NULL)
diff --git a/ext/standard/php_string.h b/ext/standard/php_string.h
index 6fbc57bd42..4b10700762 100644
--- a/ext/standard/php_string.h
+++ b/ext/standard/php_string.h
@@ -82,6 +82,7 @@ PHP_FUNCTION(strnatcasecmp);
 PHP_FUNCTION(substr_count);
 PHP_FUNCTION(str_pad);
 PHP_FUNCTION(sscanf);
+PHP_FUNCTION(str_shuffle);
 #ifdef HAVE_STRCOLL
 PHP_FUNCTION(strcoll);
 #endif
diff --git a/ext/standard/string.c b/ext/standard/string.c
index 09d6f71d82..5f2c0538cd 100644
--- a/ext/standard/string.c
+++ b/ext/standard/string.c
@@ -3933,6 +3933,39 @@ PHP_FUNCTION(str_rot13)
 /* }}} */
 
 
+static int php_string_shuffle(const void *a, const void *b TSRMLS_DC)
+{
+	long rnd;
+	rnd = php_rand(TSRMLS_C);
+	if (rnd % 3)
+		return 1;
+	else if (rnd % 5)
+		return 0;
+	else 
+		return -1;
+}
+
+/* {{{ proto string str_shuffle(string str)
+   Shuffles string. One permutation of all possible is created */
+PHP_FUNCTION(str_shuffle)
+{
+	/* Note : by using current php_string_shuffle for string  */
+	/* with 6 chars (6! permutations) about 2/3 of them are   */
+	/* computed for 6! calls for the function. So it isn't so */
+	/* unique. The ratio is the same for other lengths.       */
+	char *str;
+	int i, str_len;
+	
+	i = 0;
+	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &str, &str_len) == FAILURE) {
+		RETURN_FALSE;
+	}
+	zend_qsort((void *)str, str_len, sizeof(char), php_string_shuffle TSRMLS_CC);
+	RETURN_STRINGL(str, str_len, 1);
+}
+/* }}} */
+
+
 #if HAVE_STRFMON
 /* {{{ proto string money_format(string format , float value)
    Convert monetary value(s) to string */