chr
I'm not sure what versions this also occurs in but the output of chunk_split() in PHP 5.0.4 does not match the output in other versions of PHP.
In all versions of PHP I have used, apart from 5.0.4 chunk_split() adds the separator (\r\n) to the end of the string. But in PHP 5.0.4 this does not happen. This had a fairly serious impact on a library I maintain so it may also affect others who are not aware of this.
chunk_split
(PHP 4, PHP 5)
chunk_split — Split a string into smaller chunks
Description
string chunk_split
( string
$body
[, int $chunklen = 76
[, string $end = "\r\n"
]] )
Can be used to split a string into smaller chunks which is useful for
e.g. converting base64_encode() output to match RFC
2045 semantics. It inserts end every
chunklen characters.
Parameters
-
body -
The string to be chunked.
-
chunklen -
The chunk length.
-
end -
The line ending sequence.
Return Values
Returns the chunked string.
Examples
Example #1 chunk_split() example
<?php
// format $data using RFC 2045 semantics
$new_string = chunk_split(base64_encode($data));
?>
See Also
- str_split() - Convert a string to an array
- explode() - Split a string by string
- split() - Split string into array by regular expression
- wordwrap() - Wraps a string to a given number of characters
- » RFC 2045
add a note
User Contributed Notes
chunk_split - [24 notes]
chris AT w3style.co DOT uk ¶
6 years ago
mark [at] d0gz [dot] net ¶
6 years ago
When using ssmtp for simple command line mailing:
$mail_to = "destination@emailbox.com";
$msg = "this would be an actual base64_encoded gzip msg";
$date = date(r);
$mail = "X-FROM: root@sender.org \n";
$mail .= "X-TO: ".$mail_to. " \n";
$mail .= "To: ".$mail_to. " \n";
$mail .= "Date: $date \n";
$mail .= "From: root@sender.org \n";
$mail .= "Subject: lifecheck \n";
$mail .= $msg." \n";
exec("echo '$mail' | /usr/sbin/ssmtp ".$mail_to);
be sure to invoke chunk_split() on your message body - ssmtp becomes unhappy with long lines and will subsequently trash your message.
dampee at earthlink dot net ¶
3 years ago
I've found this quite useful for simulating various kinds of shuffles with cards. It is humorous but can imitate multiple deck cuts and other (imperfectly) random events.
<?php
function truffle_shuffle($body, $chunklen = 76, $end = "\r\n")
{
$chunk = chunk_split($body, $chunklen, "-=blender=-");
$truffle = explode("-=blender=-",$chunk);
$shuffle = shuffle($truffle);
$huknc = implode($end,$shuffle);
return $huknc;
}
?>
tim at weird spots in my crotch dot com ¶
4 years ago
@Royce
I think this is better, since you can still use the ampersand in your text:
<?php
function HtmlEntitySafeSplit($html,$size,$delim)
{
$pos=0;
for($i=0;$i<strlen($html);$i++)
{
if($pos >= $size && !$unsafe)
{
$out.=$delim;
$unsafe=0;
$pos=0;
}
$c=substr($html,$i,1);
if($c == "&")
$unsafe=1;
elseif($c == ";")
$unsafe=0;
elseif($c == " ")
$unsafe=0;
$out.=$c;
$pos++;
}
return $out;
}
?>
phpkid ¶
7 years ago
Well I have been having issues with a shoutbox I am coding it would keep expanding the <TD> if there were large words in it but I fixed it with this:
function PadString($String){
$Exploded = explode(" ", $String);
$Max_Parts = count($Exploded);
$CurArray = 0;
$OutString = '';
while($CurArray<=$Max_Parts)
{
$Peice_Size = strlen($Exploded[$CurArray]);
if($Peice_Size>15)
{
$OutString .= chunk_split($Exploded[$CurArray], 12, " ");
$CurArray++;
} else {
$OutString .= " ".$Exploded[$CurArray];
$CurArray++;
}
}
return $OutString;
}
mv@NOSPAM ¶
9 years ago
the best way to solve the problem with the last string added by chunk_split() is:
<?php
$string = '1234';
substr(chunk_split($string, 2, ':'), 0, -1);
// will return 12:34
?>
Danilo ¶
9 years ago
>> chunk_split will also add the break _after_ the last occurence.
this should be not the problem
substr(chunk_split('FF99FF', 2, ':'),0,8);
will return FF:99:FF
qeremy [atta] gmail [dotta] com ¶
1 year ago
An alternative for unicode strings;
<?php
function chunk_split_unicode($str, $l = 76, $e = "\r\n") {
$tmp = array_chunk(
preg_split("//u", $str, -1, PREG_SPLIT_NO_EMPTY), $l);
$str = "";
foreach ($tmp as $t) {
$str .= join("", $t) . $e;
}
return $str;
}
$str = "Yarım kilo çay, yarım kilo şeker";
echo chunk_split($str, 4) ."\n";
echo chunk_split_unicode($str, 4);
?>
Yar�
�m k
ilo
çay
, ya
rım
kil
o ş
eker
Yarı
m ki
lo ç
ay,
yarı
m ki
lo ş
eker
kevin @t hyguard,com ¶
7 years ago
Not quite completely obvious, but...
you can un_chunk_split() by:
$long_str = str_replace( "\r\n", "", $chunked_str );
neos at blizzz dot ru ¶
4 years ago
"version" of chunk_split for cyrillic characters in UTF-8
public function UTFChunk($Text,$Len = 10,$End = "\r\n")
{
if(mb_detect_encoding($Text) == "UTF-8")
{
return mb_convert_encoding(
chunk_split(
mb_convert_encoding($Text, "KOI8-R","UTF-8"), $Len,$End
),
"UTF-8", "KOI8-R"
);
} else
{
return chunk_split($Text,$Len,$End);
}
}
this is example for russian language
belal dot nabeh at gmail dot com ¶
2 years ago
If you are using UTF-8 charset you will face a problem with Arabic language
to solve this problem i used this function
<?php
function chunk_split_($text,$length,$string_end)
{
$text = iconv("UTF-8","windows-1256",$text);
$text = str_split($text);
foreach($text as $val)
{
if($a !== $val)
{
$a = $val;
$x = 0;
}else{
$a = $val;
$x++;
}
if($x > $length)
{
$new_text .= $val.$string_end;
$x = 0;
}else
{
$new_text .= $val;
}
}
$new_text = iconv("windows-1256","UTF-8",$new_text);
return $new_text;
}
?>
Peter from dezzignz.com ¶
3 years ago
chunk_split() is not multibyte safe. If you ever run into needing the function that is multibyte safe, here you go:
<?php
function mbStringToArray ($str) {
if (empty($str)) return false;
$len = mb_strlen($str);
$array = array();
for ($i = 0; $i < $len; $i++) {
$array[] = mb_substr($str, $i, 1);
}
return $array;
}
function mb_chunk_split($str, $len, $glue) {
if (empty($str)) return false;
$array = mbStringToArray ($str);
$n = 0;
$new = '';
foreach ($array as $char) {
if ($n < $len) $new .= $char;
elseif ($n == $len) {
$new .= $glue . $char;
$n = 0;
}
$n++;
}
return $new;
}
?>
Royce ¶
5 years ago
Here's a version of Chunk Split I wrote that will not split html entities. Useful if you need to inject something in html (in my case, <wbr/> tags to allow for long text wrapping).
<?php
function HtmlEntitySafeSplit($html,$size,$delim)
{
$pos=0;
for($i=0;$i<strlen($html);$i++)
{
if($pos >= $size && !$unsafe)
{
$out.=$delim;
$unsafe=0;
$pos=0;
}
$c=substr($html,$i,1);
if($c == "&")
$unsafe=1;
elseif($c == ";")
$unsafe=0;
$out.=$c;
$pos++;
}
return $out;
}
?>
lehongviet at gmail dot com ¶
5 years ago
This function works well to cut long para for preview without cutting word. Good for Unicode such as ṭ
function split_hjms_chars($xstr, $xlenint, $xlaststr)
{
$xlenint = strpos($xstr," ",$xlenint);
return substr($xstr,0,$xlenint).$xlaststr;
}
hansvane at yahoo dot com dot ar ¶
6 years ago
This function is very simple and many other functions make this on PHP 5 and even some ones in 4 the good think about this one is that work on php 3.0.6 and 4
function split_hjms_chars($xstr, $xlenint, $xlaststr)
{
$texttoshow = chunk_split($xstr,$xlenint,"\r\n");
$texttoshow = split("\r\n",$texttoshow);
$texttoshow = $texttoshow[0].$xlaststr;
return $texttoshow;
}
// For use
echo split_hjms_chars("This is your text",6,"...");
// Will return
This i...
It is useful to cut long text on preview lists and if the server it's old.
Hope it helps some one. Hans Svane
harish at thespitbox dot net ¶
7 years ago
another way to group thousands in a number, which is much simpler, is built into PHP :)
www.php.net/number_format
Kevin ¶
7 years ago
To phpkid:
This is a much simpler solution.
<?php
function longWordWrap($string) {
$string = str_replace("\n", "\n ", $string); // add a space after newline characters, so that 2 words only seperated by \n are not considered as 1 word
$words = explode(" ", $string); // now split by space
foreach ($words as $word) {
$outstring .= chunk_split($word, 12, " ") . " ";
}
return $outstring;
}
?>
zeusgerde at arcor dot de ¶
9 months ago
Three-liner for multibyte version of chunk_split()
<?php
function mb_chunk_split($body, $chunklen = 76, $end = "\r\n") {
return join($end, preg_split('/(.{'. $chunklen .'})/us', $body, 0, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE));
}
?>
preg_split() splits the string into $chunklen pieces
join() glues everything together to one string
PCRE_UTF8 makes it a multibyte version
PCRE_DOTALL makes sure that line breaks are also captured
PREG_SPLIT_NO_EMPTY removes the empty lines that were captured by the regular expression
PREG_SPLIT_DELIM_CAPTURE re-adds the non-empty lines that were captured by the regular expression (first sub-pattern)
Peter from dezzignz.com ¶
3 years ago
Oops. Here is a correction for the post below.
<?php
function mbStringToArray ($str) {
if (empty($str)) return false;
$len = mb_strlen($str);
$array = array();
for ($i = 0; $i < $len; $i++) {
$array[] = mb_substr($str, $i, 1);
}
return $array;
}
function mb_chunk_split($str, $len, $glue) {
if (empty($str)) return false;
$array = mbStringToArray ($str);
$n = -1;
$new = '';
foreach ($array as $char) {
$n++;
if ($n < $len) $new .= $char;
elseif ($n == $len) {
$new .= $glue . $char;
$n = 0;
}
}
return $new;
}
// DEMO:
$str = '一二一二一二一二一二';
echo mb_chunk_split($str, 2, '*<br />');
// produces this output:
一二*
一二*
一二*
一二*
一二
?>
Anonymous ¶
6 years ago
in response to "hansvane at yahoo dot com dot ar"
you can do that ALOT easier:
<?php
function split_hjms_chars($xstr, $xlenint, $xlaststr)
{
return substr($xstr,0,$xlenint).$xlaststr;
}
?>
xamine at gmail dot com ¶
6 years ago
In reply to "adrian at zhp dot inet dot pl" digit grouping function:
<?php
$number = strrev(chunk_split (strrev($number), 3,' '));
//If $number is '1234567', result is '1 234 567'.
?>
There is a much more simple way of doing this, by using the built-in number_format() function.
<?php
$number = number_format($number,2,"."," ");
//This will round $number to 2 decimals, use the dot (".")
//as decimal point, and the space (" ") as thousand sepparator.
?>
Chris ¶
7 years ago
@phpkid:
You can avoid such long complex code and just use some CSS stuff.
Just add style="table-layout:fixed" in your <td > tag and your problem will be solved.
ciao
sbarnum at pointsystems dot com ¶
12 years ago
[Editor's note: You can always use wordwrap('FF99FF', 2, ':', 2); to avoid this]
chunk_split will also add the break _after_ the last occurence. So, attempting to split a color into base components,
chunk_split('FF99FF', 2, ':');
will return FF:99:FF:
adrian at zhp dot inet dot pl ¶
7 years ago
If you need to output number formated with thousand's separator, just use it:
$number = strrev(chunk_split (strrev($number), 3,' '));
If $number is '1234567', result is '1 234 567'.