-
註釋
（編程語言）
鎖定
註釋只是為了提高可讀性，不會被計算機編譯。
- 中文名
- 註釋
- 外文名
- annotation
- 類 型
- 編程語言
註釋註釋定義
註釋就是對代碼的解釋和説明。目的是為了讓別人和自己很容易看懂，一看就知道這段代碼是做什麼用的。正確的程序註釋一般包括序言性註釋和功能性註釋。序言性註釋的主要內容包括模塊的接口、數據的描述和模塊的功能。模塊的功能性註釋的主要內容包括程序段的功能、語句的功能和數據的狀態。
註釋註釋分類
註釋通常會分為行註釋和塊註釋。
註釋行註釋
在符號後那一行不會被編譯（顯示）
註釋塊註釋
被塊註釋符號中間的部分不會被編譯
註釋註釋格式
指令語言的註釋格式
jsp 註釋
塊註釋
HTML註釋
塊註釋
<!-- -->
asp 註釋
' 行註釋
css 註釋
塊註釋
/* */ 塊註釋
java 註釋
// 行註釋
/* */ 塊註釋
/** */ 塊註釋，中間通常代碼信息、比如作者姓名等
c++ 註釋
// 行註釋
/* */ 塊註釋
批處理腳本註釋 REM（不區分大小寫） 行註釋
例如下面是C++的註釋簡單例子
/*
代碼作用
在屏幕上輸出百度百科
*/
#include<iostream> /* #包含<iostream>頭文件 */
using namespace std;/* 使用命名空間 標準庫 */
int main() /* 整數類型的主函數 */
{
cout << "百度百科"; /*c輸出<< "百度百科!";*/
}
C++中，//和/**/都能表示註釋，但//只能單行。
php註釋
<html> <body> <?php //This is a comment /*This isa commentblock*/ ?> </body> </html>
<?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>
- 參考資料
-
- 1. PHP 語法 ．w3school[引用日期2012-12-29]
