* samp 要素型 (HTML, XHTML 1)

[1] [DFN[[CODE(HTMLe)[samp]] [[要素型]]]]は、[[プログラム]]や[[スクリプト]]などの出力例を示します。

仕様書:
- [[HTML 4]]: <IW:HTML4:"struct/text.html#edef-SAMP">

[2]
: [[開始タグ]]: 必須
: [[終了タグ]]: 必須
: [[内容模型]]: [CODE(SGML)[(%[[inline]];)*]]
: [[属性]] :
,名前,値の型,既定値,意味,出典
,[CODE(HTMLa)[[[class]]]]   ,,,[[級]]       ,[HTML4] %[[coreattr]]
,[CODE(HTMLa)[[[dir]]]]     ,,,[[書字方向]] ,[HTML4] %[[i18n]]
,[CODE(HTMLa)[[[id]]]]      ,,,一意識別子   ,[HTML4] %coreattr
,[CODE(HTMLa)[[[lang]]]]    ,,,[[自然言語]] ,[HTML4] %i18n
,[CODE(HTMLa)[[[xml]]:lang]],,,自然言語     ,[XHTML1]
,[CODE(HTMLa)[[[onclick]]]] ,,,             ,[HTML4] %[[events]]
,[CODE(HTMLa)[[[ondblclick]]]],,,           ,[HTML4] %events
,[CODE(HTMLa)[[[onkeydown]]]],,,            ,[HTML4] %events
,[CODE(HTMLa)[[[onkeypress]]]],,,           ,[HTML4] %events
,[CODE(HTMLa)[[[onkeyup]]]] ,,,             ,[HTML4] %events
,[CODE(HTMLa)[[[onmousedown]]]],,,          ,[HTML4] %events
,[CODE(HTMLa)[[[onmousemove]]]],,,          ,[HTML4] %events
,[CODE(HTMLa)[[[onmouseout]]]],,,           ,[HTML4] %events
,[CODE(HTMLa)[[[onmouseover]]]],,,          ,[HTML4] %events
,[CODE(HTMLa)[[[onmouseup]]]],,,            ,[HTML4] %events
,[CODE(HTMLa)[[[style]]]]   ,,,スタイル情報 ,[HTML4] %coreattr
,[CODE(HTMLa)[[[title]]]]   ,,,注釈的題     ,[HTML4] %coreattr

[[#comment]]

** 応用

[3] HTML 4 仕様書は特に典型的[[レンダリング]]例を挙げていません。

[[#comment]]

** 歴史

[7] [CODE(HTMLe)[samp]] 要素型は GNU texinfo の
[CODE[@samp]] 命令に由来しています。

詳しくは [CODE(HTMLe)[[[code]]]] の歴史の章を参照。

[[#comment]]

** 例

[8] [[HTML]] 仕様書における、[[HTML]] の[[要素型名]]の[[マーク]]の例
[PRE(HTML example)[
The <[CODE(HTMLe)[a]] [CODE(HTMLa)[href]]="[CODE(URI)[objects.html#edef-IMG]]" [CODE(HTMLa)[class]]="noxref"><[CODE(HTMLe)[samp]] [CODE(HTMLa)[class]]="einst">
IMG</[CODE(HTMLe)[samp]]></[CODE(HTMLe)[a]]> element embeds an image in the current document at the location
of the element's definition.
]PRE]

出典: HTML 4.01 勧告 
[CITE[Objects, Images, and Applets in HTML documents]] 
<http://www.w3.org/TR/html4/struct/objects.html#h-13.2>

[[#comment]]

** メモ

[[#comment]]

* @samp 命令 (GNU Texinfo)

[4] GNU Texinfo では、 [CODE[@samp{[VAR[text]]}]]
は、生の例やファイル・文字列・パターン内の文字列の「例」
を示すために使用します。
<http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#samp>

例:
-[SAMP[To match @samp{foo} at the end of the line, use the regexp @samp{foo$}.]]

[5] 引数の内容は、印刷版マニュアルや Info
の出力では単引用符で括って、固定長フォントで出力されます。

[6] [CODE[@[[code]]]], [CODE[@[[key]]]],
[CODE[@[[kbd]]]] ではカバーされないものは
[CODE[@samp]] にしておけばいい感じだとマニュアルには書いてあります。

具体例としては、 [[C]] の[[文]]全体とか、[[シェル]]の[[命令]]とかです。

[[#comment]]

* メモ