rspec/rules/S988/cfamily/rule.adoc

== Why is this an issue?

This includes file and I/O functions ``++fgetpos++``, ``++fopen++``, ``++ftell++``, ``++gets++``, ``++perror++``, ``++remove++``, ``++rename++`` and ``++ungetc++``.


Streams and file I/O have a large number of unspecified, undefined and implementation-defined behaviors associated with them. It is assumed within MISRA C that they will not normally be needed in production code in embedded systems.


If any of the features of ``++stdio.h++`` need to be used in production code, then the issues associated with the features need to be understood.


=== Noncompliant code example

[source,cpp]
----
#include <stdio.h> /* Noncompliant */
----


== Resources

* MISRA C:2004, 20.9 - The input/output library <stdio.h> shall not be used in production code.
* MISRA {cpp}:2008, 27-0-1 - The stream input/output library <cstdio> shall not be used.
* MISRA C:2012, 21.6 - The Standard Library input/output functions shall not be used


ifdef::env-github,rspecator-view[]
'''
== Comments And Links
(visible only on this page)

=== is related to: S1055

=== on 31 Mar 2015, 19:02:58 Evgeny Mandrikov wrote:
\[~ann.campbell.2] implementation seems more complete (SQALE, description) than this spec.

=== on 13 Apr 2015, 19:47:20 Evgeny Mandrikov wrote:
\[~ann.campbell.2] I'm wondering why blocker, but not active by default? Note that in implementation currently major and not active.

endif::env-github,rspecator-view[]
migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`== Why is this an issue?`

Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00			This includes file and I/O functions ``++fgetpos++``, ``++fopen++``, ``++ftell++``, ``++gets++``, ``++perror++``, ``++remove++``, ``++rename++`` and ``++ungetc++``.


			`Streams and file I/O have a large number of unspecified, undefined and implementation-defined behaviors associated with them. It is assumed within MISRA C that they will not normally be needed in production code in embedded systems.`


			If any of the features of ``++stdio.h++`` need to be used in production code, then the issues associated with the features need to be understood.


migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`=== Noncompliant code example`
Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00
RULEAPI-661: Add syntax coloring 2022-02-04 17:28:24 +01:00			`[source,cpp]`
Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00			`----`
			`#include <stdio.h> /* Noncompliant */`
			`----`


migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`== Resources`
Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00
			`* MISRA C:2004, 20.9 - The input/output library <stdio.h> shall not be used in production code.`
			`* MISRA {cpp}:2008, 27-0-1 - The stream input/output library <cstdio> shall not be used.`
			`* MISRA C:2012, 21.6 - The Standard Library input/output functions shall not be used`

Export comments and rspec-to-rspec links from jira 2021-06-02 20:44:38 +02:00
Fix the comment display: rule-id, timestamp, GH visibility, link direction 2021-06-03 09:05:38 +02:00			`ifdef::env-github,rspecator-view[]`
RULEAPI-576: add a horizontal rule between rule description and comments 2021-06-08 15:52:13 +02:00			`'''`
Export comments and rspec-to-rspec links from jira 2021-06-02 20:44:38 +02:00			`== Comments And Links`
			`(visible only on this page)`

Inline adoc when include has no additional value (#1940) Inline adoc files when they are included exactly once. Also fix language tags because this inlining gives us better information on what language the code is written in. 2023-05-25 14:18:12 +02:00			`=== is related to: S1055`

			`=== on 31 Mar 2015, 19:02:58 Evgeny Mandrikov wrote:`
			`\[~ann.campbell.2] implementation seems more complete (SQALE, description) than this spec.`

			`=== on 13 Apr 2015, 19:47:20 Evgeny Mandrikov wrote:`
			`\[~ann.campbell.2] I'm wondering why blocker, but not active by default? Note that in implementation currently major and not active.`

Fix the comment display: rule-id, timestamp, GH visibility, link direction 2021-06-03 09:05:38 +02:00			`endif::env-github,rspecator-view[]`