معرفی توابع

Cyletech

Cyletech

Member
سلام دوستان،

تصمیم دارم در این تاپیک بصورت حرفه ای تمامی توابع موجود در بخش توابع سایت PHP را به زبان فارسی روان ترجمه کنم. اما به دلیل گرفتاری ها توانایی ترجمه یک الی دو تابع را روزانه دارم.
از دوستان گرامی خواهشمندم که شرایطی که من در ذیل نوشته ام را رعایت کنند تا این تاپیک هم همانند سایر تاپیک ها بدرخشد.

شرایط استفاده از این تاپیک
- انتقادات به صورت پیام خصوصی ارسال شود
- هیچگونه پاسخی به مطالب داده نشود
- در صورت راضی بودن از ارسال مورد نظر از دکمه "تشکر" استفاده شود


به امید آینده ای پاک تر

​
حق تألیف و تصنیف تنها با گروه ایران PHP می باشد​
 
Cyletech

Cyletech

Member
str_replace

نسخه: PHP 4 و PHP 5
توضیح مختصر: جایگزین کردن تمام رخداد ها از رشته جستجو با رشته جایگزینی

توضیحات کامل:

PHP: 
mixed str_replace  ( mixed $search  , mixed $replace  , mixed $subject  [, int &$count  ] )

این تابع یک رشته یا یک آرایه را همراه تمام رخداد ها از search در subject جایگزین شده با مقدار replace بر می گرداند.
اگر شما نیازی به قوانین تجملی جایگزینی (اصطلاحات قانونی/regular expressions) می بایست همیشه از توابعی همچون ereg_replace() یا preg_replace() بجای این تابع استفاده کنید.

پارامتر ها

اگر search و replace آرایه هستند، آنگاه str_replace() یک مقدار از هر آرایه را می گیرد و از آنها در جستجو و جایگزین کردن در subject استفاده می کند. اگر replace مقدار کمتری نسبت به search داشته باشد، آنگاه یک رشته خالی برای سایر مقادیر جایگزینی استفاده شده است.
اگر search یا replace آرایه هستند، عناصرشان نخست به آخر پردازش شده است.
PHP: 
search
replace
subject
اگر subject آرایه باشد، آنگاه search و replace همراه هر ورودی از subject اجرا شده است، و برگشت مقدار یک آرایه به همان مقدار می باشد.

count

نکته: اگر تصویب شد، از مقدار در برابر تطبیق یافته و همچنین آزار جایگزین شده نگهداری خواهد کرد.

برگشت مقادیر

این تابع یک رشته یا یک آرایه را همراه مقادیر جایگزین شده بر میگرداند.

جدول تغییرات

نسخه - توضیح
5.0.0 - پارامتر count اضافه شده است
4.3.3 - پیشرفته شدن اشاره گر داخلی در آرایه replace
4.0.5 - بیشتر پارامتر ها توانایی آرایه بودن دارند

نمونه ها

نمونه 1
PHP: 
<?php
// Provides: <body text='black'>
$bodytag = str_replace("%body%", "black", "<body text='%body%'>");

// Provides: Hll Wrld f PHP
$vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U");
$onlyconsonants = str_replace($vowels, "", "Hello World of PHP");

// Provides: You should eat pizza, beer, and ice cream every day
$phrase  = "You should eat fruits, vegetables, and fiber every day.";
$healthy = array("fruits", "vegetables", "fiber");
$yummy   = array("pizza", "beer", "ice cream");

$newphrase = str_replace($healthy, $yummy, $phrase);

// Use of the count parameter is available as of PHP 5.0.0
$str = str_replace("ll", "", "good golly miss molly!", $count);
echo $count; // 2

// Order of replacement
$str     = "Line 1\nLine 2\rLine 3\r\nLine 4\n";
$order   = array("\r\n", "\n", "\r");
$replace = '<br />';
// Processes \r\n's first so they aren't converted twice.
$newstr = str_replace($order, $replace, $str);

// Outputs: apearpearle pear
$letters = array('a', 'p');
$fruit   = array('apple', 'pear');
$text    = 'a p';
$output  = str_replace($letters, $fruit, $text);
echo $output;
?>

نکات
- این تابع یک دودوئی امن (binary-safe) است.
- این تایع نسبت به بزرگ یا کوچک بودن حرف حساس است. از str_ireplace() برای جایگزین غیرحساس بودن نسبت به کوچک یا بزرگ بودن حرف استفاده کنید.

منبع: str_replace()
 
Cyletech

Cyletech

Member
addcslashes

نسخه: PHP 4 و PHP 5
توضیح مختصر: اعلام رشته همراه "/" ها در یک سبک C

توضیحات کامل:

PHP: 
string addcslashes  ( string $str  , string $charlist  )

بازگرداندن یک رشته همراه "/" ها قبل از کاراکتر هایی که در پارامتر charlist جا گرفته اند.

پارامتر ها

str

رشته ای که رهایی خواهد یافت

charlist

یک لیست از کاراکتر هایی که رهایی خواهند یافت. اگر charlist حاوی کاراکتر های \n، \r و ... باشد، تمام آنها به سبک C تبدیل خواهند شد، هنگامی که دیگر الفبای عددی همراه همراه کد های ASCII کمتر از 32 و بیشتر از 126 باشد تبدیل به نماینده هشت هشتی (octal) خواهند شد.

هنگامی که شما یک رشته از کاراکتر های موجود در استدلال charlist را معرفی می کنید مطمئن شوید که می دانید چه کاراکتر هایی بین کاراکتر هایی که شما به عنوان شروع و پایان دامنه آماده کرده اید می آید.
PHP: 
<?php
echo addcslashes('foo[ ]', 'A..z');
// output:  \f\o\o\[ \]
// All upper and lower-case letters will be escaped
// ... but so will the [\]^_`
?>
همچنین، اگر اولین کاراکتر در دامنه یک مقدار ASCII بیشتر از دومین کاراکتر در دامنه دارد، هیچ دامنه ای شکل نخواهد گرفت. تنها شروع، پایان و وسط کاراکتر ها رها خواهند شد. از تابع ord() برای پیدا کردن مقدار ASCII برای یک کاراکتر استفاده کنید.
PHP: 
<?php
echo addcslashes("zoo['.']", 'z..A');
// output:  \zoo['\.']
?>
مراقب باشید که اگر شما کاراکتر های 0، a، b، f، n، r، t و v را برای رهایی انتخاب کنید، آنها به /0، /a، /b، /f، /n، /r، /t و /v تبدیل خواهند شد. در این زبان /0 تهی، /r بازگشت نورد، /n خط جدید، /f شکل دادن به تغذیه، /v کلید کنترل قائم و /t کلید کنترل رشته رهایی از پیش تعریف شده هستند.

مقادیر بازگشت

بازگشت آن رشته رها شده.

جدول تغییرات

نسخه - توضیح
5.2.5 - رشته های رهایی /v و /f اضافه شدند.

نمونه ها

نمونه 1
PHP: 
<?php
$escaped = addcslashes($not_escaped, "\0..\37!@\177..\377");
?>

منبع: addcslashes
 
Cyletech

Cyletech

Member
addslashes

نسخه: PHP 4 و PHP 5
توضیح مختصر: اعلام کردن رشته همراه "/" ها

توضیحات کامل:

PHP: 
string addslashes  ( string $str  )

بازگرداندن یک رشته همراه "\" قبل کاراکتر هایی که نیاز به اعلام شدن در پرس و جو های پایگاه داده دارند یا ... . این کاراکتر ها نقل قول تنها (')، نقل قول مضاعف (")، (\) و تهی.

یک نمونه برای استفاده از addslashes() وجود دارد هنگامی که شما درحال وارد کردن عناصر داده ها به یک پایگاه داده هستید. برای مثال، وارد کردن همان نام O'reilly به یک پایگاه داده، شما به رها کردن آن نیاز خواهید داشت. استفاده از تابع ویژه رهایی DBMS (برای مثال. mysqli_real_escape_string() برای MySQL یا pg_escape_string() برای PostgreSQL) شدیدا پیشنهاد شده است، اما اگر DBMS یی که شما درحال استفاده از آن هستید یک تابع رهایی و DBMS از "\" برای رهایی از کاراکتر ها استفاده کند، آن موقع شما می توانید از این تابع استفاده کنید. این عناصر داده ها را به پایگاه داده حاصل خواهد کرد، بعلاوه آن "\" قرار داده نخواهد شد.

magic_quotes_gpc بطور پیش فرض است، و ذاتا در addslashes() بر همه GET، POST و عناصر داده های COOKIE. از تابع addslashes() بر رشته هایی که پیش از این توسط magic_quotes_gpc رها شدند استفاده نکنید. تابع get_magic_quotes_gpc() امکان دارد برای سهولت در بررسی این بیاید.

پارامتر ها

str

رشته ای که رها خواهد شد.

مقادیر بازگشت

رشته رها شده را باز می گرداند.

نمونه ها

نمونه 1
PHP: 
<?php
$str = "Is your name O'reilly?";

// Outputs: Is your name O\'reilly?
echo addslashes($str);
?>

منبع: addslashes
 
Cyletech

Cyletech

Member
bin2hex

نسخه: PHP 4 و PHP 5
توضیح مختصر: تبدیل عناصر داده های دودوئی (binary) به نمایش شانزده شانزدهى (hexadecimal)

توضیحات کامل:

PHP: 
string bin2hex  ( string $str  )

بازگرداندن یک رشته ASCII که شامل نمایش شانزده شانزدهى از str می باشد.

پارامتر ها

str

یک کاراکتر.

مقادیر بازگشت

بازگرداندن نمایش شانزده شانزدهی از رشته داده شده.

منبع: bin2hex
 
Cyletech

Cyletech

Member
chop

نسخه: PHP4 و PHP 5
توضیح مختصر: نام مستعاری از rtrim()

توضیحات کامل:

این تابع یک نام مستعار از rtrim() می باشد.

نکات:

- تابع chop() متفاوت از تابع chop() زبان برنامه نویسی perl می باشد، که این تابع آخرین کاراکتر در آن رشته را حذف می کند.

منبع: chop
 
Cyletech

Cyletech

Member
chr

نسخه: PHP 4 و PHP 5
توضیح مختصر: بازگشت یک کاراکتر ثابت

توضیحات کامل:

PHP: 
string chr  ( int $ascii  )

بازگشت یک رشته یک کاراکتری که حاوی آن کاراکتری که توسط ascii تعیین شده می باشد.
این تابع مکمل ord() می باشد.

پارامتر ها

ascii

کد ASCII

مقادیر بازگشت

بازگرداندن کاراکتر تعیین شده.

نمونه ها

نمونه 1
PHP: 
<?php
$str = "The string ends in escape: ";
$str .= chr(27); /* add an escape character at the end of $str */

/* Often this is more useful */

$str = sprintf("The string ends in escape: %c", 27);
?>

منبع: chr
 
Cyletech

Cyletech

Member
chunk_split

نسخه: PHP 4 و PHP 5
توضیح مختصر: دونیم کردن یک رشته به قطعات کوچکتر

توضیحات کامل:

PHP: 
string chunk_split  ( string $body  [, int $chunklen  [, string $end  ]] )

دونیم کردن یک رشته به قطعات کوچکتر.

پارامتر ها

body

رشته ای که قطعه خواهد شد.

chunklen

طول آن قطعه. بعنوان پیشفرض 76.

end

آن پایان رشته خط. بعنوان پیشفرض "\r\n".

مقادیر بازگشت

بازگرداندن آن رشته قطعه شده.

نمونه ها

نمونه 1
PHP: 
<?php
// format $data using RFC 2045 semantics
$new_string = chunk_split(base64_encode($data));
?>

منبع: chunk_split
 
Cyletech

Cyletech

Member
convert_cyr_string

نسخه: PHP 4 و PHP 5
توضیح مختصر: تبدیل یک کاراکتر روسی (Cyrillic) به دیگری

توضیح کامل:
PHP: 
string convert_cyr_string     ( string $str    , string $from    , string $to    )
تبدیل یک کاراکتر روسی (Cyrillic) به دیگری.

پارامتر ها

str

رشته ای که تبدیل خواهد شد.

from

کاراکتر روسی که می بایست تبدیل شود.

to

نوعی که می خواهید تبدیل شود.

کاراکتر هایی که پشتیبانی می شود:


PHP: 
k - koi8-r
w - windows-1251      
i - iso8859-5      
a - x-cp866      
d - x-cp866      
m - x-mac-cyrillic
مقادیر بازگشت

بازگشت آن رشته تبدیل شده.

نکات

- این تابع امن-دودوئی (binary-safe) است.

منبع: convert_cry_string
 
آخرین ویرایش:
Cyletech

Cyletech

Member
convert_uudecode

نسخه: PHP 5
توضیح مختصر: کدبرداری یک رشته uuencoded

توضیحات کامل:

PHP: 
string convert_uudecode  ( string $data  )

کدبرداری یک رشته uuencoded.

پارامتر ها

data

آن عناصر داده های uuencoded.

مقادیر بازگشت

بازگشت آن عناصر داده های کدبرداری شده بعنوان یک رشته.

نمونه ها

نمونه 1
PHP: 
<?php
/* Can you imagine what this will print? :) */
echo convert_uudecode("+22!L;W9E(%!(4\"$`\n`");
?>

منبع: convert_uudecode
 
Cyletech

Cyletech

Member
convert_uuencode

نسخه: PHP 5
توضیح مختصر: Uuencode کردن یک رشته

توضیحات کامل:

PHP: 
string convert_uuencode  ( string $data  )

این تابع یک رشته را با استفاده از راه و روش uuencode کردن کدگذاری می کند.

Uuencode تمام رشته ها (حاوی دودوئی تک) باشد را به کاراکتر های قابل چاپ بر می گرداند.

پارامتر ها

data

عناصر داده هایی که کدگذاری خواهد شد.

مقادیر بازگشت

بازگشت آن عناصر داده های uuencoded.

نمونه ها

نمونه 1
PHP: 
<?php
$some_string = "test\ntext text\r\n";

echo convert_uuencode($some_string);
?>

منبع: convert_uuencode
 
برای ارسال پاسخ شما باید وارد سیستم شوید.

آخرین مطالب مجیدآنلاین

جدیدترین ارسال ها

بالا