<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >array_splice</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="PHP 手册" HREF="index.html"><LINK REL="UP" TITLE="Array 数组函数" HREF="ref.array.html"><LINK REL="PREVIOUS" TITLE="array_slice" HREF="function.array-slice.html"><LINK REL="NEXT" TITLE="array_sum" HREF="function.array-sum.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP 手册</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.array-slice.html" ACCESSKEY="P" >上一页</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.array-sum.html" ACCESSKEY="N" >下一页</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.array-splice" ></A >array_splice</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN11991" ></A ><P > (PHP 4, PHP 5)</P >array_splice -- 把数组中的一部分去掉并用其它值取代 </DIV ><DIV CLASS="refsect1" ><A NAME="AEN11994" ></A ><H2 >说明</H2 >array <B CLASS="methodname" >array_splice</B > ( array &input, int offset [, int length [, array replacement]] )<BR ></BR ><P > <B CLASS="function" >array_splice()</B > 把 <CODE CLASS="parameter" >input</CODE > 数组中由 <CODE CLASS="parameter" >offset</CODE > 和 <CODE CLASS="parameter" >length</CODE > 指定的单元去掉,如果提供了 <CODE CLASS="parameter" >replacement</CODE > 参数,则用 <CODE CLASS="parameter" >replacement</CODE > 数组中的单元取代。返回一个包含有被移除单元的数组。注意 <CODE CLASS="parameter" >input</CODE > 中的数字键名不被保留。 </P ><P > 如果 <CODE CLASS="parameter" >offset</CODE > 为正,则从 <CODE CLASS="parameter" >input</CODE > 数组中该值指定的偏移量开始移除。如果 <CODE CLASS="parameter" >offset</CODE > 为负,则从 <CODE CLASS="parameter" >input</CODE > 末尾倒数该值指定的偏移量开始移除。 </P ><P > 如果省略 <CODE CLASS="parameter" >length</CODE >,则移除数组中从 <CODE CLASS="parameter" >offset</CODE > 到结尾的所有部分。如果指定了 <CODE CLASS="parameter" >length</CODE > 并且为正值,则移除这么多单元。如果指定了 <CODE CLASS="parameter" >length</CODE > 并且为负值,则移除从 <CODE CLASS="parameter" >offset</CODE > 到数组末尾倒数 <CODE CLASS="parameter" >length</CODE > 为止中间所有的单元。小窍门:当给出了 <CODE CLASS="parameter" >replacement</CODE > 时要移除从 <CODE CLASS="parameter" >offset</CODE > 到数组末尾所有单元时,用 <TT CLASS="literal" >count($input)</TT > 作为 <CODE CLASS="parameter" >length</CODE >。 </P ><P > 如果给出了 <CODE CLASS="parameter" >replacement</CODE > 数组,则被移除的单元被此数组中的单元替代。如果 <CODE CLASS="parameter" >offset</CODE > 和 <CODE CLASS="parameter" >length</CODE > 的组合结果是不会移除任何值,则 <CODE CLASS="parameter" >replacement</CODE > 数组中的单元将被插入到 <CODE CLASS="parameter" >offset</CODE > 指定的位置。注意替换数组中的键名不保留。如果用来替换的值只是一个单元,那么不需要给它加上 <TT CLASS="literal" >array()</TT >,除非该单元本身就是一个数组。 </P ><P > 以下表达式以同样方式修改了 <CODE CLASS="varname" >$input</CODE >: <DIV CLASS="table" ><A NAME="AEN12044" ></A ><P ><B >表 1. <B CLASS="function" >array_splice()</B > 等价表达式</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><TBODY ><TR ><TD > array_push($input, $x, $y) </TD ><TD > array_splice($input, count($input), 0, array($x, $y)) </TD ></TR ><TR ><TD > array_pop($input) </TD ><TD > array_splice($input, -1) </TD ></TR ><TR ><TD > array_shift($input) </TD ><TD > array_splice($input, 0, 1) </TD ></TR ><TR ><TD > array_unshift($input, $x, $y) </TD ><TD > array_splice($input, 0, 0, array($x, $y)) </TD ></TR ><TR ><TD > $input[$x] = $y // 对于键名和偏移量等值的数组 </TD ><TD > array_splice($input, $x, 1, $y) </TD ></TR ></TBODY ></TABLE ></DIV > </P ><P > 返回一个包含被移除单元的数组。 </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN12066" ></A ><P ><B >例 1. <B CLASS="function" >array_splice()</B > 例子</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br />$input </font><font color="#007700">= array(</font><font color="#DD0000">"red"</font><font color="#007700">, </font><font color="#DD0000">"green"</font><font color="#007700">, </font><font color="#DD0000">"blue"</font><font color="#007700">, </font><font color="#DD0000">"yellow"</font><font color="#007700">);<br /></font><font color="#0000BB">array_splice</font><font color="#007700">(</font><font color="#0000BB">$input</font><font color="#007700">, </font><font color="#0000BB">2</font><font color="#007700">);<br /></font><font color="#FF8000">// $input is now array("red", "green")<br /><br /></font><font color="#0000BB">$input </font><font color="#007700">= array(</font><font color="#DD0000">"red"</font><font color="#007700">, </font><font color="#DD0000">"green"</font><font color="#007700">, </font><font color="#DD0000">"blue"</font><font color="#007700">, </font><font color="#DD0000">"yellow"</font><font color="#007700">);<br /></font><font color="#0000BB">array_splice</font><font color="#007700">(</font><font color="#0000BB">$input</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, -</font><font color="#0000BB">1</font><font color="#007700">);<br /></font><font color="#FF8000">// $input is now array("red", "yellow")<br /><br /></font><font color="#0000BB">$input </font><font color="#007700">= array(</font><font color="#DD0000">"red"</font><font color="#007700">, </font><font color="#DD0000">"green"</font><font color="#007700">, </font><font color="#DD0000">"blue"</font><font color="#007700">, </font><font color="#DD0000">"yellow"</font><font color="#007700">);<br /></font><font color="#0000BB">array_splice</font><font color="#007700">(</font><font color="#0000BB">$input</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">count</font><font color="#007700">(</font><font color="#0000BB">$input</font><font color="#007700">), </font><font color="#DD0000">"orange"</font><font color="#007700">);<br /></font><font color="#FF8000">// $input is now array("red", "orange")<br /><br /></font><font color="#0000BB">$input </font><font color="#007700">= array(</font><font color="#DD0000">"red"</font><font color="#007700">, </font><font color="#DD0000">"green"</font><font color="#007700">, </font><font color="#DD0000">"blue"</font><font color="#007700">, </font><font color="#DD0000">"yellow"</font><font color="#007700">);<br /></font><font color="#0000BB">array_splice</font><font color="#007700">(</font><font color="#0000BB">$input</font><font color="#007700">, -</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, array(</font><font color="#DD0000">"black"</font><font color="#007700">, </font><font color="#DD0000">"maroon"</font><font color="#007700">));<br /></font><font color="#FF8000">// $input is now array("red", "green",<br />// "blue", "black", "maroon")<br /><br /></font><font color="#0000BB">$input </font><font color="#007700">= array(</font><font color="#DD0000">"red"</font><font color="#007700">, </font><font color="#DD0000">"green"</font><font color="#007700">, </font><font color="#DD0000">"blue"</font><font color="#007700">, </font><font color="#DD0000">"yellow"</font><font color="#007700">);<br /></font><font color="#0000BB">array_splice</font><font color="#007700">(</font><font color="#0000BB">$input</font><font color="#007700">, </font><font color="#0000BB">3</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#DD0000">"purple"</font><font color="#007700">);<br /></font><font color="#FF8000">// $input is now array("red", "green",<br />// "blue", "purple", "yellow");<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > 参见 <A HREF="function.array-slice.html" ><B CLASS="function" >array_slice()</B ></A >,<A HREF="function.unset.html" ><B CLASS="function" >unset()</B ></A > 和 <A HREF="function.array-merge.html" ><B CLASS="function" >array_merge()</B ></A >。 </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.array-slice.html" ACCESSKEY="P" >上一页</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >起始页</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.array-sum.html" ACCESSKEY="N" >下一页</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >array_slice</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.array.html" ACCESSKEY="U" >上一级</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >array_sum</TD ></TR ></TABLE ></DIV ></BODY ></HTML >