bccomp(3) [php man page]

BCCOMP(3)								 1								 BCCOMP(3)

bccomp - Compare two arbitrary precision numbers

SYNOPSIS

       int bccomp (string  $left_operand, string  $right_operand, [int	$scale = int])

DESCRIPTION

	Compares the $left_operand to the $right_operand and returns the result as an integer.

PARAMETERS

	      o $left_operand
		- The left operand, as a string.

	      o $right_operand
		- The right operand, as a string.

	      o $scale
		- The optional $scale parameter is used to set the number of digits after the decimal place which will be used in the comparison.

RETURN VALUES

	Returns 0 if the two operands are equal, 1 if the $left_operand is larger than the $right_operand, -1 otherwise.

EXAMPLES

       Example #1

	      bccomp(3) example

	      <?php

	      echo bccomp('1', '2') . "
";   // -1
	      echo bccomp('1.00001', '1', 3); // 0
	      echo bccomp('1.00001', '1', 5); // 1

	      ?>

PHP Documentation Group 														 BCCOMP(3)

SUBSTR_COMPARE(3)							 1							 SUBSTR_COMPARE(3)

substr_compare - Binary safe comparison of two strings from an offset, up to length characters

SYNOPSIS

       int substr_compare (string  $main_str, string  $str, int  $offset, [int	$length], [bool  $case_insensitivity = false])

DESCRIPTION

       substr_compare(3) compares $main_str from position $offset with $str up to $length characters.

PARAMETERS

	      o $main_str
		- The main string being compared.

	      o $str
		- The secondary string being compared.

	      o $offset
		- The start position for the comparison. If negative, it starts counting from the end of the string.

	      o $length
		-  The	length	of  the comparison. The default value is the largest of the length of the $str compared to the length of $main_str
		less the $offset.

	      o $case_insensitivity
		- If $case_insensitivity is TRUE, comparison is case insensitive.

RETURN VALUES

	Returns < 0 if $main_str from position $offset is less than $str, > 0 if it is greater than $str, and 0 if they are equal. If  $offset	is
       equal  to  or greater than the length of $main_str, or the $length is set and is less than 1 (prior to PHP 5.6), substr_compare(3) prints a
       warning and returns FALSE.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.6.0	|						    |
       |	|						    |
       |	|		$length may now be 0.		    |
       |	|						    |
       | 5.1.0	|						    |
       |	|						    |
       |	|  Added the possibility to use a negative $offset. |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      A substr_compare(3) example

	      <?php
	      echo substr_compare("abcde", "bc", 1, 2); // 0
	      echo substr_compare("abcde", "de", -2, 2); // 0
	      echo substr_compare("abcde", "bcg", 1, 2); // 0
	      echo substr_compare("abcde", "BC", 1, 2, true); // 0
	      echo substr_compare("abcde", "bc", 1, 3); // 1
	      echo substr_compare("abcde", "cd", 1, 2); // -1
	      echo substr_compare("abcde", "abc", 5, 1); // warning
	      ?>

SEE ALSO

       strncmp(3).

PHP Documentation Group 													 SUBSTR_COMPARE(3)