PHP Multiline Comments
In this page:
/*
multi-line comment
spanning several lines
*/
/**
* Documentation block above a function.
*/Basic Multiline Comment Syntax
एक multiline comment /* से शुरू होता है और अगले */ पर खत्म होता है, और उन दोनों markers के बीच की हर चीज़ -- चाहे कितनी भी lines में हो -- PHP interpreter द्वारा पूरी तरह ignore कर दी जाती है, बिल्कुल ऐसे जैसे यह कभी लिखी ही न गई हो।
उदाहरण: Basic Multiline Comment Syntax
<?php
/* This entire
multiline comment
is ignored by PHP */
echo "Only this line runs.";
?>Login to try C/C++/Java/PHP code in the editor
Debugging के लिए Code का Block Disable करना
/* */ का एक common practical इस्तेमाल है debugging के दौरान code के एक पूरे block को बिना delete किए temporarily disable करना -- जिस block को skip करना है उसे /* और */ में wrap करें, अपनी script चलाएँ, और testing खत्म होते ही markers को वापस हटा दें।
उदाहरण: Disabling a Block of Code for Debugging
<?php
echo "Before the disabled block\n";
/*
echo "This block is skipped";
echo "So is this line";
*/
echo "After the disabled block\n";
?>Login to try C/C++/Java/PHP code in the editor
Functions के ऊपर Documentation Blocks लिखना
Multiline comments किसी function के ठीक ऊपर एक छोटा documentation block लिखने का standard तरीका हैं, यह explain करते हुए कि यह क्या करता है, इसे कौन से parameters चाहिए, और यह क्या return करता है -- file खोलने वाला कोई भी व्यक्ति इसे एक नज़र में पढ़ सके, बिना किसी अलग documentation page की ज़रूरत के।
उदाहरण: Writing Documentation Blocks Above Functions
<?php
/*
* Adds two numbers together.
* Parameters: $a, $b - the numbers to add
* Returns: the sum
*/
function addNumbers($a, $b) {
return $a + $b;
}
echo addNumbers(2, 3);
?>Login to try C/C++/Java/PHP code in the editor
Comments Nest क्यों नहीं हो सकते
PHP एक opening /* के बाद बिल्कुल पहले */ के लिए scan करता है, और comment को वहीं बंद कर देता है -- यह nesting depth track नहीं करता।
इसका मतलब है कि /* outer /* inner */ still active code */ जैसा comment असल में "inner */" के बाद बंद हो जाता है, " still active code */" को real, uncommented PHP code के रूप में छोड़ते हुए, जो आमतौर पर एक syntax error का कारण बनता है।
उदाहरण: Why Comments Cannot Be Nested
<?php
/* outer /* inner */
still active code
?>Login to try C/C++/Java/PHP code in the editor
Multiline Comments बनाम Single-Line Comments
PHP कुल तीन comment styles support करता है: single-line comments के लिए // और #, और multiline वालों के लिए /* */।
तीनों functionally बराबर हैं कि वे interpreter से क्या छुपाते हैं -- इनके बीच choice पूरी तरह readability और आपको कितनी lines cover करनी हैं इस पर है।
उदाहरण: Multiline Comments vs Single-Line Comments
<?php
// Single-line style
# Also single-line style
/* Multiline
style */
echo "All three styles are functionally identical to PHP.";
?>Login to try C/C++/Java/PHP code in the editor
- एक /* */ comment को दूसरे के अंदर nest करना, जो PHP support नहीं करता -- पहला */ जो इसे मिलता है वह पूरे comment block को बंद कर देता है, बाकी हिस्से को silently un-comment करते हुए।
- closing */ पूरी तरह भूल जाना, जो उस point से file के अंत तक सब कुछ comment out कर देता है, उस code सहित जिसे आप active रखना चाहते थे।
- एक छोटे single-line note के लिए /* */ इस्तेमाल करना जब // ज़्यादा simple है और सही से खोलना-बंद करना कम error-prone है।
- /* */ किसी comment को कई lines में wrap करता है, // के उलट जो सिर्फ एक single line के बाकी हिस्से को comment out करता है।
- PHP multiline comments nested नहीं हो सकते -- पहला closing */ पूरे block को खत्म कर देता है।
- Multiline comments आमतौर पर debugging के दौरान code के किसी block को temporarily disable करने, या किसी function के ऊपर एक लंबी doc-style explanation लिखने के लिए इस्तेमाल होते हैं।
Chapter Quiz — Complete all 13 topics to unlock
0/13 topics done
Complete these topics first: