docs: backfill XML documentation across 756 files
v2-ci / build (push) Failing after 1m43s
v2-ci / unit-tests (tests/Core/ZB.MOM.WW.OtOpcUa.Cluster.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.ControlPlane.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Security.Tests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.Host.IntegrationTests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.IntegrationTests) (push) Has been skipped
v2-ci / build (push) Failing after 1m43s
v2-ci / unit-tests (tests/Core/ZB.MOM.WW.OtOpcUa.Cluster.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.ControlPlane.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Security.Tests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.Host.IntegrationTests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.IntegrationTests) (push) Has been skipped
Adds <summary>, <param>, <typeparam>, and <inheritdoc/> tags to public members surfaced by commentchecker — resolves 5,847 of 5,869 issues (99.6%) across three /fixdocs passes.
This commit is contained in:
@@ -42,9 +42,15 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.Modbus;
|
||||
public static class ModbusAddressParser
|
||||
{
|
||||
/// <summary>Parse an address string. Throws <see cref="FormatException"/> on invalid input.</summary>
|
||||
/// <param name="address">The address string to parse.</param>
|
||||
/// <returns>The parsed Modbus address.</returns>
|
||||
public static ParsedModbusAddress Parse(string address) => Parse(address, ModbusFamily.Generic, MelsecFamily.Q_L_iQR);
|
||||
|
||||
/// <summary>Parse with a family hint (#144 family-native branch).</summary>
|
||||
/// <param name="address">The address string to parse.</param>
|
||||
/// <param name="family">The Modbus family hint.</param>
|
||||
/// <param name="melsecSubFamily">The MELSEC subfamily hint.</param>
|
||||
/// <returns>The parsed Modbus address.</returns>
|
||||
public static ParsedModbusAddress Parse(string address, ModbusFamily family, MelsecFamily melsecSubFamily = MelsecFamily.Q_L_iQR)
|
||||
{
|
||||
if (TryParse(address, family, melsecSubFamily, out var parsed, out var error))
|
||||
@@ -52,6 +58,13 @@ public static class ModbusAddressParser
|
||||
throw new FormatException(error);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Attempts to parse an address string with default family hints.
|
||||
/// </summary>
|
||||
/// <param name="address">The address string to parse.</param>
|
||||
/// <param name="result">The parsed address, or null if parsing fails.</param>
|
||||
/// <param name="error">The error message if parsing fails, or null on success.</param>
|
||||
/// <returns>True if parsing succeeded; otherwise false.</returns>
|
||||
public static bool TryParse(string? address, out ParsedModbusAddress? result, out string? error)
|
||||
=> TryParse(address, ModbusFamily.Generic, MelsecFamily.Q_L_iQR, out result, out error);
|
||||
|
||||
@@ -61,6 +74,12 @@ public static class ModbusAddressParser
|
||||
/// and falls back to Modicon / mnemonic on miss. <paramref name="result"/> is null and
|
||||
/// <paramref name="error"/> non-null on failure.
|
||||
/// </summary>
|
||||
/// <param name="address">The address string to parse.</param>
|
||||
/// <param name="family">The Modbus family hint.</param>
|
||||
/// <param name="melsecSubFamily">The MELSEC subfamily hint.</param>
|
||||
/// <param name="result">The parsed address, or null if parsing fails.</param>
|
||||
/// <param name="error">The error message if parsing fails, or null on success.</param>
|
||||
/// <returns>True if parsing succeeded; otherwise false.</returns>
|
||||
public static bool TryParse(string? address, ModbusFamily family, MelsecFamily melsecSubFamily,
|
||||
out ParsedModbusAddress? result, out string? error)
|
||||
{
|
||||
|
||||
Reference in New Issue
Block a user