注釋(程式語言)

注釋(程式語言)

本詞條是多義詞,共2個義項
更多義項 ▼ 收起列表 ▲

注釋就是對代碼的解釋和說明,其目的是讓人們能夠更加輕鬆地了解代碼。注釋是編寫程式時,寫程式的人給一個語句、程式段、函式等的解釋或提示,能提高程式代碼的可讀性。

基本介紹

注釋就是對代碼的解釋和說明。目的是為了讓別人和自己很容易看懂。為了讓別人一看就知道這段代碼是做什麼用的。正確的程式注釋一般包括序言性注釋和功能性注釋。序言性注釋的主要內容包括模組的接口、數據的描述和模組的功能。模組的功能性注釋的主要內容包括程式段的功能、語句的功能和數據的狀態。
行注釋
在符號後那一行不會被編譯(顯示)
塊注釋
被塊注釋符號中間的部分不會被編譯
jsp 注釋 塊注釋
HTML 注釋 塊注釋
<!-- -->
asp 注釋 ' 行注釋
css 注釋 塊注釋
/* */ 塊注釋
java 注釋 // 行注釋
/* */ 塊注釋
/** */ 塊注釋,中間通常代碼信息、比如作者姓名等
c++ 注釋 // 行注釋
/* */ 塊注釋
批處理腳本注釋 REM(不區分大小寫) 行注釋
例如下面是C++的注釋簡單例子
/*
代碼作用
在螢幕上輸出中文百科!
*/
#include<iostream> /*#包含<iostream>頭檔案*/using namespace std;/*使用命名空間 標準庫*/int main() /*整數類型 “主” (函式)*/{       cout << "中文百科!";  /*c輸出<< "中文百科!";*/}
php注釋
在 PHP 中,我們使用 // 來編寫單行注釋,或者使用 /* 和 */ 來編寫大的注釋塊。
<html>
<body>
<?php
//This is a comment
/*This isa commentblock*/
?>
</body>
</html>
php 支持 C,C++ 和 Unix Shell 風格(Perl 風格)的注釋。例如:
<?php echo "This is a test"; // This is a one-line c++ style comment /* This is a multi line comment yet another line of comment */ echo "This is yet another test"; echo "One Final Test"; # This is shell-style style comment ?>
單行注釋僅僅注釋到行末或者當前的 php 代碼塊,視乎哪個首先出現。這意味著在 // ?> 之後的 HTML 代碼將被顯示出來:?> 跳出了 php 模式並返回了 HTML 模式,// 並不能影響到這一點。如果啟用了 asp_tags 配置選項,其行為和 // %> 相同。不過,</script> 標記在單行注釋中不會跳出 php 模式。
<h1>This is an <?php # echo "simple";?> example.</h1> <p>The header above will say 'This is an example'.
cad中的注釋概述
注釋是說明或其他類型的說明性符號或對象,通常用於向圖形中添加信息。
注釋樣例包括
說明和標籤
、表格 、標註和公差 、圖案填充 、標註 、塊 用於創建注釋的對象類型包括
圖案填充 、文字(單行和多行) 、表格 、標註 、公差 、引線和多重引線 、塊 、屬性等,
用戶可以在不同的布局視口和模型空間中自動完成縮放注釋的過程。
1.縮放注釋
通常用於注釋圖形的對象有一個特性稱為注釋性。使用此特性,用戶可以自動完成縮放注釋的過程,從而使注釋能夠以正確的大小在圖紙上列印或顯示。
2.設定注釋比例
注釋比例是與模型空間、布局視口和模型視圖一起保存的設定。將注釋性對象添加到圖形中時,它們將支持當前的注釋比例,根據該比例設定進行縮放,並自動以正確的大小顯示在模型空間中。
3.創建注釋性對象
通常用於注釋圖形的對象有一個特性稱為注釋性。如果這些對象的注釋性特性處於啟用狀態(設定為“是”),則其稱為注釋性對象
4.顯示注釋性對象
對於模型空間或布局視口,用戶可以顯示所有的注釋性對象,或僅顯示那些支持當前注釋比例的對象。
5.添加和修改比例圖示
在圖形中創建 注釋性 對象後,它支持一個 注釋比例,即創建該對象時的當前注釋比例。用戶可以更新注釋性對象,以支持其他注釋比例。
注釋和標籤概述
可以使用多種方法創建文字。對簡短的輸入項使用單行文字。對帶有內部格式的較長的輸入項使用多行文字(也稱為多行文字)。也可創建帶有引線的多行文字。
雖然所有輸入的文字都使用建立了默認字型和格式設定的當前文字樣式,但也可以使用其他的方法自定義文字外觀。有一些工具可以方便用戶修改文字比例和對正、查找和替換文字以及檢查拼寫錯誤。
包含在標註或公差中的文字是使用標註命令創建的。
腳本語言的注釋格式
JavaScript 單行注釋
可以添加注釋來對 JavaScript 進行解釋,或者提高其可讀性。
單行的注釋以
// 開始。
本例用單行注釋來解釋代碼:
<script type="text/javascript">
// 這行代碼輸出標題:document.write("<h1>This is a header</h1>");// 這行代碼輸出段落:document.write("<p>This is a paragraph</p>");
document.write("<p>This is another paragraph</p>");
</script>
JavaScript 多行注釋
多行注釋以 /* 開頭,以 */ 結尾。
本例使用多行注釋來解釋代碼:
<script type="text/javascript"> /*下面的代碼將輸出一個標題和兩個段落*/ document.write("<h1>This is a header</h1>"); document.write("<p>This is a paragraph</p>"); document.write("<p>This is another paragraph</p>"); </script>
使用注釋來防止執行
在本例中,我們用注釋來阻止一行代碼的執行:
<script type="text/javascript">
document.write("<h1>This is a header</h1>");
document.write("<p>This is a paragraph</p>");
document.write("<p>This is another paragraph</p>");
</script>
在本例中,我們用注釋來阻止若干行代碼的執行:
<script type="text/javascript">
/*document.write("<h1>This is a header</h1>");document.write("<p>This is a paragraph</p>");document.write("<p>This is another paragraph</p>");*/
</script>
在行末使用注釋
在本例中,注釋放置在語句的行末:
<script type="text/javascript">
document.write("Hello"); // 輸出 "Hello" document.write("World"); // 輸出 "World"
</script>

相關詞條

熱門詞條

聯絡我們